IBM Performance Management

Prerequisite scanner

After you start the installation script for the Performance Management server, a prerequisite scanner runs automatically and displays the results, including the path to a log file that you can review if any of the prerequisites are not met. An out-of-date library or insufficient disk space stops the installation. You must address the missing prerequisite before you can start the installation again.

A soft prerequisite, such as low available memory, does not stop the installation, but is displayed in the results. The minimum requirements for installation are provided in Table 1 and Table 2 in Performance Management server hardware requirements based on system configuration. See the Extra small or Small column in the table for the applicable offering.

Ports

The prerequisite scanner checks if the ports in Table 1 and Table 2 in Performance Management server ports are available and returns FAIL for each port that is not available. For more information about available ports, see Performance Management server ports.If a firewall is blocking the ports, you can either configure the firewall to allow traffic on certain ports or disable the firewall. For more information, see Configuring the firewall for incoming requests to the server.

Sample scan results

The following prerequisite scanner results show an example where the prerequisite checks failed. You must correct the problems that are found and start the installation again. (See Tips for resolving unmet dependencies in Dependencies.)

 Version: 1.2.0.14
     Build  : 20140919
     OS name: Linux
   User name: root

 Machine Information
 Machine name: somehost
 Serial number:  ...


Scenario: Prerequisite Scan

KIM - IBM Monitoring [version 01020006]:
Property                      Result    Found                          Expected
========                      ======    =====                          ========
Memory                        WARN      3.48GB                         0-12GB
Disk                          FAIL      14.00GB                        100GB
os.swapSize                   WARN      3.81GB                         2-4GB
numLogicalCPU                 WARN      2                              4
db2.usersNotPresent           FAIL      db2fenc1,dasusr1               dasusr1, db2apm, db2fenc1, itmuser
db2.groupsNotPresent          FAIL      db2iadm1,db2fadm1              db2iadm1,db2fadm1,dasadm1
os.isUnixServiceRunning.crond FAIL      False                          True
os.lib.pam_32                 FAIL      Unavailable                    regex{libpam.so.*}
os.package.sg3_utils          FAIL      Unavailable                    sg3_utils

Aggregated Properties for Scanned Products:
Property                     Result    Found                          Expected
========                     ======    =====                          ========
/                            FAIL      14.00GB                        100.00GB
Memory                       WARN      3.48GB                         0.00-12.00GB

Overall result:   FAIL

Detailed results are also available in /tmp/smai_prs_20141203_053249/result.txt

The following example of prerequisite scanner results shows operating system, available ports, and library information. The report section titled Required for DB2 indicates that libraries required for DB2® are missing and that the installation might not proceed. You must first install the missing libraries, and start the installation again. (See Tips for resolving unmet dependencies in Dependencies.)

# Validate supported Operating Systems
OS Version=Red Hat Enterprise Linux 6.*,Red Hat Enterprise Linux 7.*
FRESH.Memory=11.0GB
os.space.installdir=[dir:root=/opt/ibm/]60GB
os.space.home=1GB
Temp=2-3GB
os.swapSize=2-4GB
os.umask=0022

os.dir.home=[dir:/home,type:permission]755+
#os.dir.opt=[dir:/opt/ibm,type:permission]755+
os.dir.tmp=[dir:/tmp,type:permission]777+

os.mountcheck.home_nosuid=[drive:/home,nosuid:false]
os.mountcheck.home_noexec=[drive:/home,noexec:false]
os.mountcheck.tmp_nosuid=[drive:/tmp,nosuid:false]
os.mountcheck.tmp_noexec=[drive:/tmp,noexec:false]

CpuArchitecture=x86_64
numLogicalCPU=4

# Check if RPM database is intact.
rpm.dbStatusCorrect=True

# Check if localhost is defined.
os.localhostInHostsFile=True

# Maximum number of user processes.
os.ulimit=[type:maxprocesseslimit]4096+
# Maximum number of open filesos.ulimit=[type:filedescriptorlimit]32768+
# Maximum size of core file 400MB+
os.ulimit=[type:corefilesizelimit]390000+

