Installing and Configuring the IMS Software
To install and configure the IMS software:
- On the UNIX host where you will install the IMS software, log in as
root
.- Load SRC software disk 1 into the CD drive.
- Install the UMCims package using the UNIX pkgadd tool.
pkgadd -d /cdrom/cdrom0/SDX_DISK1/solaris10 UMCims
- Follow the instructions on your screen to install the IMS software.
The UMCims package is installed in the /opt/UMC/ims folder.
- Run the following command in the /opt/UMC/ims folder.
etc/config -a
- Configure the local and remote DIAMETER peers in the /opt/UMC/ims/etc/config.properties file.
See Configuration Fields for DIAMETER Peers.
See Configuring Logging Destinations.
See Starting the IMS Process to Provide the A-RACF Rq Interface.
Configuration Fields for DIAMETER Peers
The properties in this section are in the /opt/UMC/ims/etc/config.properties file.
local.address
- IP address of the local DIAMETER peer that is providing the A-RACF Rq interface.
- Value—IP address of the local host that is running A-RACF
- Default—127.0.0.1
- Property name—/ims/A-RACF/Rq/local.address
peer.1.remote.address
- IP address of the remote DIAMETER peer that is providing the SPDF Rq interface.
- Value—IP address of the host that is running SPDF.
- Default—127.0.0.1
- Property name—/ims/A-RACF/Rq/peer.1.remote.address
Configuring Logging Destinations
The properties in this section are in the /opt/UMC/ims/etc/config.properties file. By default, the IMS has three logging destinations. To configure the logging destinations, modify the following parameters in the Logging section of the IMS config.properties file, where <loggerName> is a string that groups parameters for the logging destination.
For more information about logging, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 4, Configuring Logging for SRC Components on a Solaris Platform.
Logger.<loggerName>.class
- file—Event messages are written to a text file.
- stream—Event messages are written to stderr or stdout output.
- syslog—Event messages are written to system log (syslog) facilities.
If you do not fill in this field, the logging destination is disabled, and no logging is performed.
Logger.<loggerName>.filter
- Specifies the type of messages that this log file contains.
- Value—Filter definition. If you do not fill in this field, filtering is disabled.
For more information about defining filters, see Categories and Severity Levels for Event Messages in the SRC-PE Monitoring and Troubleshooting Guide, Chapter 2, Configuring Logging for SRC Components.
Logger.<loggerName>.filename
- For Logger.log1.filename—var/log/ims-a-racf-rq-debug.log
- For Logger.log2.filename—var/log/ims-a-racf-rq-info.log
- For Logger.log3.filename—var/log/ims-a-racf-rq-error.log
Logger.<loggerName>.maxsize
- Maximum size of the log file for file-based logging.
- Value—Number of kilobytes in the range 0-4294967295
- Guidelines—Do not set the maximum file size to a value greater than the available disk space.
- Default—2000000000
Logger.<loggerName>.altfile
- Path of the alternate file. When the log file exceeds the maximum size specified by the Logger.<loggerName>.maxsize parameter, its contents are saved to this alternate file. If an alternate file already exists, it is overwritten.
- Value—Pathname
- Default
- For Logger.log1.filename—var/log/ims-a-racf-rq-debug.alt
- For Logger.log2.filename—var/log/ims-a-racf-rq-info.alt
- For Logger.log3.filename—var/log/ims-a-racf-rq-error.alt
Logger.<loggerName>.stream
- stderr—Event messages are written to stderr output
- stdout—Event messages are written to stdout output
Logger.<loggerName>.hostname
- IP address or name of a host that collects event messages by means of a standard system logging daemon.
- Value—IP address or text string
- Default—localhost
Logger.<loggerName>.facility
- Specifies the type of system log in accordance with the system logging protocol.
- Value—Integer in the range 0-23; each integer corresponds to the standard number for a system logging client
- Default—No value
Logger.<loggerName>.format
- Specifies how the information in an event message is printed for syslog-based logging.
- Value—MessageFormat string as specified in
http://java.sun.com/j2se/1.4.2/docs/api/java/text/MessageFormat.htmlThe fields available for events are:
- 0—Time and date of the event
- 1—Name of the thread generating the event
- 2—Text message of the event
- 3—Category of the event
- 4—Priority of the event
Bootstrap Properties for IMS
The properties in this section are in the IMS bootstrap.properties file.
Config.java.naming.provider.url
- URL of the primary directory that stores configuration information.
- Value—ldap:// <host>:<portNumber>
- <host>—IP address or name of host that supports the Web application
- <portNumber>—Number of the TCP port
Config.java.naming.security.credentials
- Password that the Web application server uses to authenticate and authorize gateway clients.
- Value—<password>
- Guidelines—The password can be encoded in base64 and not visible in plain text. To use an encoded value, use the format {BASE64} <encoded-value>.
- Default—conf
Config.java.naming.security.principal
- DN that contains the username that the Web application server uses to authenticate and authorize gateway clients.
- Value—DN of object that contains the username
- Default—cn=conf, o=Operators, o=umc
Config.net.juniper.smgt.lib.config.staticConfigDN
- Root of the static configuration properties.
- Value—DN of object that contains the username
- Default—I=OnePop, I=NIC, ou=staticConfiguration, ou=configuration, o=Management, o=umc (root of static configuration properties of sample data)
Config.net.juniper.smgt.lib.config.dynamicConfigDN
- Root of the dynamic configuration properties.
- Value—DN of object that contains the username
- Default—ou=dynamicConfiguration, ou=configuration, o=Management, o=umc (root of dynamic configuration properties of sample data)
Config.net.juniper.smgt.des.<propertySuffix>
- Set of properties that specify how IMS interacts with the directory.
- Values—See SRC-PE Getting Started Guide, Chapter 32, Distributing Directory Changes to SRC Components on a Solaris Platform.
- Defaults—See SRC-PE Getting Started Guide, Chapter 32, Distributing Directory Changes to SRC Components on a Solaris Platform.
Logger.file<propertySuffix>
- Set of properties that specify how IMS events are logged to files.
- Values—See SRC-PE Monitoring and Troubleshooting Guide, Chapter 4, Configuring Logging for SRC Components on a Solaris Platform.
- Defaults—See SRC-PE Monitoring and Troubleshooting Guide, Chapter 4, Configuring Logging for SRC Components on a Solaris Platform.
nic.<propertySuffix>
- Set of properties that configure the NIC proxy.
- Values—See SRC-PE Network Guide, Chapter 13, Configuring Applications to Communicate with an SAE.
- Defaults—See SRC-PE Network Guide, Chapter 13, Configuring Applications to Communicate with an SAE.
Starting the IMS Process to Provide the A-RACF Rq Interface
To start the IMS process to provide the A-RACF Rq interface:
- On the IMS host, log in as
root
or as an authorized nonroot admin user.- Start the process from its installation directory.
/opt/UMC/ims/etc/ims start
The system responds with a start message.
Stopping the IMS Process to Provide the A-RACF Rq Interface
To stop the IMS process to provide the A-RACF Rq interface:
- On the IMS host, log in as
root
or as an authorized nonroot admin user.- Stop the process from its installation directory.
/opt/UMC/ims/etc/ims stop
The system responds with a stop message.
Cleaning the IMS Log Files