7 IP Service Activator Post-installation Tasks

This chapter describes the post-installation tasks for Oracle Communications IP Service Activator.

IP Service Activator Post-installation Tasks

There are a number of tasks to do after IP Service Activator is installed, but before you create domains, and discover and manage your network devices.

These tasks include:

running the Configuration GUI to configure various system parameters
starting the system
configuring Super User accounts
checking router configurations
loading configuration policies
importing and linking controller scripts
setting up logging
enabling Layer 2 Martini support on the Cisco IOS cartridge if you intend to configure Layer 2 Martini VPNs

Note:
The next tasks you should perform are described in the chapter ”Additional setup tasks after startup” in IP Service Activator System Administrator's Guide. These tasks are required in order to be able to use IP Service Activator.
Tasks include changing the default user group, and default super user when you first log in. After the default user is changed, all users must enter a name and password each time they start the IP Service Activator client. This is described in the ”Changing the default user” topic in IP Service Activator System Administrator's Guide.

Online Help Requirements

The compiled online Help files included with the IP Service Activator client require Internet Explorer version 8 or 9.

Install one of these versions of Internet Explorer on each of your Windows client hosts.

In addition, the online Help requires the use of certain ActiveX controls, which are set up as part of the installation process. The Help file does not run correctly if the ActiveX controls are deleted or disabled.

About Web Services

The Web service is an optional component for an IP Service Activator installation. If you selected the Web Services component during installation, or if you selected the option to install all components, the Web service is available. If correctly installed, the IP Service Activator Configuration GUI shows the Web Service folder in the tree view. You can install Web services on the same server with other IP Service Activator components or you can install it as a standalone component.

Use the IP Service Activator Configuration GUI to configure the Web service and deployment parameters, and then deploy the Web service.

Note:

The database and CORBA components must also be configured for the Web service to function correctly. See IP Service Activator System Administrator's Guide for information about configuring other components in the Configuration GUI.

For more information about using Web Services with IP Service Activator, see IP Service Activator Concepts Guide.

Pre-requisites for Web Services

In order to use the Web service to integrate with Oracle Communications Order and Service Management, you must complete the following tasks in sequential order: install a WebLogic server, install Oracle Application Development Framework (ADF), and create a WebLogic domain. For information about installing WebLogic, and ADF, see Order and Service Management Installation Guide.

Configuring Web Services

Configure Web services using the IP Service Activator Configuration GUI.

To configure Web services:

In the Configuration GUI tree view, double-click the Web Service folder.
Click Common.
Enter the configuration parameters.

For information about Web service configuration parameters, see Table 7-1.

Table 7-1 Web Service Configuration Parameters

Parameter	Description
IPSA ORB Initial Host	The host machine for IPSA CORBA. Default is 127.0.0.1.
IPSA ORB Initial Port	The host port for IPSA CORBA. Default is 2809.
Database Server IP Address	Database server IP address.
Database Server Port	The database server port. Default is 1521.
Database Service Name	The database service name. Default is IPSA.WORLD.
Database User Id	The database user ID. Default is admin.
Database User Password	The database user password.
Confirm Database User Password	Re-enter the database user password.
IPSA User Name	The IP Service Activator user name. Default is admin.
IPSA User password	The IP Service Activator Web Service user password.
Confirm IPSA User password	Re-enter the IP Service Activator Web Service user password.
IPSA Web Service User Name	The IP Service Activator Web Service user name. Default is ipsa_ws_user.
IPSA Web Service User password	The IP Service Activator Web Service user password.
Maximum Query Load	The maximum query load in bytes. Default is 1024000.
EOM Debug Level	Select an option to define the IP Service Activator EOM Debug level. OFF: logging is disabled ERROR: unexpected exceptions are logged at this level (default) TRACE: all logging is enabled. OIM commands and responses are logged at this level. DEBUG: lower logging level than Trace INFO: informational logging. Lower logging level than Debug.
Maximum Retry on Connection Failure	The maximum number of retries on recoverable conditions, for example, database/OIM failures. Default is 3.
OIM Session Timeout	OSS Integration Manager session timeout in seconds. Default is 1200.
OJDL Transaction Short Watch Interval	The OJDL transaction short watch interval in seconds. Default is 5.
OJDL Transaction Short Watch Period	The OJDL transaction short watch period in seconds. Default is 300.
OJDL Transaction Long Watch Interval	The OJDL transaction long watch interval in seconds. Default is 60.
OJDL Transaction Long Watch Period	The OJDL transaction long watch period in seconds. Default is 3600.
OJDL Transaction Commit Period	The OJDL transaction commit period in seconds. Default is 60.
Default Failed Transaction Rollback Behavior	Specifies if failed transactions are automatically rolled back by default. Default is False. Note: You can override this default by specifying different rollback behavior.

