3 IP Service Activator System Requirements

This chapter describes the software and hardware requirements for installing Oracle Communications IP Service Activator.

Support for Linux

IP Service Activator supports Oracle Linux 8.2 (or later) as a 64-bit application. For new host installations, install Oracle Linux as a 64-bit application. The IP Service Activator client runs on Windows. See "Support for Windows" for more information.

To install IP Service Activator on Linux, follow the server installation procedure. Differences between an Oracle Solaris and a Linux installation are identified within the procedure steps.

Support for Windows

IP Service Activator supports the following versions of Windows, all running on 64-bit applications:

  • Windows Server 2019

  • Windows 10

  • Windows 11

Solaris Installation and Configuration

For new host installations, install the full Oracle Enterprise Manager (OEM) version of Solaris. This ensures that Solaris functions well with IP Service Activator.

Check the Solaris OS Version

IP Service Activator is supported on the following Solaris operating systems (OS):

  • Solaris 11.4 (or later)

For supported versions of third-party software, including Solaris, see "Supported Devices and Operating Systems".

To check the Solaris OS version, enter:

$ uname -r

or

$ uname -a

The SunOS version is returned. For Solaris 11 systems, 5.11 is returned.

For a more detailed indication of your Solaris version, check the /etc/release text file:

Go to the /etc directory of the installed image and enter:

# more release

The installed version is returned.

For example:

Oracle Solaris 11.3 SPARC
Copyright (c) 1983, 2018, Oracle and/or its affiliates.  All rights reserved.
Assembled 09 May 2018

Check the Solaris Patches

Ensure that the latest recommended Solaris patch cluster is installed on each IP Service Activator host machine. This includes those patches recommended for Solaris by Sun.

Patches are available for download on Oracle Technology Network at:

http://www.oracle.com/technetwork/topics/security/whatsnew/index.html

To check which patch revision numbers you have installed:

On the Solaris 64-bit platform, enter:

$ showrev -p | more

Supported Devices and Operating Systems

The following tables list IP Service Activator support for vendor devices and operating systems in this release. For more information about which services are supported on each device and OS combination, refer to the respective cartridge guide or device support guide.

Cisco IOS XR Cartridge

Table 3-1 lists the Cisco IOS XR cartridge support on Cisco devices and IOS XR versions.

Table 3-1 Cisco IOS XR Cartridge Support

Devices Supported by IP Service Activator Cisco IOS XR Version

Cisco IOS XRv 9000 Series

6.x, 7.x

Cisco IOS Cartridge

Table 3-2 lists the Cisco IOS cartridge support on Cisco devices and IOS versions.

Table 3-2 Cisco IOS Cartridge Support

Devices Supported by IP Service Activator Cisco IOS Version

Cisco 1000, 2000, 3000, 4000, 6000, 7000, 10000, 12000 series devices

IOS 12.2(33)SRE+, IOS 12.4(24)T+, IOS 12.0(33)S+, IOS 15.0(1)M+, IOS 15.1(2)T+, IOS 15.5(2)S+, IOS 15.6(2)T+, IOS 16.6.1+, and IOS 17.3+

Cisco CatOS Cartridge

Table 3-3 lists the Cisco CatOS cartridge support on Cisco devices and CatOS versions.

Table 3-3 Cisco CatOS Cartridge Support

Devices Supported by IP Service Activator Cisco CatOS Version

Cisco 3500, 3750, 4500, 5500, 6500 series devices

CatOS 7.6, 8.5

Huawei Cartridge

Table 3-4 lists the Huawei cartridge support on Huawei devices and VRP versions.

Table 3-4 Huawei Cartridge Support

Devices Supported by IP Service Activator VRP Version

Huawei Quidway Series Routers AR18-xx, AR28-xx, AR46-xx

Huawei Quidway NetEngine 05/08/16

Huawei Quidway NetEngine 16E, 40-2, 40-4, 40-8, 80

Huawei Quidway NetEngine 40E, 80E

Huawei Quidway Eudemon 500, 1000

Huawei CX600

Huawei AR 1220, 2220, 2240, 3260

Huawei NE40E-X8A

Huawei NE40E-X3

3.4

5.3, 5.5, 5.7

5.3, 5.5, 5.7

5.3, 5.5, 5.7

3.1

5.3, 5.5, 5.7

5.130

8.80

5.160

Juniper JUNOS Cartridge

Table 3-5 lists the Juniper JUNOS cartridge support on Juniper devices and JUNOS versions.

Table 3-5 Juniper JUNOS Cartridge Support

Devices Supported by IP Service Activator JUNOS Version

Juniper SRX-series

Juniper MX-series

JUNOS 15x, 17.x, 18.x, 19.x, 20.x, 21.x, and 22.x

Pre-installation Tasks for Solaris and Linux

This section describes the tasks that you must complete before you install IP Service Activator on Solaris and Linux operating systems.

Enabling Per-process Core Dumps for Solaris

