Installation
This chapter describes the steps perform to install nevisAuth.
Prerequisites
Operating system and software dependencies
- The Support matrix summarizes Java and Operating system support for all components, including nevisAuth.
- Other nevisAuth specific third party component support is described Nevis Product Lifetime and Platform Support Matrix.
Disk space
- ~500MB of free space in /var (instance configuration files, custom AuthStates, log files)
- ~200MB of free space in /opt (installation files)
- ~200MB of free space in /tmp (nevisAuth is unpacked into a temporary directory during runtime)
The number of instances, log rotation and log file size settings can influence the space required in /var, thus it can be different for each configuration. The above list only shows minimum requirements.
Users and groups
nevisAuth requires the following user to run it:
groupadd -g 30000 nvbgroup
useradd -g nvbgroup -d /tmp -s /bin/false -u 30003 nvauser
Sudo profile
Add the following entries to /etc/sudoers
%nvbgroup ALL=(nvauser) NOPASSWD:/usr/bin/nevisauth
%nvbgroup ALL=(nvauser) NOPASSWD:/opt/nevisauth/bin/nevisauth
Creating the user, group and sudo profile is a manual step.
Installing nevisAuth
Proceed as follows to install the package on Linux:
# rpm -i nevisauth-4.x.y.z-1.noarch.rpm
If no configuration package is provided for nevisAuth, proceed as described in chapter Preparing the initial installation.
Deinstalling nevisAuth
Proceed as follows to remove the nevisAuth software (without deleting log files and configuration):
# rpm -e nevisAuth
The existing server instances are not removed along with the package. It is possible to use them again, when a new software version is installed.
Software upgrade
Proceed as follows to upgrade to a new software version without changing the configuration:
- (optional) Deinstall the old package
- Install the new package