Running Methods and Scripts for Dynamic Service Activator Services (SRC CLI)

To run a method or script for the Dynamic Service Activator Web service interface:

Run the test dsa dsa-service command.
where:
- subscriber-login—Logs in subscribers.
- subscriber-logout—Logs out subscribers.
- subscriber-read-subscription—Determines whether a subscriber accesses services through the SRC owner’s network and obtains all of that subscriber’s subscriptions.
- subscriber-activate-service—Activates subscribers’ subscriptions to services.
- subscriber-deactivate-service—Deactivates subscribers’ subscriptions to services.
- subscriber-modify-service—Modifies subscriptions.
- invoke-script—Manages all operations involved with invoking scripts.
- invoke-gateway-extension—Invokes a servlet that has been created and deployed in the SRC SOAP Gateway Web application server.

Testing Subscriber Logins and Logouts (SRC CLI)

These methods support only subscribers who are identified by their IP addresses. These methods do not support subscribers who are identified by the names they use to log in or by their DNs.

Use the following commands to test the methods that log in and log out subscribers:



test dsa dsa-service subscriber-login <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> <subscriber-id subscriber-id> <subscriber-password subscriber-password> <client-id client-id> <client-password client-password>



test dsa dsa-service subscriber-logout <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> <client-id client-id> <client-password client-password>

Testing Subscriber Access to Subscriptions (SRC CLI)

Use the following command to test the method that determines whether a subscriber accesses services through the SRC owner’s network and obtains all of that subscriber’s subscriptions:



test dsa dsa-service subscriber-read-subscription <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> <attributes attributes> <filter filter> <client-id client-id> <client-password client-password>

Testing Subscription Activations and Deactivations (SRC CLI)

Use the following commands to test the methods that activate and deactivate subscribers’ subscriptions to services:



test dsa dsa-service subscriber-activate-service <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> service-name service-name <service-session service-session> <accounting-tag accounting-tag> <downstream-bandwidth downstream-bandwidth> <upstream-bandwidth upstream-bandwidth> <session-timeout session-timeout> <subscription-user subscription-user> <subscription-password subscription-password> <substitutions substitutions> <client-id client-id> <client-password client-password>



test dsa dsa-service subscriber-deactivate-service <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> service-name service-name <service-session service-session> <client-id client-id> <client-password client-password>

Testing Subscription Modifications (SRC CLI)

Use the following command to test the method that modifies subscribers’ subscriptions to services:



test dsa dsa-service subscriber-modify-service <subscriber-type
ip_address | dn | login_name | interface_name | interface_index |
assigned_ip | primary_user_name> <subscriber-address subscriber-address> <login-name login-name> <dn dn> <virtual-router virtual-router> <interface-name interface-name> <interface-index interface-index> <primary-user-name primary-user-name> <subscriber-constraint subscriber-constraint> service-name service-name <service-session service-session> <accounting-tag accounting-tag> <downstream-bandwidth downstream-bandwidth> <upstream-bandwidth upstream-bandwidth> <session-timeout session-timeout> <subscription-user subscription-user> <subscription-password subscription-password> <substitutions substitutions> <client-id client-id> <client-password client-password>

Testing Script Invocations (SRC CLI)

Use the following command to test the method that manages all operations involved with invoking scripts:



test dsa dsa-service invoke-script sae-script-name sae-script-name sae-script-arguments sae-script-arguments <client-id client-id> <client-password client-password>

This method retrieves requests to invoke scripts from the gateway client, authenticates the gateway client, verifies the arguments supplied by the gateway client, communicates with other SRC components, and returns values to the gateway client.

Testing Gateway Extension Invocations (SRC CLI)

Use the following command to test the method that invokes a servlet that has been created and deployed in the SRC SOAP Gateway Web application server:



test dsa dsa-service invoke-gateway-extension gateway-extension-name gateway-extension-name gateway-extension-arguments gateway-extension-arguments <client-id client-id> <client-password client-password>

The servlet can be a standalone application, or it can be part of a WAR or EAR file. When deployed, servlets invoked with this method should be accessible only from the local host.

Example: Testing Subscriber Access to Subscriptions

To view a list of the Dynamic Service Activator client’s subscriptions:

Issue the test dsa dsa-service subscriber-read-subscription command.
Enter the required information (such as client ID, client password, and subscriber address). The entered data must match the data you configured.
For example, this information is provided for Fred: