Before running the Oracle Universal Installer, ensure that you:

• Log in to the server as the ipsaadm user. For information, see "IP Service Activator Administrator UNIX User ID (ipsaadm)".

• Install the required supplemental software components, as described in "Installing Supplemental Software Components".

• Log in to the Oracle software delivery Web site and download the IP Service Activator software. See "Downloading the IP Service Activator Software" for more information.

  • Download the Linux Oracle Universal Installer if you are installing onto a Linux 64-bit server.

  • Download the Solaris 64-bit Oracle Universal Installer if you are installing onto a Solaris 64-bit server.

• Un-zip the IP Service Activator software on each server where you want to install IP Service Activator. For example, on a Linux server, run the following command to unzip the file:

  unzip IPServiceActivator-7.x.x.x.x-linux.zip
  

• Synchronize times across all host machines where IP Service Activator components are installed. For example, by using a Network Time Protocol (NTP) server. If device times are not synchronized, delays and problems are likely to occur.

1. Log in to the server as the ipsaadm user.

2. Go to the directory software un-zip location/ipsa/Disk1/install.

3. There are two installation methods:

   • Interactive: For an interactive installation, continue with step 4.

   • Silent: For information about silent installations, including recording an installation session for later re-use in a silent installation, see "About Silent Installations".

4. Create a directory in which to install IP Service Activator, such as /opt/OracleCommunications. Ensure the ipsaadm user has read/write/execute access to this directory.

5. Run the following command:

   ./runInstaller
   

   The Welcome window opens.

   Note:

   Make sure that the display settings are correct. If you cannot use X display, you must run a silent installation.

   If you have not run an Oracle product that installs with Oracle Universal Installer on the target system, the Specify Inventory Directory and Credentials window opens.

6. Enter the path of the inventory directory /export/home/oracle/oraInventory when Oracle Universal Installer is run for a new installation on the server. Then enter the UNIX group name. The oraInventory directory contains the following:

   • oraInstaller.properties

   • logs

   • backup

   • install.platform

   • ContentsXML

   • OUI

7. Click Next.

   The Select Installation Type window opens.

8. Select the components that you want to install.

   You can select any of the following installation types:

   • All Components: includes all IP Service Activator components. This is for a complete installation.

   • Policy Server: includes all Policy Server components

   • Cartridges: includes all Cartridges

   • Web Service: allows you to use the web service to integrate IP Service Activator with Oracle Communications Order and Service Management (OSM)

     For information about configuring the web service installation, see the web services chapters in IP Service Activator API Developer's Guide.

   • All Except Web Service: Includes all IP Service Activator components except web service.

   • Custom: allows you to select the specific components that you want to install

   If you are performing a distributed installation, select the correct components for the host on which you are currently installing. Decisions on which hosts various components are installed on vary depending on the needs of your site. Typically, you might install the Policy Server on one host and the Network Processors on another. For information about distributing components across servers, see "Planning an IP Service Activator Installation".

   The Specify Home Details window opens.

9. Enter the directory path of the base installation and accept the default name, OracleCommunications.

   OracleCommunications identifies the name of the Oracle home on which Oracle services are installed. Click Next.

   • If you selected the installation options All Components or Policy Server in the previous step, the Supplemental Software Location window opens.

   • If you selected the installation option Cartridges in the previous step, the Available Product Components window appears and you must select the specific cartridges that you want to install, and then click Next. The Supplemental Software Location window opens.

   • If you selected the installation option Custom in the previous step, you must select the specific IP Service Activator components you want to install, and then click Next. The Supplemental Software Location window opens.

     Note:

     The Installer checks for the supplemental software files before proceeding with the installation in step 9.

10. Enter the directory path to the location where you placed the supplemental software components. Click Next.

    The IP Service Activator Startup window opens.

11. Select whether you want IP Service Activator to start at every reboot. Click Next.

    The Summary window opens.

    Note:

    The list of installed products might show apparently duplicate entries, however the entries refer to distinct products.

12. Verify the component installation list, and then click Install.

    The Installation window opens with a progress bar.

    The Execute Configuration scripts window opens.

13. Run the configuration scripts by following the steps given in the installation window. The following message appears when you run the scripts:

    “Creating symbolic link in path so that IP Service Activator is stopped when the machine is shutdown."

    After running the scripts, click OK. The root.sh script is in the Oracle_home directory. By running the root.sh script, you ensure that IP Service Activator automatically starts when you run the server.

    The orainstRoot.sh script is in the following directory, under the oraInventory home directory:

    inventory_home/orainstRoot.sh

    The End of Installation window opens.

14. Click Exit to continue or click Installed Products to see the components that were installed.

    When you click Exit, the Configuration Assistants and Execute Configuration scripts dialog boxes open.

