This chapter explains how to install the Oracle Communications Billing and Revenue Management (BRM) Suspense Manager software.
For information about Suspense Manager, see "About Suspense Manager".
Important:
Suspense Manager is an optional feature that requires a separate license.The Suspense Manager server component is supported on the HP-UX IA64, Linux, AIX, and Solaris operating systems. For information on disk space requirements for these operating systems, see "Disk space requirements" in BRM Installation Guide.
The Suspense Management Center application is supported on the Windows platform and requires approximately 120 MB of disk space.
Note:
Suspense Management Center requires the Java Runtime Environment (JRE), which is included in the Suspense Management Center package and is approximately 50 MB. If the JRE was already installed with another BRM client application, it will not be reinstalled.Before installing Suspense Manager, you must install:
Third-Party software, which includes the PERL libraries and JRE required for installing BRM components. See "Installing the Third-Party Software" in BRM Installation Guide.
The base BRM software.
Rated Event (RE) Loader, which is an optional BRM component. For details, see "About Loading Prerated Events".
If you are installing all Suspense Manager components on one system (typical for a test system), you need the information for that system. If you are installing the Suspense Manager Connection Manager (CM) on a different system (common for a production system), you need the appropriate information for that system.
To install the Suspense Management Center, you need information about the machine running the CM to which Suspense Management Center will connect such as:
Computer or server name
Port number
Database number
To install the Suspense Management Center client software:
Download the software to a temporary directory (temp_dir).
Extract the files in the .zip file to any temporary directory.
Go to the temporary directory where you extracted the client application download file.
Double-click Setup.exe to run it.
On the Choose Destination Location screen, select the destination folder for the program and click Next.
For Install Type, select the type of installation you want, standalone or Web Start.
Standalone is the default setting, click Next if that is the type of installation you need.
To use Web Start features, click Web server and click Next.
On the Connection Manager screen, enter the server, port, and database information and click Next.
On the Select Program Folder screen, accept the default program folder, Portal, or select a new one and click Next.
On the Start Copying Files screen, click Next to start installing the application.
Click Finish to complete the installation process.
From the start options, choose Suspense Management Center, which is under Portal.
Note:
When prompted, use the BRM default login, root.0.0.0.1, and default password, password. All BRM users can change their logins and passwords later.
Click the Suspense Management Center Help button to display information on how to use Suspense Management Center.
If you installed the Web Server version of Suspense Management Center, follow the instructions in this section.
To set up Suspense Management Center on client systems from the Web server, go to this URL in your Web browser:
http://machine_name/SuspenseManagement_en.html
Replace machine_name with the name of the system running the Web server and Suspense Management Center. If Suspense Management Center is located in a subdirectory of your Web server's document root directory, include the full path to SuspenseManagement_en.html.
If your Web server uses a port number other than the default of 80, include the port number in the URL:
http://machine_name:port_number/SuspenseManagement_en.html
For example, if Suspense Management Center is on a system called server1 using port 81, go to this URL: http://server1:81/SuspenseManagement_en.html.
Important:
The first time you start Suspense Management Center on a Windows client system, you download and install the JRE, which includes Java Web Start.Note:
If your Web server uses default port 80, specifying the port number is optional. Otherwise, you must include the port number.
If your Web server doesn't display the page correctly, make sure you set the JNLP MIME type in your Web server.
If the MIME type is set in your Web server, try clearing the cache in your Web browser. For Internet Explorer, delete temporary Internet files.
If you can't see Suspense Management Center displayed in Java Web Start, choose File - Preferences in Java Web Start Application Manager. Under the Advanced tab, change the Remote Application URL field to the Suspense Management Center URL.
For more information on using Java Web Start, see the Java Web Start documentation at http://www.oracle.com/technetwork/java/index.html.
Note:
If you have already installed the product, features that are already installed cannot be reinstalled without uninstalling them first. To reinstall a feature, uninstall it and then install it again.To install the Suspense Manager server components:
Download the software to a temporary directory (temp_dir).
Important:
If you download to a Windows workstation, use FTP to copy the .bin file to a temporary directory on your UNIX server.
You must increase the heap size used by the Java Virtual Machine (JVM) before running the installation program to avoid "Out of Memory" error messages in the log file. For information, see "Increasing heap size to avoid "Out of Memory" error messages" in BRM Installation Guide.
Go to the directory where you installed the Third-Party package and source the source.me file.
Caution:
You must source the source.me file to proceed with installation, otherwise "suitable JVM not found" and other error messages appear.Bash shell:
source source.me.sh
C shell:
source source.me.csh
Go to the temp_dir directory and enter this command:
7.5.0_SuspenseMgr_platform_opt.bin
where platform is the operating system name.
Note:
You can use the -console parameter to run the installation in command-line mode. To enable a graphical user interface (GUI) installation, install a GUI application such as X Windows and set the DISPLAY environment variable before you install the software.(Optional) If you want to install Suspense Manager server components separately, either on this computer or on another computer, select custom install when asked to specify the setup type. Select the components you are installing by typing their respective numbers and click Next. The components are:
SuspenseMgr DM
SuspenseMgr CM
Follow the instructions displayed during installation. The default installation directory for Suspense Manager is opt/portal/7.5.
Note:
The installation program does not prompt you for the installation directory if BRM or Suspense Manager is already installed on the machine and automatically installs the package at the BRM_Home location BRM_Home is the directory where you installed BRM components.Go to the directory where you installed the Suspense Manager package and source the source.me file:
Bash shell:
source source.me.sh
C shell:
source source.me.csh
Go to the BRM_Home/setup directory and run the pin_setup script.
Note:
The pin_setup script starts all required BRM processes.Your Suspense Manager server installation is now complete. See "What's Next?".
The next step is to configure Suspense Manager for your business requirements. See "Configuring Suspense Manager".