For Solaris, you must verify that the COREADM_PROC_ENABLED is enabled in the system core configuration file: coreadm.conf. If COREADM_PROC_ENABLED is enabled, the corresponding core file is generated for the IP Service Activator process when a core dump occurs. You can use the pstack tool to review and troubleshoot any core dump of a process.

Note:

COREADM_PROC_ENABLED is a system default.

To see the values of the core dump parameters in the coreadm.conf file, you can use this command:

cat /etc/coreadm.conf

The parameters of this file are as follows:

COREADM_GLOB_PATTERN=
COREADM_GLOB_CONTENT=default
COREADM_INIT_PATTERN=core
COREADM_INIT_CONTENT=default
COREADM_GLOB_ENABLED=no
COREADM_PROC_ENABLED=yes
COREADM_GLOB_SETID_ENABLED=no
COREADM_PROC_SETID_ENABLED=no
COREADM_GLOB_LOG_ENABLED=no

To set the core dump parameters, you can run the following command:

coreadm

Enabling Per-process Core Dumps for Linux

With some applications requiring Linux, the coreadm tool is missing. Instead, core file management is configured in the kernel configuration file: /etc/sysctl.conf.

You need to enable core dumps from setuid process, remove file size limits for core dumps, and save them in an appropriate location using meaningful names. To do this, you need to add the following lines into the /etc/sysctl.conf file.

  • fs.suid_dumpable = 2

  • kernel.core_pattern = /var/core/core_%h_%e_%u_%g_%t_%p

To make sure you are not imposing limits on the core files, you need to add the following to the /etc/sysconfig/init file:

  • DAEMON_COREFILE_LIMIT='unlimited'

After you update the /etc/sysctl.conf and /etc/sysconfig/init files, you can refresh the settings by running systctl, as follows:

[root@altix ~]# /sbin/sysctl -p
< list of kernel tunables >
fs.suid_dumpable = 2
kernel.core_pattern = /var/core/core_%h_%e_%u_%g_%t_%p
< list of kernel tunables >

Setting File Resources for Device Discovery

A host supporting IP Service Activator must be configured to support a certain minimum number of available open files (File Descriptors) in order for IP Service Activator to successfully discover large numbers of devices (up to 65535) within one device discovery task. The setting for the number of available file descriptors should be 1024 or greater.

To permanently set the File Descriptors value on the Policy Server host:

  1. Open the /etc/system file.

  2. Add the following two lines:

    set rlim_fd_cur=1024 (or greater)
    set rlim_fd_max=1024 (or greater)
    
  3. Save and close the file.

To determine the current Solaris kernel settings, enter:

ulimit -a

If the value of the nofiles (descriptors) is greater than or equal to 1024, enough file descriptors are available.

There is no advantage, from a scalability or performance standpoint, to have more than 1024 file descriptors available. Setting these parameters higher uses additional memory resources with no improvement in IP Service Activator performance.

Note:

Ensure that the Max File descriptors is set to a value of at least 1024, to eliminate platform issues.

Note:

For increasing the number of available open files (file descriptors), you must edit etc/system file in Solaris. The corresponding file for Linux is /etc/security/limits.conf. The limit is 1024 in Linux by default.

Synchronizing IP Service Activator Host Machines

You should synchronize the system time between IP Service Activator host machines using time synchronization software. Where machines are not synchronized, delays are likely to occur when configuring devices.

Ensure you synchronize the NTP times correctly.

IP Service Activator Administrator UNIX User ID (ipsaadm)

The IP Service Activator administrator (user ID ipsaadm) is the UNIX user account given permissions (during installation) to start and stop the naming service and component manager manually. You must create this user account prior to IP Service Activator software installation.

When creating the ipsaadm user, specify the following details:

  • Username: ipsaadm

  • Group: ipsagrp

  • Secondary group: sys

  • Login shell: /bin/bash

  • Home directory: select any location (known in this document as Service_Activator_home)

Throughout this document, ipsaadm is used as the UNIX user ID associated with IP Service Activator. If you have defined another UNIX user ID for specific uses with IP Service Activator, use it instead of ipsaadm where appropriate.

Setting Permissions for the Installation UNIX User ID

The default permissions set for the installation UNIX account user ID affect the permissions of the directories and files created by the Oracle Universal Installer and configured by the configuration tool. The rest of this section refers to ipsaadm as the account used to run the install.

You must set the umask for the ipsaadm account appropriately for your needs before running the Installer.

The Installer uses the umask from the ipsaadm account during the installation to determine how to adjust the directories and files that it creates.

To set the umask for the ipsaadm account, use the UNIX umask command:

umask [file_creation_mask]

See the Solaris or Linux UNIX documentation for more information about the user account umask.

For example, if the ipsaadm account has a umask of 027, this translates to permissions of "rwxr-x---". The Installer then creates directories with permissions of "rwxr-x---" and configuration files with the permissions "rw-r----".

Note:

