3 Installing Wireless Suite

This chapter describes how to install and configure Oracle Communications Billing and Revenue Management (BRM) Wireless Suite.

About Wireless Suite

Wireless Suite is a set of optional features that you can install and configure in a single installation procedure.

Wireless Suite includes the following features:

For information about configuring and using each feature, see the feature's documentation.


  • You cannot choose which features to install. They are all installed.

  • You can also purchase and install these features separately.

The installation procedure installs the software and loads sample configuration data into the database. For example, to configure Number Manager, the installation procedure runs the following utilities:

  • The load_pin_device_permit_map utility, which loads the pin_device_permit_map_num file to create a /config/device_permit_map object.

  • The load_pin_device_state utility, which loads the pin_device_state_num file to create a /config/device_state object.

  • The load_pin_num_config utility, which loads the pin_num_config file to create a /config/num object.

  • The load_pin_network_elements utility, which loads the pin_network_elements file to create a /config/network_element object.

After installing Wireless Suite, you have a system with sample data that you can use for testing. For your production environment, you need to configure each feature separately.


Some of the load utilities used by the installation procedure overwrite existing configurations in the objects into which they load data. As a result, configurations loaded for one component of the suite may be overwritten during the installation of another component. For example, when the suite installs GSM Manager, the load_pin_telco_provisioning utility loads sample GSM data into the /config/telco/provisioning object. However, when the suite installs GPRS Manager, the load_pin_telco_provisioning utility overwrites the data in the /config/telco/provisioning object. To fix this situation, you must run the affected load utilities after installation to ensure that the correct configurations are loading into the relevant configuration objects.

System Requirements

Wireless Suite is available for the HP-UX IA64, Solaris, AIX, and Linux operating systems.

Software Requirements

Before installing Wireless Suite, you must install:

  • Third-Party software, which includes the PERL libraries and JRE required for installing BRM features. See "Installing the Third-Party Software" in BRM Installation Guide.

  • BRM software.

  • Oracle database software.


    To load the configuration data, you must install Wireless Suite on a system that has a Connection Manager installed on it.

Installing Wireless Suite

To install Wireless Suite:

  1. Download the software.


    • 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.

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


    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
  3. Go to the temp_dir directory and enter this command:


    where platform is the operating system name.


    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.
  4. Follow the instructions displayed during installation. The default installation directory is opt/portal/7.5.


    The installation program does not prompt you for the installation directory if BRM or Wireless Suite is already installed on the machine and automatically installs the package at the BRM_Home location.
  5. Go to the directory where you installed the Wireless Suite package and source the source.me file:

    Bash shell:

    source source.me.sh

    C shell:

    source source.me.csh
  6. Go to the BRM_Home/setup directory and run the pin_setup script.


    The pin_setup script starts all required BRM processes.
  7. If your event tables are partitioned, run the partition_utils utility with the -o update parameter from the BRM_Home/apps/partition_utils directory:

    perl partition_utils.pl -o update

    For more information, see "Updating Partitions" and "partition_utils" in BRM System Administrator's Guide.

Setting Up Wireless Provisioning

To set up provisioning for the Wireless Suite Manager:

  1. Enable wireless provisioning. See "Enabling Wireless Provisioning".

  2. Set up event notification for provisioning, specify the details to add to service orders, and define the service order state transitions. See "Setting Up Services Framework for Provisioning".

  3. To provision non-telco services, follow the instructions in "Setting Up Services Framework for Non-Telco Services".

Enabling Wireless Provisioning

By default, provisioning is disabled for Wireless Suite Manager.

To enable provisioning:

  1. Open the Connection Manager (CM) pin.conf file in BRM_Home/sys/cm.

  2. Change the value of the provisioning_enabled entry to 1.

    The default is 0 (disabled).

  3. Stop and restart the CM. See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.

Uninstalling Wireless Suite

To uninstall Wireless Suite, run BRM_Home/uninstaller/WirelessSuite/uninstaller.bin.