12 Installing CIBER Roaming Manager

This chapter describes how to install CIBER Roaming Manager.

Important:

  • Before you install CIBER Roaming Manager, you must install Interconnect Roaming Manager. See "Installing InterConnect Manager".

  • If you are installing CIBER Roaming Manager to replace an identical release (for example, to restore a clean version of the package), you must first uninstall the existing installation. See "Uninstalling CIBER Roaming Manager".

Installing CIBER Roaming Manager

To install CIBER Roaming Manager:

  1. If the Third-Party software package is not installed already, install it. See "Installing the Third-Party Software" in BRM Installation Guide.

  2. Go to the directory where you installed the Third-Party package and source the source.me:

    source source.me.sh
    

    C shell:

    source source.me.csh
    
  3. Download the CIBER Roaming Manager software to a temporary directory (temp_dir).

    Note:

    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".
  4. Go to temp_dir and enter the following command:

    7.5.0_CIBERRoaming_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.
  5. Follow the instructions displayed during installation.

    Note:

    If you do not specify an installation directory, CIBER Roaming Manager is installed in the /opt/ifw directory.

Uninstalling CIBER Roaming Manager

To uninstall CIBER Roaming Manager, run the uninstaller.bin program from Pipeline_home/uninstaller/CIBERRoaming/uninstaller.bin.

Increasing Heap Size to Avoid ”Out of Memory” Error Messages

To avoid ”Out of Memory” error messages in the log file after installation, increase the maximum heap size used by the Java Virtual Machine (JVM). The exact amount varies greatly with your needs and system resources. By default, the JVM used has a maximum heap size of 60 MB. Increase the maximum heap size to 120 MB by entering the following sample code in a text editor:

%IF_EXISTS%("INIT_JAVA_HEAP", "@INIT_JAVA_HEAP@20m") %IF_EXISTS%("MAX_JAVA_HEAP", "@MAX_JAVA_HEAP@120m")

where 20m and 120m indicate the minimum and maximum heap sizes respectively.

Save the file as Packagename.ja in the temporary directory (temp_dir) to which you downloaded the installation software.

Packagename indicates the name of the installation software. For example, if you downloaded the 7.5.0_Pipeline_solaris_64_opt.bin file on Solaris then, save the file as 7.5.0_Pipeline_solaris_64_opt.ja.