This chapter describes how to install Oracle Communications Billing and Revenue Management (BRM) IP Address Manager and IP Address Administration Center and how to configure and customize IP Address Manager.
For an overview of IP Address Manager and IP Address Administration Center, see "About IP Address Manager".
IP Address Manager is supported on the HP-UX IA64, Solaris, Linux and AIX operating systems. For information on disk space requirements for these operating systems, see "Disk Space Requirements" in BRM Installation Guide.
IP Address Administration Center is supported on the Windows platform and requires approximately 100 MB of disk space to download, extract, and install the software.
Note:
IP Address Administration Center requires the Java Runtime Environment (JRE). It is included in the IP Address Administration 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 IP Address 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.
BRM. See "Putting Together Your BRM System" in BRM Installation Guide.
Oracle 10g or Oracle 11g.
Before installing IP Address Administration Center, you must install:
BRM. See "Putting Together Your BRM System" in BRM Installation Guide.
(Windows only) An application such as WinZip for extracting compressed files.
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 IP Address Manager:
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_IPAddressMgr_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.Follow the instructions displayed during installation. The default installation directory for IP Address Manager is opt/portal/7.5.
Note:
The installation program does not prompt you for the installation directory if BRM or IP Address Manager is already installed on the machine and automatically installs the package at the BRM_Home location.Go to the directory where you installed the IP Address 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 IP Address Manager installation is now complete.
Important:
You should verify that the IP Address Manager Facilities Modules (FMs) were added to the Connection Manager (CM) configuration file.To install IP Address Administration Center on Windows:
Download the software to a temporary directory (temp_dir).
Extract the downloaded .zip file to a temporary directory (temp_dir).
Go to temp_dir and run the setup.exe program. The installation wizard for IP Address Administration Center starts.
Answer the prompts in the installation wizard screens.
Your IP Address Administration Center installation is now complete.
After installing the IP Address Manager software, you will probably want to configure it to meet your business needs. This section explains the tasks necessary to configure IP Address Manager.
Note:
You can perform these tasks in any order, but you must install IP Address Manager first.You can define and use new IP address and APN states. This requires two procedures: defining and loading the state transition model, and loading the localized state names. See "Customizing APN Device States".
You can define new service and account associations for IP address and APNs. See "Customizing IP Address and APN Service Association Lists".
This section explains how to control device life cycles by changing the default IP address and APN device states to meet your business needs. For a list of the default states and their relationships, see "About IP and APN Device States". You can change the state names and their relationships to each other. This section explains how to create new IP address and APN device states and state relationships. For information on changing the IP Address Manager opcodes to set these new states, see "Using the IP Address Manager APIs".
You can create brand-specific device states. See "Device Management and Brands" in BRM Developer's Guide. However, you need to be careful to create device state mappings that work if you change the brand of an APN. For example, if a device is in state 2 in one brand, it is still in that state when you change brands, but state 2 might be defined differently in the new brand.
Customizing IP address states includes adding or changing the device states, their names, and their relationships. These tasks are explained in the sections below.
Adding or Changing IP Address States
To customize device states, edit the pin_device_state_ip file in BRM_Home/sys/data/config, and then load it by running the load_pin_device_state utility. See "Defining the Device Life Cycle" in BRM Developer's Guide.
Adding or Changing Device State Names
When you customize device states, you need to add the new device state name to the list of device states that is displayed in IP Address Administration Center. To do so, you edit the ip_device_states.en_US sample file in the BRM_Home/sys/msgs/ipdevicestates directory. You then use the load_localized_strings utility to load the contents of the file into the /strings objects. See "load_localized_strings" in BRM Developer's Guide.
When you run the load_localized_strings utility, use this command:
load_localized_strings ip_device_states.locale
Note:
If you are loading a localized version of this file, use the correct file extension for your locale. For a list of file extensions, see "Locale Names" in BRM Developer's Guide.For information on loading the ip_device_states.locale file, see "Loading Localized or Customized Strings" in BRM Developer's Guide.
For information on creating new strings for this file, see "Creating New Strings and Customizing Existing Strings" in BRM Developer's Guide.
Customizing an APN device state includes adding or changing the device states, their names, and their relationships. These tasks are explained in the sections below.
Adding or Changing Device States
To add or change device states, edit the pin_device_state_apn file in BRM_Home/sys/data/config, and then load it by running the load_pin_device_state utility. See "Defining the Device Life Cycle" in BRM Developer's Guide.
Adding or Changing Device State Names
When you customize device states, you need to add the new device state names to the list displayed in IP Address Administration Center. To do so, you edit the apn_device_states.en_US sample file in the BRM_Home/sys/msgs/apndevicestates directory. You then use the load_localized_strings utility to load the contents of the file into the /strings objects. See "load_localized_strings" in BRM Developer's Guide.
This is the syntax:
load_localized_strings apn_device_states.locale
Note:
If you are loading a localized version of this file, use the correct file extension for your locale. For a list of file extensions, see "Locale Names" in BRM Developer's Guide.For information on loading the apn_device_states.locale file, see "Loading Localized or Customized Strings" in BRM Developer's Guide.
For information on creating new strings for this file, see "Creating New Strings and Customizing Existing Strings" in BRM Developer's Guide.
The following sections explain how to customize the lists of acceptable service and account associations.
IP Address Manager allows you to associate services with an IP address. To do so, edit the BRM_Home/sys/data/config/pin_device_permit_map_ip file and then load it into the database by running the BRM_Home/bin/load_pin_device_permit_map utility.
For more information, see "Defining Device-to-Service Associations" and "lo ad_pin_device_permit_map" in BRM Developer's Guide.
You can customize which services are allowed to be associated with IP address devices. To do so, edit the BRM_Home/sys/data/config/pin_device_permit_map_apn file and then load it into the database by running the BRM_Home/bin/load_pin_device_permit_map utility.
For more information, see "Defining Device-to-Service Associations" and load_pin_device_permit_map in BRM Developer's Guide.
The following information will help you use IP Address Manager.
If an APN has no state displayed in IP Address Administration Center, the device states for the APN's brand have not been loaded into the BRM database. The brand administrator for the brand in question must do the following:
Load the pin_device_state_apn file for that brand.
Load the apn_device_states.locale file if it changed or was not previously loaded.
Restart the Connection Manager (CM). See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.
Restart the IP Address Administration Center.
If an IP address has no state displayed in IP Address Administration Center, it means that the device states for the IP address's brand has not been loaded. The brand administrator for the brand in question must do the following:
Load the pin_device_state_ip file for that brand.
Load the ip_device_states.locale file if it changed or was not previously loaded.
Restart the Connection Manager (CM). See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.
Restart the IP Address Administration Center.