Managing Accounts and SLAs

Managing Application Instances

This section describes how application instances are managed and provisioned:

See Reference: ApplicationInstances, for information finding the operations in the Administration Console and for the name of the MBean.

Prior to registering application instances, service provider and application accounts must have been created: see Managing Service Provider and Application Accounts.

Summary of Tasks related to Application Instances

States of Application Instances

Application instances have states. Two states are possible:

In state ACTIVATED, the application using this application instance ID is in normal operation.

In state DEACTIVATED, the application using this application instance ID is not allowed to send traffic through Oracle Communications Services Gatekeeper. The account is still valid and the state can be transitional by the Oracle Communications Services Gatekeeper Administrator using:

Operation: setApplicationInstanceState

Web Services Security

When Web Services Security is being used as authentication for the application instance, its credentials must be set up, as in the mapping rules in Table 3-1.

In addition, if X.509 or SAML are being used, the certificates and private keys must be provisioned in the WebLogic Server keystore. For example, ImportPrivateKey utility can be used to load the key and digital certificate files into the keystore. See Oracle WebLogic Server Command Reference at http://download.oracle.com/docs/cd/E12840_01/wls/docs103/admin_ref/ for a description of ImportPrivateKey.

Password Encryption

Application instance passwords are encrypted using 3DES algorithm and stored in persistent storage. If no encryption key is configured, a default encryption key is used, but best practice to to use your own key. It should be 24 Bytes.

Configure the encryption key, starting in the Administration Console:

Reference: ApplicationInstances

All operations are reachable from:

Below is a list of operations for management.

Operation: addApplicationInstance

Scope: Domain

Adds an application instance. Always connected to a service provider/application account combination.

Signature:

addApplicationInstance(ApplicationInstanceName: String, Password: String, ApplicationIdentifier: String, ServiceProviderIdentifier: String, Reference: String)

Operation: countApplicationInstances

Scope: Domain

Displays the number of registered application instances for a service provider/application account/application instance combinations. Can be filtered by state.

Signature:

countApplicationInstances(ApplicationIdentifier: String, ServiceProviderIdentifier: String, State: String)

Operation: getApplicationInstance

Scope: Domain

Gets information about a registered application instance.

The information includes:

Signature:

getApplicationInstance(ApplicationInstanceName: String)

Operation: listApplicationInstances

Scope: Domain

Displays a list of registered application instances for a specific service provider/application account/application instance state combination.

The list contains application instance IDs.

Signature:

listApplicationInstances(ApplicationIdentifier: String, ServiceProviderIdentifier: String, State: String, Offset: int, Size: int)

Operation: removeApplicationInstance

Scope: Domain

Removes a registered application instance.

The account must be in state DEACTIVATED.

Signature:

removeApplicationInstance(ApplicationInstanceName: String)

Operation: setApplicationInstancePassword

Scope: Domain

Defines a new password for an application instance.

Signature:

setApplicationInstancePassword( ApplicationInstanceName: String, Password: String)

Operation: setApplicationInstanceProperties

Scope: Domain

Specifies properties for an application instance: see Account Properties.

Signature:

setApplicationInstanceProperties(ApplicationInstanceName: String, Properties: Set<Map.Entry<String, String>>)

Operation: setApplicationInstanceReference

Scope: Domain

Specifies a reference for an application instance: see Account References.

Signature:

setApplicationInstanceReference(ApplicationInstanceName: String, Reference: String)

Operation: setApplicationInstanceState

Scope: Domain

Performs a state transition for an application instance: see States of Application Instances.

Signature:

setApplicationInstanceState(ApplicationInstanceName: String, State: String)