15. Click OK.

    The IP Service Activator post-install scripts run.

16. When prompted to start the Configuration GUI to configure IP Service Activator, click Yes.

    The Configuration GUI starts.

See IP Service Activator System Administrator's Guide for information about using the Configuration GUI.

Continue the configuration of IP Service Activator by performing the tasks detailed in Additional setup tasks to be run prior to initial startup topic in IP Service Activator System Administrator's Guide.

If you are performing a distributed installation across multiple servers, repeat this procedure for each host.

The following IP Service Activator modules are installed using the Oracle Universal Installer:

• Common

• Configuration Template Module (CTM)

• Threshold Activated Configuration Control (TACC)

The Common module is automatically installed during the installation.

You must import and link the appropriate controller scripts before running the installed modules. For more information, see information about importing and linking controller scripts in IP Service Activator System Administrator's Guide.

The Oracle Universal Installer supports silent installations using a response file.

A silent installation does not use the Installer GUI and does not display the interactive dialog boxes that you normally see. Instead, installation options are specified in a response file.

Complete details on silent installations, the contents of response files, and customizing and creating new response files are available in Oracle Universal Installer documentation.

Alternatively, you can access Oracle Universal Installer documentation here:

HTML:

http://download.oracle.com/docs/cd/B28359_01/em.111/b31207/toc.htm

PDF:

http://download.oracle.com/docs/cd/B28359_01/em.111/b31207.pdf

IP Service Activator- specific response parameters for Solaris/Linux are as follows:

• SUPP_SOFTWARE_DIR: the directory where the supplemental software components are located.

• AUTOMATIC_STARTUP_REQUIRED: specifies whether IP Service Activator should be started automatically on reboot.

IP Service Activator- specific response parameter for Windows is as follows:

• SUPP_SOFTWARE_DIR: the directory where the supplemental software components are located.

• Install the Policy Server on your Solaris or Linux server(s)

• Obtain the required supplemental software components for the client, as described in "Installing Supplemental Software Components".

• Log in to the Oracle software delivery website and download the IP Service Activator Windows client-only installer software. See "Downloading the IP Service Activator Software" for more information.

• Un-zip the IP Service Activator Windows software on each Windows host where you want to install the IP Service Activator client to a folder such as IPSAInstaller_7.x.x.x.x, which will be referred to as software un-zip location in this procedure.

• Configure the Windows host to prefer IPv4 over IPv6 addresses. See "Configuring the 64-bit Windows Host to Prefer IPv4 Over IPv6 Addresses" for more information.

• Synchronize times across all host machines where IP Service Activator components are installed, for example, by using a Network Time Protocol (NTP) server. If device times are not synchronized, delays and problems are likely to occur. See "Synchronizing IP Service Activator Host Machines".

Before you run the Configuration GUI, make sure all file permissions are set correctly. For more information, see "Setting Permissions for the Installation UNIX User ID".

1. On the Windows host, go to the directory software un-zip location\client\Disk1\install.

2. There are two installation methods:

   • Interactive: continue with step 3.

   • Silent: For information about silent installation, see "To run a silent installation:".

3. Double-click setup.exe.

   If you are installing on a Windows 10 host and see an error regarding swap space/virtual memory, see "Oracle Universal Installer Error" for a resolution.

   The Welcome window opens.

4. Click Next.

   The Select Installation Type window opens.

5. Select the components you want to install.

   You can select from the following installation types:

   • All Client Components: includes the main IP Service Activator client, the client extensions, and the Configuration GUI

   • Custom: allows you to select the specific components you want to install

   Click Next.

   The Specify Home Details window opens.

6. Enter the directory path of the base installation and accept the default name, Oracle Communications. Click Next.

   If you selected the installation option All Client Components in step 5, the Supplemental Software Location window opens.

   If you selected the installation option Custom in step 5, the Available Product Components window appears. Select the specific components you wish to install, then click Next. The Supplemental Software Components window opens.

7. Enter the directory path to the location where you placed the supplemental software components. Click Next.

   The Summary window opens.

8. Verify the component installation list, and then click Install.

   The Installation window opens with a progress bar.

   When the Installer is finished running, the End of Installation window opens.

9. Click Exit if you want to start the configuration GUI and configure the installation, or click Installed Products to see the components that were installed.

10. When prompted to start the Configuration GUI to configure IP Service Activator, click Yes.

    The Configuration GUI starts.

    See IP Service Activator System Administrator's Guide for information about using the Configuration GUI.

    The following IP Service Activator modules are installed using the Oracle Universal Installer:

    • Common

    • Configuration Management

    • CTM GUI Extension

    • TACC

    The Common module is automatically installed during the installation.