It is recommended that you use the umask setting of 077, which translates to directory permissions of "rwx------" and configuration file permissions of "rw-------" (full access to the user and no access to the group or anyone else).

Java Development Environment

To develop Java code, you need a development environment, such as the Java Standard Edition (64-bit), previously known as the Java Development Kit (JDK).

It is recommended that you use the following version:

  • Java SE 1.8.x with the latest Critical Patch Update

For more information about developing application programming interfaces for IP Service Activator, see IP Service Activator API Developer's Guide.

Hardware Requirements

The tables in this section list the hardware required for IP Service Activator to manage networks. The tables include the hardware required for third-party software used in support of IP Service Activator.

The hardware sizing recommendations in this section assume that the Optimized Customer Edge (CE) and Provider Edge (PE) management capabilities are applied in large and very large network deployments.

In order to apply these minimum requirements effectively, you must determine whether you require hardware for a CE or PE deployment. For example, if more than 20 percent of the devices in your deployment are PEs, you should use the PE minimum hardware requirements. Accurately completing the site survey worksheet can help you determine your needs. See "Site Survey Worksheet" for more information.

The network processor can support an equal number of large provider edge routers as customer edge routers. The network processor is limited, however, by the number of transform threads that are available. Transform threads are a subset of worker threads. Each transform thread calculates the difference between the service model and the device model. For provider edges, this calculation requires more memory and time than for customer edges.And while a network processor with a 16gb server allocated with 12gb JVM can support approximately 40,000 devices of any type, you should limit the number of transform threads to approximately 10-20. Limiting the number of transform threads ensures that you don't tax the JVM heap in a scenario where transform threads are calculating deltas for 50 provider edges simultaneously. However, if you have only 10 transform threads calculating 60 devices changes, the network processor can calculate only 10 at a time. You can monitor the JVM heap with the standard java tool and increase the number of transform threads if you have available memory.Oracle recommends that you distribute provider edges to multiple network processors and address gaps with smaller devices.

Note:

When considering your hardware requirements, ensure that you remember to allocate space for running the OS.

Table 3-6 lists the minimum hardware requirements for Policy Server.

Table 3-6 Policy Server Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-threads for CEs CPU-threads for PEs RAM for CEs RAM for PEs

Small (1-1500)

1

2

1 GB

2 GB

Medium (1500-4000)

1

2

2 GB

4 GB

Large (4000-10000)

2

4

2 GB

4 GB

Very Large (10000 +) 64-bit

2+

4+

8 GB

16 GB

Table 3-7 lists the minimum hardware requirements for Integration Manager.

Table 3-7 Integration Manager Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-threads RAM for CEs RAM for PEs

Small (1-1500)

1

500 MB

2 GB

Medium (1500-4000)

1

500 MB

2 GB

Large (4000-10000)

1

1 GB

4 GB

Very Large (10000 +) 64-bit

1

2 GB

8 GB

Table 3-8 lists the minimum hardware requirements for Network Processor with Configuration Management Collector.

Table 3-8 Network Processor with Configuration Management Collector Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-threads for CEs CPU-threads for PEs RAM for CEs RAM for PEs

Small (1-1500)

3

6

5 GB

10 GB

Medium (1500-4000)

3

6

5 GB

10 GB

Large (4000-10000)

3

6

5 GB

10 GB

Very Large (10000 +) 64-bit

4

8

8 GB

16 GB

Table 3-9 lists the minimum hardware requirements for IP Service Activator Client.

Table 3-9 IP Service Activator Client Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-cores RAM

Small (1-1500)

1

1 GB

Medium (1500-4000)

1

1 GB

Large (4000-10000)

1

2 GB

Very Large (10000 +) 64-bit

1

4 GB

Table 3-10 lists the minimum hardware requirements for Oracle Database Server. Ensure that you are using Oracle Database 19c (19.15.0.0.0).

Table 3-10 Oracle Database Server Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-threads for CEs CPU-threads for PEs RAM for CEs RAM for PEs

Small (1-1500)

2

8

4 GB

8 GB

Medium (1500-4000)

2

8

4 GB

8 GB

Large (4000-10000)

4

16

4 GB

8 GB

Very Large (10000 +) 64-bit

4

16

8 GB

16 GB

Table 3-11 lists the minimum hardware requirements for Oracle WebLogic Server. Ensure that you are using Oracle WebLogic Server 14c (14.1.1.0.0).

Table 3-11 Oracle WebLogic Server Minimum Hardware Requirements

Network Size (number of managed CE or PE devices) CPU-cores RAM

Small (1-1500)

2

2 GB

Medium (1500-4000)

2

2 GB

Large (4000-10000)

2

2 GB

Very Large (10000 +) 64-bit

2

2 GB

Table 3-12 lists the minimum hardware requirements for Web Services.

Table 3-12 Web Services Minimum Hardware Requirements

Daily IP Service Activator Order Volume CPU-cores RAM

Small (1-500)

2

2 GB

Medium (500-1500)

2

4 GB

Large (1500+)

4

8 GB