Configuring Unwired Servers

Administration of the Unwired Server configuration is provided through the SUPServerConfiguration interface.

The Unwired Server configuration consists of the following components, which are all metadata-based configurations, except for Apple Push Notification Service:

Communication
- Administration Listener
- HTTP / HTTPS Listener
- SSL Security Profile
- Key Store
- Trust Store
Messaging
- Server
- Apple Push Notification
Replication
- Server
- Push Notification
- Push Notification Gateway
- Pull Notification
Consolidated DB
Java Virtual Machine (JVM) startup options
Apple Push Notification Service

The SUPServerConfiguration interface provides different methods for these components. The metadata-based configurations have these characteristics:

Each of these components is represented by ServerComponentVO.
The properties of ServerComponentVO differentiate these components. See Developer Guide for Unwired Server Management API > Client Metadata.
Each instance of SUPServerConfiguration is a local object which holds values of all metadata-based configurations. All of its methods perform against those values. The values are refreshed when you call the commit()and refresh() methods. After you receive an instance of SUPServerConfiguration, call the refresh() method to populate the values, before calling any other methods.
Changes made through these methods are cached locally unless the commit() method is called. Commit() sends all the cached values (whether changed or not) to the Unwired Server. A server restart may be required for some changes to take effect.

ServerComponentVO
The ServerComponentVO class has a read-only property that you must initialize at construction time.
Start Management of Unwired Server Configuration
Starts the management of Unwired Server configuration information.
Populate Server Configuration
Retrieves the server configuration from the Unwired Server and caches it locally. This method refreshes all metadata-based configuration. The returned ConfigurationValidationStatus contains the validation status of the security configuration on the server.
Commit Local Changes to Unwired Server
Commits local changes to the Unwired Server. The returned ConfigurationValidationStatus contains the validation status of the delivered security configuration on the Unwired Server.
Retrieval of Replication Sync Server Configuration
Retrieves the properties of the replication synchronization server configuration.
Update of Replication Sync Server Configuration
Updates the properties of the replication synchronization server configuration.
Retrieval of Messaging Sync Server Configuration
Retrieves the properties of the messaging synchronization configuration from the Unwired Server.
Update of Messaging Sync Server Configuration
Updates the properties of the messaging synchronization configuration on the Unwired Server.
Retrieval of Consolidated Database Configuration
Retrieves the properties of the consolidated database configuration.
Retrieval of Administration Listener Configuration
Retrieves the configuration of the administration listener.
Update of Administration Listener Configuration
Updates the properties of the administration listener configuration.
Retrieval of HTTP Listener Configuration
Retrieves a list of HTTP listener configurations.
Addition of HTTP Listener Configuration
Adds a new HTTP listener configuration.
Deletion of HTTP Listener Configuration
Deletes the configuration for an HTTP listener.
Update of HTTP Listener Configuration
Updates the configuration of an HTTP listener.
Retrieval of HTTPS Listener Configuration
Retrieves a list of HTTPS listener configurations.
Addition of HTTPS Listener Configuration
Adds a new HTTPS listener configuration.
Deletion of HTTPS Listener Configuration
Deletes the configuration for a secure HTTP (HTTPS) listener.
Update of HTTPS Listener Configuration
Updates the configuration of an HTTP listener.
Retrieval of SSL Security Profile Configuration
Retrieves the list of all the SSL security profiles and their properties.
Addition of SSL Security Profile Configuration
Adds configuration for an SSL security profile.
Deletion of SSL Security Profile Configuration
Deletes the configuration for an SSL security profile.
Update of SSL Security Profile Configuration
Updates the configuration of an SSL security profile.
Key Store Configuration Retrieval
Retrieves the properties of the key store configuration.
Key Store Configuration Update
Updates the configuration of the key store.
Trust Store Configuration Retrieval
Retrieves the properties of the trust store configuration.
Trust Store Configuration Update
Updates the configuration of the trust store.
Retrieval of Apple Push Notification Configurations
Retrieves Apple Push Notification configurations.
Addition of an Apple Push Notification Configuration
Adds a configuration for Apple Push Notification.
Deletion of an Apple Push Notification Configuration
Deletes an Apple Push Notification configuration.
Update of an Apple Push Notification Configuration
Updates an Apple Push Notification configuration.
Retrieval of Certificate Names
Retrieves a list of file names for the .p12 certificates on the Unwired Server.
Set Apple Notification Values
Constructs a value object, APNSAppSettingsVO, which sets values for Apple Push Notification Service settings used for iPhone push notifications.
Update Server Configuration for Relay Server
Updates the server configuration for Relay Server.
Retrieval of Relay Server Outbound Enablers
Retrieves the Relay Server Outbound Enablers for the Unwired Server.

Parent topic: Code Samples