11. If you installed the IP Service Activator client on a Windows 10 host, navigate to the folder in which the IP Service Activator client is installed, such as C:\Program Files\OracleCommunications. Right-click OracleCommunications. Click the Security tab and give full read and write permissions to users who will use IP Service Activator.

To run the client installer in silent mode:

1. For a Windows installation, locate the response template file in client\Disk1\stage\Response in the IP Service Activator Windows software.

   The client is supported only on Windows.

   The Response folder contains the following response template files for the corresponding installation types:

   • oracle.communications.ipsa.AllClientComponents.rsp: All Client Components

   • oracle.communications.ipsa.Custom.rsp: Custom

   In a Custom installation type, open the oracle.communications.ipsa.Custom.rsp file and remove the entries that you do not want to install from the DEPENDENCY_LIST parameters. Table 7-2 maps the internal component names in the DEPENDENCY_LIST parameters with the names in the Oracle Universal Installer.

   Table 7-2 DEPENDENCY_LIST Parameter Components For Client Installer

   Internal component name	Name in the Installer
   oracle.communications.ipsa.client	Windows GUI Client
   oracle.communications.ipsa.servicemodules	Service Module GUI Extensions
   oracle.communications.ipsa.oss	OSS Integration GUI Extensions
   oracle.communications.ipsa.ctm	Configuration Template Module GUI Extension
   oracle.communications.ipsa.configmgmt	Configuration Management Module GUI Extension
   oracle.communications.ipsa.tools	Tools
   oracle.communications.ipsa.tools.configtool	Configuration GUI
   oracle.communications.ipsa.tools.tacc	Threshold Activated Configuration Control GUI Extension

   Note:

   If you do not remove any of the components from the DEPENDENCY_LIST, the Custom installation type is equivalent to AllClientComponents installation type.

2. (Optional) Open the response template file and modify the following installation parameters:

   • ORACLE_HOME

   • ORACLE_HOME_NAME

   • SUPP_SOFTWARE_DIR

   If you are installing on Windows 10, navigate to the directory software un-zip locationclient\Disk1\install, right-click on setup.exe, and select Properties. In the Properties dialog box, click the Compatibility tab and select Run this program in compatibility mode for Windows XP Service Pack 3. Click OK.

3. Go to the directory client\Disk1\install and run the Oracle Universal Installer as follows:

   setup.exe -silent -responseFile file name
   

   where filename is the full path to response template file, including the file name.

4. After the installation is complete, check the log files, and start the Configuration GUI.

   See “Using the Configuration GUI" in IP Service Activator System Administrator's Guide for information about using the Configuration GUI.

5. If you installed the IP Service Activator client on a Windows 10 host, navigate to the folder in which the IP Service Activator client is installed, such as C:\Program Files\OracleCommunications. Right-click OracleCommunications and, on the Security tab, give full read and write permissions to users who will use IP Service Activator.

6. If you installed the IP Service Activator client on a Windows 10 host, navigate to the Program folder of IP Service Activator, such as C:\Program Files\OracleCommunications\Service Activator\Program, right-click ipsa_explorer.exe, and select Properties.

   The Properties dialog box opens.

7. Click the Compatibility tab and select Run as Administrator.

When you run the Solaris/Linux-based Installer for IP Service Activator server software, the Oracle Instant Client is automatically installed and a tnsnames.ora file is configured to provide connectivity to the Oracle Database. However, the Windows-based Installer for the IP Service Activator client does not include the Oracle Instant Client.

The IP Service Activator client communicates with the Policy Server using CORBA, through the Naming Service. In general, the Oracle Instant Client is not required for the IP Service Activator client, unless you want to be able to access logs from the client.

Logs are stored directly in the Oracle Database. To view audit trail, device configuration, or system message logs in the IP Service Activator client, you must install and configure an Oracle client (such as the Oracle Instant Client) and configure an ODBC Data Source for IP Service Activator on the client host.

For Oracle Client configuration details, see "Manually Configuring Oracle Client Connection: Solaris".

CTM uses Oracle Database features for XML document handling, and PL/SQL stored procedures for optimizations.

You must ensure the Oracle XML Database is installed prior to installing the Configuration Template module.

Oracle XML Database is usually installed by default with Oracle Database software. For more information about installing Oracle Database, see "Installing and Configuring Oracle Database Software".

If Oracle XML Database is not installed, see the Oracle Database product documentation for more information.

To verify if the Oracle XML Database is installed, run the following command as user SYSDBA:

select username from dba_users where username like 'X%';

If the XML Database is installed, the response is XDB. If no value is returned, it means that the XML Database is not installed.