Introduction


Parallels Automation (PA) 5.4 is a powerful and nimble service provisioning platform for providing cloud service to business customers. It is used primarily by Internet Service Providers and Telecommunications companies to dynamically setup services for end customers.

The Bulletin Parallels Automation package is a Gold Certified APS 1.2 package providing Parallels Automation customers with a simple and rapidly deployable text messaging service for their customers.






Compatible Platforms


The APS package is v1.2 and has been tested against Parallels Automation 5.4 with the Management Node running on both Redhat Linux 5.x and CentOS 5.x Integration has been tested against Parallels Business Automation (PBA) 5.4





Features


The Messenger platform provides numerous features outlined on our website and user guide

When the Parallels Package is installed and a Company (customer) is added we:
  • Automatically provision an administrator account against that company

When you add a user to the Company we:
  • Send them a welcome email if you defined this to occur during package install
  • Automatically white-list their email address for email2sms
  • Permit the user to login to the web interface. Also permit seamless one-click login from their Parallels Panel

If you install the package with resource reporting then users below a company will not see their usage. Instead the Company administrator will have the usage for all their users displayed inside Parallels Panel

Multiple subscriptions per customer are not supported





Install Pre-Requisite Packages

We have tested against Redhat 5.8 and 5.9 and CentOS 5.8 and 5.9 as per PA Linux Compatibility.

These libraries must be installed on the Management Node prior to the installation of the Bulletin APS package.
  • php53-cli
  • php53-common
  • php53-xml

These PHP modules are used by the APS package to communicate with the Bulletin Messenger service. If you are using a different version of PHP your mileage may vary.




Organise a License or Free Trial

A license is required in order for us to be able to setup a billing relationship with you, the customer. The license key is used to verify you have the authority to make changes on behalf of your customers on the Bulletin platform.

Please contact our sales team to organise a license and establish a billing relationship prior to configuring the package. Free Trials are available also and follow a similar process.






Install the APS Package


Browse the APS store within PA by searching for “Bulletin*” (please make sure you include the asterisk) without the quotes as shown below, and select the package to import directly from the store.

Alternatively, download the Bulletin Mobile Messaging APS Package from the APS Catalogue and import the package into Parallels Automation.



Import the package (if manually downloaded and not installed from the catalog)

Navigate to Service Director -> Application Manager -> Applications and click import package 



 On the next page select the aps .zip file downloaded earlier and submit.

 

Once imported you should see a screen similar to below



Define Resource Type 'Application'

Click on the package name shown above. You will now be able to set various configuration values against the package.

Click on 'Resource Types' and then 'Create' as shown in the screenshot below.



On the subsequent screen, select 'Application'. Call the application whatever you wish, we recommend Bulletin SMS Texting Service. Click Next

There are a number of configuration values now visible on the screen as shown below. The values highlighted in red must be completed as per the instructions below. You can leave the rest of the values blank.







A Bit About Welcome Emails


Welcome emails are sent from the POA local mail server If that is not configured correctly or missing these emails will not be sent


The Bulletin Text Messaging APS package can generate welcome emails when a service user (new or existing) is subscribed to the service This email contains your logo (if defined) and brief Outlook 2010/2007 activation instructions with a link that automatically sets up Outlook You don't need to worry about this if your customers are only using the Web interface


If you do not wish a welcome email for the Outlook Service to be sent as you add a new service user, then simply set the Welcome Email Address to be a blank value. This will disable the welcome email completely.


You can set a welcome email logo which will be displayed at the top of the welcome email. You cannot use the service activation email within PBA because the email we generate has a server-generated password for the Outlook Activation link and this would not be available to PBA.


If you wish to provide a custom email template, for example advertising other exciting services on offer, or providing a more rigorously branded email you can paste your template into the Welcome Email Template field. If this field is populated the standard white label template is not used. Your template must contain {link} somewhere within the body and this will place the Outlook Messaging Activation link wherever this substitution value is specified


Click Next once completed


The next screen is additional parameters. If you wish to have a custom name and description for the service which will show for the user once they are logged in, you can enter them under the 'Custom application name' and 'Custom application description' boxes. Otherwise, accept the defaults and click next.




The next screen is provisioning attributes. It will say 'No Items Found'. This is expected behaviour. Click next.


On the summary screen quickly check over the values, then click Finish to complete the APS package installation.


Define Application Resource Unit


Message Usage

If you do not need your customers to monitor their own message usage, or integration with PBA you can skip this step.


Similar to defining the resource type 'Application' we need to follow a similar process but instead of selecting the 'Application' resource type we need to select Application Resource (unit). This is used for reporting messaging usage back into the Parallels Platform.


You can provide any name for this resource usage type, we recommend something like 'SMS Text Messages'


Pick the resource on the next screen 'SMS Usage' and Finish the Wizard. You should see something similar to the screenshot below:





Integrate with a Service Template

Once you have the APS package installed you need to integrate the package within a Service Template to expose it to your users.



Add the resource to a Service Template


You need to add the Bulletin SMS Texting Service to your service template. When you do this you will be presented with a screen - similar to below.


You can set limits on the number of users for each Parallels entity that can be created "Application User" however we recommend this is set to unlimited. You can ignore the "Application Backup" - this is not used.



Once you are happy to use the service template you must Activate it.




Upgrading the Package 


An upgraded APS package shows up within the APS Catalogue with a status of "Upgrade". You must import the upgraded package as per a new installation.


Once you have imported the package it is not automatically upgraded for your customers. You must manually approve this within the application information as shown below.




FAQ


Is it possible to have a Trial period? 

Yes. Please see the Parallels Business Automation Example Setup for more info on this.


How do I see message use?

Accruing message use via resources will work inside Parallels Automation if you configure it as detailed within the guide. To reset resources and bill for them as plans you can integrate with Parallels Business Automation. 


How do I white-label the product?

 Please contact Bulletin.