Configurations for Unix/Linux systems

If you are using a Unix or Linux operating system, you must perform certain operating system configuration tasks before you install Sterling B2B Integrator.

AIX

To ensure that /<install_dir> directory has the necessary permissions, AIX users must run the following command on the parent directory of the /<install_dir> directory before installation:

chmod -R a-s <absolute path>/<install_dir_parent>

where <install_dir_parent> is the directory in which /<install_dir> is created.

For example, to specify

AIX_1/applications/test1/<my_install> as your installation directory, run the command from the AIX_1/applications directory (directly above the test1 directory):

chmod -R a-s test1

or from another location on the file system:

chmod -R a-s /AIX_1/applications/test1

This command ensures that when the <my_install> directory is created during installation, it inherits the correct permissions from the test1 directory.

The ncargs parameter specifies the maximum allowable size of the ARG/ENV list (in 4 KB blocks) when the exec() subroutines are run. Set the ncargs parameter to 16 or higher.

To display the current value of ncargs, enter the command lsattr -El sys0 -a ncargs.

To change the current value of ncargs, enter the command chdev -l sys0 -a ncargs=NewValue.

Note: The lsattr command option is –El (lowercase L) and the chdev command option is –l (lowercase L).

Change the following default entries in the /etc/security/limits file:

  • fsize = -1
  • core = 2097151
  • cpu = -1
  • data = 262144
  • rss = 65536
  • stack = 65536
  • nofiles = 4096

Linux

You can either enable or disable SELinux feature by editing the SELinux property value to Enforcing or disabled under /etc/sysconfig/selinux.

Ensure that /etc/hosts has short-names first for all entries. For example, 127.0.0.1localhostlocalhost.localdomain

If the base locale is English, verify the following values:
  • LANG variable is en_US
  • LANG variable is exported

Red Hat Enterprise Linux 6.x, 7.x, and 8.x versions

Make the following system changes:

  1. If the base locale for the system is English, for Red Hat Enterprise Linux 6.x versions, edit the /etc/sysconfig/i18n file by changing the SUPPORTED variable from en_US.utf8 to en_US. You can also allow multiple locale support with the following format: en_US.utf8:en_US. For Red Hat Enterprise Linux 7.x or higher versions, edit /etc/locale.conf to make sure that LANG=en_US not LANG=en_US.utf8.
  2. Save and close the /etc/sysconfig/i18n file.
  3. Edit the /etc/security/limits.conf file by adding the following lines:
    • * hard nofile 8196
    • * soft nofile 4096
    • * hard memlock 3000000
    • * soft memlock 3000000
    • * hard nproc 16000
    • * soft nproc 16000
    • * hard stack 512000
    • * soft stack 512000

    This change updates the system ulimits. For nofile, set the value to 8196.

    Red Hat Enterprise Linux V6.0 has introduced a configuration file that overrides the nproc setting in the limits.conf file. This file contains a line for nproc configured with a soft limit of 1024.

    soft nproc 1024

    To use the limits.conf file for nproc ulimit settings, you must comment this line out by making the first character on the line a hash or pound symbol.

    #* soft nproc 1024

  4. Save and close the /etc/security/limits.conf file.
  5. Restart the system.
Note: IBM Installation Manager in UI mode might fail to start on an RHEL 6.1 or higher x86_64 (64-bit) OS because Installation Manager is a 32-bit application and depends on some of the 32-bit libraries. For information about installing the required 32-bit OS libraries, refer to the IBM Support website.
CAUTION:
Because of a known issue with the IBM JDK on RHEL 6.1 or higher, a performance degradation might be seen in comparison to previous RHEL releases. To avoid this issue, disable the CFS on RHEL 6.1 or higher.

To disable CFS:

  1. Log in as root
  2. Edit /etc/sysctl.conf and add "kernel.sched_compat_yield = 1"
  3. Restart the system

For more information, go to the IBM SDK and Runtime Environment Java Technology Edition Version 6 information Center and search for known limitations on Linux.

SUSE Linux

Make the following system changes:

  1. If the base locale for the system is English:
    • For the individual user, edit the $HOME/.i18n file by setting export LANG="en_US".
    • For a system-wide change, edit the /etc/sysconfig/language file by setting RC_LANG="en_US". You must also set ROOT_USES_LANG="yes".
  2. You can also allow multiple support with the following format: RC_LANG="en_US.utf8:en_US"
  3. Save and close the file. Language settings take effect on your next session.
  4. Edit the /etc/security/limits.conf file by adding the following lines:
    • * hard nofile 8196
    • * soft nofile 4096
    • * hard memlock 3000000
    • * soft memlock 3000000
    • * hard nproc 16000
    • * soft nproc 16000
    • * hard stack 512000
    • * soft stack 512000

    This change updates the system ulimits. For nofile, set the value to unlimited.

  5. Save and close the /etc/security/limits.conf file.
  6. Restart the system.