Planning to install on Linux systems

This topic provides information about installing IBM Engineering Lifecycle Management products on Linux systems.

Important: If you use a system startup script such as /etc/init.d/liberty or /etc/rc.*/<liberty_script> to start WebSphere® Liberty server at system boot up time, init.d invokes the startup scripts with the maximum number of file descriptors set to 1024 instead of the system default value that is set in /etc/security/limits.conf (65536). To avoid this problem, add the command ulimit -n 65536 at the beginning of your startup script. This ensures that WebSphere Liberty server is started with the correct file descriptor limit.

Linux

Before you can install and run Jazz products on Linux systems, you must increase the limit of open files and user processes:
1. As a root user add the following lines to the /etc/security/limits.conf file:
```
* hard nofile 65536 
* soft nofile 65536
* hard nproc 10000
* soft nproc 10000
```
2. If you are using REHL7, ensure that the nproc value in /etc/security/limits.d/20-nproc.conf is set to 10000.
3. Restart the Linux system after the configuration files are modified.
4. An individual user can increase the limits within a running shell with the following commands:
```
ulimit -n 65536
ulimit -u 10000
```
  Notes:
  - If these commands are used, start the Jazz® Team Server launchpad program or IBM Installation Manager from the same shell to inherit the modified limits.
  - After these settings have been applied, reindex the server to fix any possible corrupted server indexes:
    - For Jazz Team Server, enter JazzInstallDir/server/repotools-jts -reindex
If Security-Enhanced Linux (SELinux) is enabled, you must disable it or change the security context of the Java Runtime Environment (JRE) to allow text relocation. For more information, see Installing with Security-Enhanced Linux.
The Jazz Team Server installation path names must not contain spaces. The startup script (JazzInstallDir/server/server.startup) and the repository tools script (JazzInstallDir/server/repotools.sh) detect and report this problem.
You must have the GTK x32 libraries available in your Linux system to be able to open the IBM Installation Manager link from the launchpad program. For more information, see this article on jazz.net.
If you are installing IBM Db2® database on Linux, set the shmmax to 1GB.
When running the Jazz Team Server, there are logs and other files that can be modified and written in the Jazz installation directory. For all users to be able to write to the installation directory, you must manually grant write permissions to the JazzInstallDir.
For information about resolving an error that occurs when starting the Requirements Management server in headless mode on Linux, see Deploying and starting the server.
If you are using reports with Engineering Requirements Management DOORS® Next, you must have permission to write to the /tmp/rrc_reports directory.
The Change and Configuration Management application Content Service uses /tmp/contentservice as the default location for content temporary directory. Make sure the Linux service tmpwatch is not set to remove the /tmp directory. For information about changing the default directory in the Advanced Properties section of the Server Administration page, see Tip: Troubleshooting the error 'CRJAZ1247I' when checking files into Jazz Source Control.
By default Redhat 7 firewall settings block public hosts from connecting to already listening ports, such as 80, 9080, or 9443. To open a blocked port on RHEL 7, you can use the iptables and firewall-cmd commands. For instructions, see the Linux documentation.