nevisMeta package installation
This chapter describes the steps that execute to install nevisMeta as a Linux RPM package. The package name is nevismeta.
nevisAppliance is the recommended basis for installing NEVIS components. The installation on a Linux is also supported.
The following requirements need to be fulfilled to install nevisMeta:
- Red Hat Enterprise Linux 7 operating system
- Java OpenJDK 1.8.0 JDK (java-1.8.0-openjdk-devel package).
As a persistence backend, MariaDB Server 10.3 is required.
Installing the nevisMeta RPM
Run the following command to install the nevismeta package:
yum install <path to nevismeta-RPM-package>
Setting up a default instance
The container runs as user nvbuser. To start the Java process on Linux platforms, use the su(1) command. Make sure that the nvbuser has a valid shell set within the /etc/passwd file:
usermod -s /bin/sh nvbuser
The initial installation of nevisMeta requires two steps:
- Installation of the software package.
- Creation of the nevisMeta instance by using the nevismeta handover command.
Preparing the default instance
The handover option of the nevismeta administration script sets up a default instance of nevisMeta:
Use the nevismeta command without options to show a list of further parameters of the nevismeta administration script:
nevisMeta supports the deployment of multiple independent instances per system. Every instance runs independently from other instances as a separate process. You can deploy individual instances in two different modes: The standalone and the Java EE deployment mode.
In the standalone deployment mode, nevismeta uses an embedded container that is packaged with the application itself. The standalone deployment mode is the current default deployment type.
To create a basic nevisMeta instance deployed in standalone mode, run the following command:
nevismeta inst create <instance name>
Upgrading to a new version
Software updates are performed by removing the old and installing the new nevismeta package. Proceed as follows to upgrade to a new software version without changing the configuration:
yum remove nevismeta # running instances will be stopped
yum install <path to the new nevismeta version>
nevismeta <instance name> restart
Uninstalling the package
Proceed as follows to uninstall the nevismeta package:
yum remove nevismeta
Users and groups
The user concept implies that the administrator (nvbuser) is the owner of the configuration files, while all members (primary group) of the NEVIS group (nvbgroup) are able to read the configuration and log files. Each process should only be able to read the configuration files but write its logs.
User ID substitution
The sudo command allows individual users to execute each NEVIS component command. NEVIS recommends registering all neviscommands to the/etc/sudoers file. Example allowing all users that are member of the Unix groupnvbgroupto execute thenevisproxyandnevisauth* commands:
%nvbgroup ALL=(ALL) NOPASSWD:/usr/bin/nevisproxy
%nvbgroup ALL=(ALL) NOPASSWD:/usr/bin/nevisAuth
To modify the Ninja configuration for a specific instance, use the following shell command:
nevismeta <instance name> config login
Configuration parameters are explained in more detail in the Ninja reference guide.