# DB2-related checks.
db2.isInstalled=Falsedb2.usersNotPresent=[sev:WARN]
db2apm,db2fenc1,dasusr1,itmuser
db2.groupsNotPresent=[sev:WARN]db2iadm1,db2fadm1,dasadm1
db2.servicesNotPresent=DB2_db2apm,DB2_db2apm_1,DB2_db2apm_2,DB2_db2apm_END,db2c_db2apm
db2.servicesNotPresent=50000
os.kernelversion=2.6.16+
os.kernelsNotSupported=[sev:WARN]2.6.32-434;2.6.32-504.7.1
os.isLDAPConfigured=[sev:WARN]False

os.isUnixServiceRunning.crond=True

# Check for available ports
network.availablePorts.MINHTTP=80
network.availablePorts.MINHTTPS=443
network.availablePorts.APMUIHTTP=8080
network.availablePorts.APMUIHTTPS=9443
network.availablePorts.SERVER1HTTP=8090
network.availablePorts.SERVER1HTTPS=8091
network.availablePorts.OSLCPM=10001
network.availablePorts.FNGAIANDB=6414
network.availablePorts.FNEIFRCVR=9998
network.availablePorts.FNINTMSG=32105
network.availablePorts.SCRDERBYDB=1527
network.availablePorts.SCRJAVABKEND=12315
network.availablePorts.DB2=50000
network.availablePorts.RBACSERVER1=13245
network.availablePorts.RBACSERVER2=13246
network.availablePorts.RBACSERVER3=13247
network.availablePorts.RBACSERVER4=13248
network.availablePorts.MONGODB=27000
network.availablePorts.ZOOKEEPER=2181
network.availablePorts.KAFKA1=9092
network.availablePorts.KAFKA2=9989
network.availablePorts.OIDCHTTPS=8099
network.availablePorts.SPARKAAPPS1=[sev:WARN]7077
network.availablePorts.SPARKAAPPS2=[sev:WARN]6066
network.availablePorts.SPARKMASTER=[sev:WARN]18080
network.availablePorts.SPARKWORKER=[sev:WARN]18085
network.pingSelf=True

[OSType:LINUX]
os.package.bash=bash
os.package.lsof=lsof
os.package.rsync=rsync
os.package.unzip=unzip
os.package.zip=zip

[OSType:LINUX][OSArch:64-bit]
os.lib.libc_64=regex{libc\.so.*}
os.lib.libgcc_64=regex{libgcc.*\.so.*}
os.lib.libstdc++_64=regex{libstdc++\.so\.5}
os.lib.libstdc++_64=regex{libstdc++\.so\.6}

# Required for DB2
os.lib.libstdc++_32=regex{libstdc++\.so\.6}
os.lib.pam_64=regex{libpam\.so.*}
os.lib.pam_32=regex{libpam\.so.*}
os.package.sg3_utils=sg3_utils

# Required for Summarization and Pruning Agent
os.package.ksh=ksh

The 32-bit libraries are DB2 prerequisites.

Self-ping test

The self-ping test checks that the host name of the local computer system can be resolved. If the self-ping test fails, complete one of these steps:

If you use a DNS server for host name resolution, complete these steps:
- Check that the /etc/resolv.conf file exists and that it has entries for your DNS servers.
- Verify that your DNS servers are reachable. Open a command prompt and enter:
```
ping DNS_server_IP_address
```
If you use the /etc/hosts file for host name resolution, check that the /etc/hosts file has an entry for your local computer system.
If the IP address of your local computer system is assigned by a DHCP server, check that network interfaces are configured and that an IP address and a netmask are assigned to each interface in the DHCP configuration.

LDAP user authentication

The prerequisite scanner checks if LDAP, Windows Active Directory (winbind), or System Security Services (sss) are used for user authentication. If LDAP is configured, it returns WARN. If an itmuser and DB2 instance users are configured in your LDAP directory and you plan to install the Performance Management server with a local DB2 server, follow the instructions in Installing on a system using an external directory service.

Cron service

The prerequisite scanner checks that the cron service is running.

os.isUnixServiceRunning.crond=True

If you create a DB2 database on an external system or if you connect to a MongoDB database on an external system, you must verify that the cron service is running on these systems.

Maximum user processes and maximum open files

The prerequisite scanner also checks for the maximum user processes and maximum open files, which are returned as

os.ulimit=[type:maxprocesseslimit]4096+
os.ulimit=[type:filedescriptorlimit]32768+

For guidance in checking the limits and changing them, see Dependencies.

For a list of prerequisite scanner properties, what a failure means for each property and what action to take to resolve, see Prerequisite scanner properties.