Configuring OSS Integration Manager

If you have an OSS Integration Manager (OIM), or multiple OIMs on multiple servers, that you previously installed and configured in IP Service Activator, you can configure the parameters that allow the Web service to interact with those OIMs.

Note:

IP Service Activator does not support multiple OIMs on a single server.

Using the OIM Configuration component in IP Service Activator Configuration GUI, you can add, delete, and modify the OIM configurations that are used for Web services.

For more information about installing and configuring OIMs in IP Service Activator, see IP Service Activator OSS Integration Manager Guide.

To configure an OIM for Web services:

In the Configuration GUI tree view, double-click the Web Service folder.
Click OIM Configuration.
Enter the configuration parameters for the OIM that you want to configure.

For information about OIM configuration parameters, see Table 7-2.

Table 7-2 OIM Configuration Parameters

Parameter	Description
Name	The CORBA name of the integration manager.
Maximum Sessions	The maximum number of OIM sessions. Default is 10.
Minimum Idle Sessions	The minimum number of idle sessions. Default is 5.
Read Only	Select this option if you want to use the integration manager for read only. Deselect this option if you want to use it for both reading and writing.

Deploying and Undeploying the Web Service

Deploy the Web service after you configure all parameters, including the deployment parameters, in the IP Service Activator Configuration GUI. For information about Web service parameters, see "Configuring Web Services". For information about OIM configuration parameters, see "Configuring OSS Integration Manager".

You can also undeploy the Web service.

Note:

To configure the Web service deployment, you require information about the WebLogic server on which the Order and Service Management (OSM) server is deployed. WebLogic parameters are required to connect to a Oracle WebLogic Server.

For information about WebLogic, see WebLogic product documentation. For information about OSM, see Order and Service Management Concepts. For information about installing OSM, see Order and Service Management Installation Guide.

To deploy the Web service:

In the Configuration GUI tree view, double-click the Web Service folder.
Click Deployment.
Enter the configuration parameters for the Web service deployment.
Click Deploy.

The configuration tool does the following:
- updates the IpsaWebService.ear file with the parameter values that you entered in the Web Service node
- creates a JMS Server, a JMS Module, and JMS queues in WebLogic, if they are not already created
- creates a Web Service security user group and a user in WebLogic, if they are not already created
- deploys the IpsaWebService.ear application to WebLogic
For information about Web service deployment parameters, see Table 7-3.

Table 7-3 Web Service Deployment Parameters

Parameter	Description
Weblogic Host	The WebLogic host. Default is 127.0.0.1.
Weblogic Port	The port number for the WebLogic server. Default is 7001.
Weblogic Admin User Name	The WebLogic administrator user name. Default is weblogic.
Weblogic Admin User Password	The WebLogic administrator user password.
Confirm Weblogic Admin User Password	Re-enter the WebLogic administrator user password.
Weblogic Secure Connection	Select this option if you want to use a secure connection to the WebLogic server. Check box is selected by default.
Weblogic Target Server	The WebLogic target server where you want to deploy the IP Service Activator Web service.
Weblogic Home	The directory where WebLogic is installed on the server.

To undeploy the Web service:

In the Configuration GUI tree view, double-click the Web Service folder.
Click Deployment.
Click Undeploy.