This knowledge article may contain information that does not apply to version 21.05 or later which runs in a container environment. Please refer to
Article Number 000385088 for more information about troubleshooting BMC products in containers.
Legacy ID:KA348042
Below you will find a checklist summarizing all considerations you need to take when installing AR System Server as non-root.
Please notice that these changes must be made before installing or starting the AR System server in the same shell:
ENVIRONMENT
1.- Set the following environment variables properly and permanently in this non-root user profile:
LANG (for example if non-Unicode DB LANG=C but if Unicode DB LANG=en_US.UTF-8)
NLS_LANG
LC_ALL
ORACLE_HOME
TWO_TASK
JAVA_HOME
Solaris and Linux
LD_LIBRARY_PATH=all your normal stuff plus this stuff:/usr/lib:/lib:$ORACLE_HOME/lib:$JAVA_HOME/lib
(Linux) NLSPATH=arSystemInstallPath/locale/%L
(Solaris) NLSPATH=/usr/lib/locale/%L/LC_MESSAGES/%N
AIX
LIBPATH=all your normal stuff plus this stuff:/usr/lib:/lib:$ORACLE_HOME/lib:$JAVA_HOME/lib
NLSPATH=/usr/lib/nls/msg/en_US/%N
HP-UX
SHLIB_PATH=all your normal stuff plus this stuff:/usr/lib:/lib:$ORACLE_HOME/lib:$JAVA_HOME/lib
NLSPATH=/usr/lib/nls/msg/%L/%N
Note:
a) In the NLSPATH environment variable the path names contain these variables:
%L specifies the value of the LANG environment variable (C by default).
%N specifies the name of the message catalog.
Use the NLSPATH environment variable to place the catalogs in a directory other than the default directory.
For example, on Unix, if the default catalog directory is read-only as default.
You can link to the catalogs by setting the NLSPATH environment variable as follows:
export NLSPATH=/usr/ar/locale/%N:/usr/lib/locale/%L/LC_MESSAGES/%N
b) You may need to request help from your Oracle DBA for setting these environment variables properly.
After that run tnsping command for testing successful access to the remote Oracle DB server.
2.- Do the same for IATEMPDIR, by creating this environment variable to specify where to uncompress the installer files and create installation logging:
export IATEMPDIR=/tmp
Note: Be sure to have at least 1GB free on the filesystem for the IATEMPDIR directory.
ARS 8.x SP2 and later IATEMPDIR variable is not longer used. Specify using instead the 'TMPDIR' variable.
3.- On Unix platforms, if you will be starting arserverd as a non-root user, make sure that the open files limit of the shell is at least 16384.
You can set up this limit for non-root users in the /etc/security/limits.conf file or you can change the file descriptors limit by running this command:
ulimit -n 16384
4.- On AIX and HP-UX platforms, the default user data limit is inadequate to start the AR System server.
BMC recommends that this value should be set to unlimited.
To change the user data limit for the current session, run the following command: ulimit -d unlimited
To permanently set the user data limit to unlimited, update the appropriate property in the /etc/security/limits file.
For a non-root user, the system administrator needs to set the limit in the /etc/security/ limits file for that user.
Note:
BMC also recommends that the core file size limit should be set to unlimited.
To change the core file size limit, run the following command: ulimit -c unlimited
To check whether this limit has been set, run the following command: ulimit -a
PERMISSIONS
1- When installing as non-root then please make sure that you have permissions to the following directories and the files under them:
- .profile file in your home directory (write access - in order to properly set the same environment variables in the non-root .profile file).
- /etc/arsystem (the script prompts you to create the /etc/arsystem directory with read/write permissions for all users).
- /etc/rpc (write - this is because the installer merges the contents of files, for example, merge the ARSystemServerInstallDir/ar-Database/rpc file with the /etc/rpc file).
- /dev/console file (write access).
- JRE Java runtime directory [JAVA_HOME] (read/execution for the non-root user and write permissions on $JAVA_HOME/lib).
- Oracle 11g client directory [ORACLE_HOME] (read/execution for the non-root user).
- Catalog files (read-execution).
- /usr/tmp directory (or where the IATEMPDIR or TMPDIR environment variable is pointing).
- /opt/bmc directory (full permissions due this is the place where the AR Server is going to be installed).
If you do not have a /opt/bmc directory, you must create it to complete the installation.
Note: you can do chown <non-root user>
2- On AIX platforms the /usr/sbin/slibclean file needs to be runnable by non-root.
3- When you install as a non-root user, you must update the system configuration files manually.
The installation script prompts you to do this and instructs you to start a shell where you have root access or full read and write access.
You may need to request your Unix administrator to create the links for the message catalog files before attempting running the installer again or starting the ARServer
again by running the following commands.
Example:
ln -s /opt/ar/locale/C/arsystem.cat /usr/lib/nls/msg/en_US/arsystem.cat
ln -s /opt/ar/locale/C/runmacro.cat /usr/lib/nls/msg/en_US/runmacro.cat
Please notice the non-root users do not have permissions to modify this or the /etc/rpc file, so for completing the installation, the RPC file must be changed to either modify or append the following lines to /etc/rpc in order the Unix system be able to use the following private queues:
# Action Request System daemons
arserverd 390600 arserverd
arserverd 390601 arserverd
arserverd 390604 arserverd
arserverd 390619 arserverd
arserverd 390620 arserverd
arserverd 390621 arserverd
arserverd 390622 arserverd
arserverd 390623 arserverd
arserverd 390624 arserverd
arserverd 390625 arserverd
arserverd 390626 arserverd
arserverd 390627 arserverd
arserverd 390628 arserverd
arserverd 390629 arserverd
arserverd 390630 arserverd
arserverd 390631 arserverd
arserverd 390632 arserverd
arserverd 390633 arserverd
arserverd 390634 arserverd
arserverd 390635 arserverd
arserverd 390636 arserverd
arserverd 390637 arserverd
arserverd 390638 arserverd
arserverd 390639 arserverd
arserverd 390640 arserverd
arserverd 390641 arserverd
arserverd 390642 arserverd
arserverd 390643 arserverd
arserverd 390644 arserverd
arserverd 390645 arserverd
arserverd 390646 arserverd
arserverd 390647 arserverd
arserverd 390648 arserverd
arserverd 390649 arserverd
arserverd 390650 arserverd
arserverd 390651 arserverd
arserverd 390652 arserverd
arserverd 390653 arserverd
arserverd 390654 arserverd
arserverd 390655 arserverd
arserverd 390656 arserverd
arserverd 390657 arserverd
arserverd 390658 arserverd
arserverd 390659 arserverd
arserverd 390660 arserverd
arserverd 390661 arserverd
arserverd 390662 arserverd
arserverd 390663 arserverd
arserverd 390664 arserverd
arserverd 390665 arserverd
arserverd 390666 arserverd
arserverd 390667 arserverd
arserverd 390668 arserverd
arserverd 390669 arserverd
arserverd 390680 arserverd
arserverd 390681 arserverd
arserverd 390682 arserverd
arserverd 390683 arserverd
arserverd 390684 arserverd
arserverd 390685 arserverd
arserverd 390686 arserverd
arserverd 390687 arserverd
arserverd 390688 arserverd
arserverd 390689 arserverd
arserverd 390690 arserverd
arserverd 390691 arserverd
arserverd 390692 arserverd
arserverd 390693 arserverd
arserverd 390694 arserverd
arserverd 390695 arserverd
Also see latest documentation:
v.9.1.x - Preparing to install as a nonroot user
v.18.05.x - Preparing to install as a nonroot user
v.18.08.x - Preparing to install as a nonroot user