Skip to main content
Version: 4.25.x.x LTS

Configuration editing

Configuration editing is usually not an every day administration task and is not required for operation. In production, manual changes of parameters should only be done in emergency cases and only by experienced staff who knows exactly what the effect of such changes are.

The table below describes the relevant configuration commands.

CommandDescription
nevisauth configThe command nevisauth config (or nevisauth config core) opens the main configuration file /var/opt/nevisauth/default/conf/esauth4.xml for editing in a vi editor.You can configure the following aspects in the main configuration file: Authentication plug-ins and their interaction Session management setup * Access control. Changing the configuration requires a server restart.
nevisauth config vmargsThis command allows specifying arguments to be passed to the JVM initialization. It opens the configuration file /var/opt/nevisauth/default/conf/vmargs.conf for editing in a vi editor.You can configure the following aspects in the vmargs.conf configuration file: JVM heap sizing and garbage collection tuning JNDI customizations JCE/JSSE provider and default certificate setup JAAS/Kerberos addon. Changing the configuration requires a server restart.
nevisauth config envSome plugged components require additional environment information. You specify this environment information in the file /var/opt/nevisauth/default/conf/env.conf

Add entries as follows:

# nevisauth config env
VARIABLENAME=VALUE
export VARIABLENAME

You can configure the following aspects in the env.conf file:* JDK/JRE to use (JAVA_HOME)

  • Software versions to use for an instance (version variables) if a software/version other than the default is used.
CommandDescription
nevisauth config exportThe command op nevisauth config export creates a tar archive of the current configuration and stores it in /tmp/esauth4_cfg.tar.
nevisauth config import <tarfile>The command op nevisauth config import <tarfile> imports a tar archive to the current configuration.

The expected format is (same as export):

tar -tvf /tmp/esauth4_cfg.tar
conf/esauth4.xml
conf/env.conf
conf/jaas.config
conf/vmargs.conf
CommandDescription
nevisauth config backupThe command nevisauth config backup creates a tar archive of the current configuration and stores it in /var/opt/nevisauth.
nevisauth config restoreThe command nevisauth config restore restores the last backup.