Managing Service Providers and Applications

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Managing Application Instance Group IDs

The following sections describe how to administer application instance group IDs:

All management operations are performed using Network Gatekeeper Management console in the managed object ESPA_access

 


Listing application instance group IDs

To list application instance group IDs:

  1. Find the service provider group, see Listing service provider groups.
  2. Find the service provider account ID, see List service provider accounts associated with a service provider group.
  3. Find the application account ID, see Finding an existing application account ID through the service provider account ID.
  4. Use Operation: getNumberOfApplicationsInApplicationGroup.
  5. The number of application instance group IDs assigned to the application account is displayed.

  6. Use Operation: listApplicationInstanceGroups. Based on the number of application instance group IDs associated with the service provider and application account combination, choose a suitable offset (start listing) and length (how many to list) for the list.
  7. The selected range of application instance group IDs is displayed in alphabetic order.

 


Listing logged in application instance group IDs

To list currently logged in application instance group IDs:

  1. Find the service provider group, see Listing service provider groups.
  2. Find the service provider account ID, see List service provider accounts associated with a service provider group.
  3. Find the application account ID, see Finding an existing application account ID through the service provider account ID.
  4. Use Operation: getNumberOfLoggedInApplicationInstanceGroups.
  5. The number of logged in application instance group IDs is displayed.

  6. Use Operation: listLoggedInApplicationInstanceGroups. Based on the number of logged in application instance group IDs, choose a suitable offset (start listing) and length (how many to list) for the list.
  7. The selected range of logged in application instance group IDs is displayed in alphabetic order.

 


Creating an application instance group ID

Follow the steps below to create an application instance group. An application instance group ID serves as the login username the application. It must be unique. For more information, see Creating and maintaining service provider and application accounts.

Additional tasks may need to be performed, depending on the traffic path the requests will be using, see Mapping applications and service providers to OSA/Parlay accounts and Provisioning specific for traffic paths.

  1. Find the service provider group, see Listing service provider groups.
  2. Find the service provider account ID, see List service provider accounts associated with a service provider group.
  3. Find the service provider account ID, see Finding an existing application account ID through the service provider account ID.
  4. Choose a suitable (descriptive) ID for the application instance group ID according to your naming conventions. It must
  5. List existing application instance group IDs to make sure the application instance group ID is not already in use, see Listing application instance group IDs.
  6. Use Operation: addApplicationInstanceGroupSLAString.
  7. The new application instance group ID is created. The instance group account ID must be activated before the application account's application instance group IDs users can access any services in the network. The application instance group is activated when created. See Activating an application instance group ID (a username).

 


Activating an application instance group ID (a username)

To activate an application instance group ID:

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: activateApplicationInstanceGroup.
  3. The application instance group ID's state is changed to activated. See Table 2-1 for information about the state.

 


Viewing information about an application instance group ID

Follow the steps below to view information about an application instance group ID. The following types of information can be viewed independently of each other:

View application instance group account data

To view the application instance group ID account data (related application group, application instance group reference, OAM properties):

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: getApplicationInstanceGroup.
  3. The application instance group ID's OAM properties, if any, and application instance group ID's reference are displayed.

View state

To view the application instance group's state:

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: getStateForApplicationInstanceGroup.
  3. The application instance group's current state is displayed in the Messages. See Table 2-1 for information about the state.

View application instance group SLA

To view the application instance group's SLA:

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: getSLAForApplicationInstanceGroup ID.
  3. The parameters for the operation are displayed.

    The SLA contents, indicating number of allowed concurrently logged in application instances, is displayed. Is always 1, since only one instance is allowed.

 


Registering an updated SLA for an application instance group

Deprecated because always set to 1. To register an updated the SLA for an application instance group.

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: updateApplicationInstanceGroupSLAString.
  3. The application instance group ID's SLA is now updated and in use.

 


Logging out an application instance group ID

To log out the application logged in with the username related to the application instance group ID.

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: logoutApplicationInstanceGroup.
  3. The application with the application instance group ID is logged out.

 


Unlocking an application instance group

To unlock an application instance group ID that has been locked because of too many failed login attempts.

Note: When an application instance group ID is unlocked, its state is changed to activated.
  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: unlockApplicationInstanceGroup.
  3. The application instance group ID is unlocked and its state is changed to activated.

 


Changing the password for an application instance group ID

To change password for an application instance group ID (a login username).

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: setPasswordForApplicationInstanceGroup.
  3. The application instance group's password is changed.

 


Deactivating an application instance group ID

To deactivate, or temporarily stop the flow of traffic to and from, this application instance group ID:

  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Use Operation: deactivateApplicationInstanceGroup.
  3. The application instance group ID's state is changed to deactivated. See Table 2-1 for information about the state.

 


Deleting an application instance group

To delete an application instance group ID:

Note: If any mailboxes, charging accounts and/or Parlay X settings have been created for this application instance group ID (see Managing mailboxes), they must be removed before removing the application instance group ID. This is only relevant when using backwards compatible traffic paths for messaging.
  1. Find the application instance group ID, see Listing application instance group IDs.
  2. Select Operation: deleteApplicationInstanceGroup.
  3. The application instance group ID is now deleted.


  Back to Top       Previous  Next