Using the Preferences Tab

The Preferences tab allows you to define and edit push synchronization settings common to all users. If you enable push synchronization, you can send messages to users asking them to perform a synchronization.

You can use the Preferences tab only if the Sun GlassFish Mobility Platform Gateway is configured to allow push synchronization. By default, the Sun GlassFish Mobility Platform Gateway is not configured to allow push synchronization, and a message stating this appears in the Preferences tab panel.

This section describes the following tasks:

• To Enable Push Synchronization for All Users

• To Enable and Disable Push Synchronization

• To Change the Number of Alerts

• To Set the Schedule for All Users

To Enable Push Synchronization for All Users

To enable push synchronization, you must edit a configuration file and then stop and restart the Enterprise Server. You perform these tasks outside the Admin Console.

1. Open the file gmp-domain-dir/lib/ds/conf/gateway.conf in a text editor (gmp-domain-dir is the location of the Enterprise Server domain for Sun GlassFish Mobility Platform).

2. Locate the following line:

   push.polling.check_interval = 0

3. Change the 0 to a value that specifies how often, in milliseconds, the Gateway Engine should check for updates on the EIS/EAI system or database. The following setting specifies an interval of two minutes:

   push.polling.check_interval = 120000

4. Save and close the file.

5. Stop the Enterprise Server (as-install represents the directory where the Enterprise Server is installed):

   as-install/bin/asadmin stop-domain mep

6. Start the Enterprise Server again:

   as-install/bin/asadmin start-domain mep

   You may be prompted for the master password (the default is adminpass). If not, you may need to specify the location of the password file, which is located in the directory where the download bundle forSun GlassFish Mobility Platform was unzipped:

   as-install/bin/asadmin start-domain --passwordfile install-dir/sgmp-1_1-fcs-operating-system/password.txt mep

   where install-dir is the directory where you placed the download bundle.

Next Steps

After you restart the Enterprise Server, the Preferences tab contains three panels. In the Push Strategies panel, the OMA DS Server Alert checkbox is selected, indicating that push synchronization is enabled.

To Enable and Disable Push Synchronization

Use the Push Strategies panel to turn push synchronization on and off for all users. If you enable push synchronization for all users, you can configure it for individual users in the Users panel, as described in To Edit User Preferences.

In order for changes in this panel to take effect, you must stop and restart the Enterprise Server.

To use this feature, follow these steps.

1. To enable push synchronization for all users, select the OMA DS Server Alert checkbox. To disable this feature, deselect the checkbox.

2. Click Save to store and apply your settings, or click Reset to return to the original setting.

3. Stop the Enterprise Server (as-install represents the directory where the Enterprise Server is installed):

   as-install/bin/asadmin stop-domain mep

4. Start the Enterprise Server again:

   as-install/bin/asadmin start-domain mep

   You will be asked for the master password; the default is adminpass.

To Change the Number of Alerts

Use the Number of Alerts panel to set the maximum number of alerts (push synchronization messages) that can be sent in a day, both for all users (combined) and for each individual user. Use this feature to control the cost or bandwidth usage incurred by push synchronization. Follow these steps:

1. In the Default (for all Users) field, type the maximum number of alerts per day for all users.

   Once this value is reached, push synchronization is disabled for all users until the next day. The default value is 1000.

2. In the Max for a Single User field, type the maximum number of alerts per day for a single user.

   Once this value is reached, push synchronization is disabled for this user until the next day. The default value is 1000.

3. Click Save to store and apply these settings, or click Reset to return to the original settings.

To Set the Schedule for All Users

Use the Schedule panel to specify how often Sun GlassFish Mobility Platform checks the server for updated data for a user. If updated data is found, a push synchronization message is sent to a user's mobile device. To use this panel, follow these steps.

1. In the Interval (Default) field, type the desired number of minutes Sun GlassFish Mobility Platform waits before it checks the server for updated data for a user.

   When you create a new user, the default value is used automatically. To modify the value for an individual user, use the Users tab as described in To Edit User Preferences. The default value for this field is 60.

2. In the Interval (Minimum) field, type the minimum number of minutes that can be specified for an individual user.

   The default value for this field is 60.

3. Click Save to store and apply these settings, or click Reset to return to the original settings.