Page: Installing the Push Service
Page: Configuring the Push Provider
Page: Push Service Configuration
Page: Using the Push Service
Page: Push Configuration
Page: 7.4.7 Release Notes
Page: Announcing the 7.4.7 Release
Page: Using the Push Service
Installing the Push Service
This topic describes how to install the AppStudio push service. This topic contains the following sections:
To use the push service, you must have the following information available:
The AppStudio platform ZIP file. This file is available from the download page.
- configuration database name, server name, login name, and password. This is the information you used to install the configuration database in Installing the Configuration Database.
- iOS only: For iOS push notification deployment, you must obtain a signed iOS Push Notification certificate. For more information about getting a signed certificate, see Push notification services certificate.
If you are reinstalling or upgrading the AppStudio push service, you must stop the push service first. For more information, see Starting and stopping the push service.
Installing the push service
To install AppStudio push service:
- Extract the contents of the PushServiceInstaller.zip file to the machine where you are installing the AppStudio push service.
- Install the push service by running the installer, PushServiceInstaller.msi, from the unzipped PushServiceInstaller.zip file.
- In the Select Installation Folder window of the installation wizard, accepts the default destination for the AppStudio push service, C:\Program Files\AppStudio Software\Push Service\, or browse to a different location.
- Specify if the push service is for you, or for all users of the machine. You can select Everyone or Just me.
- Click Next twice.
The installer launches the AppStudio Software Connection Tool, a utility for configuring push service-to-database connections.
If the installer does not automatically launch the AppStudio Connection Tool, launch it yourself by:
- Extracting the contents of the PushService_Raw.zip file to the machine where you are installing the AppStudio push service.
- Running the PM_DBConnectorTool.exe file from the expanded PushService_Raw.zip file.
In the AppStudio Connection Tool, select the AppStudio Push Services tab.
- The AppStudio Connection Tool writes configuration values to the PushServices.exe.config file. In the AppStudio Connection Tool, verify that Config File specifies the path to the PushServices.exe.config file in the directory where you installed the push service. If you installed AppStudio push service in a non-default location, navigate to that location to find PushServices.exe.config.
You can also import a configuration file that contains connection parameters by the clicking Import button.
In the AppStudio Connection Tool, click Push Database to set parameters for the configuration database. The push service requires a connection to the configuration database. The following dialog box appears:
If you don't have the database connection information, you can exit this dialog and defer configuration to another time.
- In the Push Database dialog box, set the following fields:
- Enter the Database Server Name, Database Name, Database Login, and Database Password for the configuration database you installed earlier. Supply a port number in the Database Server Name only if you use a non-standard port. For information about installing the configuration database, see Installing the Configuration Database.
- Database Timeout: Specify, in seconds, the amount of time that elapses before push request times out. Do not leave this field blank, or else the request will not time out. You can start with a value of 120 seconds and adjust it later.
- Click Test Connection String to verify that the push service can connect to your data source.
- After receiving a successful connection alert message, click OK.
- (Optional) In the Advanced Push Configuration section of the AppStudio Connection Tool, enter the interval, in seconds, for each of the following push stages:
- Stage 1 Frequency — The polling interval, in seconds, for the push service to check for a push update.
- Stage 2 Frequency — The subscription interval, in seconds, for the push service to determine the users who will receive the push data. This value is typically smaller than the Stage 1 Frequency to guarantee that it occurs at least once before the next polling interval.
- Stage 3 Frequency — The push interval, in seconds, for the push service to push data to users. This value is typically smaller than the Stage 2 Frequency to guarantee that it occurs at least once before the next subscription interval.
- In the Logging section, set the Log Level that you want to report in the push log:
- Level 10—Errors only.
- Level 20—Workflow and more severe notifications.
- Level 30—SQL and more severe notifications.
- Levels 40-100—Extraneous information and more severe notifications.
- In the Logging section:
- To write AppStudio push service logs to the configuration database, check Use same settings as Push Database.
- To write push logs to a different configuration database:
- Uncheck Use same settings as Push DatabasePush Logging Database.
- Click Push Logging Database and enter data for the additional configuration database server, then test the push service-to-log database connection as you did earlier for the Push database.
- Click Update Config. The installer updates the configuration file for the AppStudio push service.
- Add any plug-ins to the folder where you installed the AppStudio push service for accessing any data sources associated with polling or subscription. This include plug-ins to any data mapped on the polling or subscription views.
Starting and stopping the push service
To start or stop the AppStudio push service:
- Find the AppStudio push service in Control Panel | Administrative Tools | Services.
- Right-click on the service and select Start or Stop.