Setting up servers

The instance commands are used to install new server instances. There is a default instance for easy installation. Other or additional instances need to be configured by providing setup parameters.

The table below describes all relevant instance commands.

Command	Description
nevisauth inst	This command lists the names of all configured server instances.
nevisauth inst create <name>	A new server instance (by default, a SOAP instance) is set up by entering the following command: # nevisauth inst create default The newly created instance will be deployed on port 8991.Setup parameters may be provided on the command line or by passing a setup property file: # nevisauth inst create default /tmp/setup.properties or (for SOAP deployment with adnjboss): # nevisauth inst create default \
AUTH_SERVER_URL=<https://auth.company.com:8992> A list of all available customization parameters my be retrieved by entering the following command: # nevisauth inst create help The most important parameters are: AUTH_SERVER_URL: The network listener that the server is supposed to start. AUTH_SIGNER_KEYSTORE: Key material to use for token signing. SERVER_SSL_KEYSTORE, SERVER_SSL_TRUSTSTORE: Key material for front-end SSL/TLS adapter (HTTPS). AUTH_TRANSPORT_KEYSTORE, AUTH_TRANSPORT_TRUSTSTORE: Key material to configure JavaSE related (back-end) subsystems (JNDI for LDAPS connections, JSSE for, e.g., HTTPS back-end connections). INST_CUSTOM_TEMPLATE: Directory, containing custom configuration files to replace the ones which are delivered with the package (see/opt/nevisauth/templatefor available files and required structure of this directory). AUTH_DEPLOY_TYPE: Switch between container types. For available options check the chapter. Inspect the standard configuration template in /opt/nevisauth/template for variable use and Components for details about configuration semantics.
nevisauth inst remove <name>	This command: makes a backup of the existing instance (=>/var/opt/nevisauth). stops the server (nevisauth <name> stop). removes all files related to that instance (rm -r /var/opt/nevisauth/<name>*).
nevisauth inst exists <name>	This command is used by configuration scripts to query for already installed server instances.
nevisauth handover	This command performs the following steps: nevisauth inst create default \ nevisauth default start It offers a quick way of installing and starting a nevisAuth default installation