SevOne NMS Appliance Configuration Guide

Configuration

Note: Terminology usage...

In this guide if there is,

  • [any reference to master] OR
  • [[if a CLI command (for NMS or Kubernetes or Redis) contains master] AND/OR
  • [its output contains master]], it means leader or control plane.

And, if there is any reference to slave or worker, it means follower or agent.

After deploying in Amazon Web Services or Azure or Openstack, set the correct application configuration for the customer's license type and count. Execute the following steps.

  1. If the license has not been applied, logon to the SevOne NMS Appliance via GUI and apply the license when prompted during logon.
  2. Logon to the SevOne NMS Appliance as support via SSH.
  3. You must be in the NMS container to execute the commands in the steps below. Enter the NMS container.
    nms
  4. Execute the following command for the list of all the available modules.

    List of available modules

    
    SevOne-select
    
    Usage:
    /usr/local/scripts/SevOne-select [OPTION [...]] <module> <option> <value>
    OPTION may include:
    -h --help | Show this help and exit.
    --no-color | Show this help in plain text without any colors and exit.
    --no-restart | Do not restart underlying service just make config changes.
    -p --pretend | Do not actually take any action.
    -m --mysql-configuration | Update mysql configuration for given appliance size and model (only
    for 'all' module).
    <module> may be:
    all | Configure config files for all the modules.
    mysql | Configure the MySQL config files.
    nginx | Configure the Nginx config files.
    redis | Configure the Redis config files.
    cli-php | Configure the CLI PHP config files.
    crontab | Configure the crontab files.
    system | Configure the system files.
    openldap | Configure the ldap files.
    ssh | Configure the ssh config files.
    sshd | Configure the sshd config files.
    kafka | Configure the kafka config files.
    php-fpm | Configure the PHP-FPM config files.
    cookie | Configure the cookies.
  5. Each module has configuration options. Drill-down each module to identify the options you have to set on all parts of the NMS.
  6. Module configuration commands may require size or an appropriate mode or fips or config.
  7. To find SevOne NMS appliance sizes available for a module, mysql, execute the following command. The output will indicate what module mysql is currently set to i.e., pas5k in the example below - it is indicated with an asterkisk (*).
    SevOne-select <enter module> appliance
    Example
    
    SevOne-select mysql appliance
     
    dnc100
    dnc1000
    dnc1500
    dnc200
    dnc300
    dnc400
    dnc600
    pas100k
    pas10k
    pas200k
    pas20k
    pas300k
    pas40k
    * pas5k
    pas60k
  8. To configure the size of SevOne NMS Appliance module mysql to pas20k and an AWS instance of the same pas20k size (r4.xlarge), execute the following command.
    SevOne-select mysql appliance <size>
    Example
    SevOne-select mysql appliance pas20k
    SevOne NMS appliance module mysql size is now pas20k.
    
    SevOne-select mysql appliance
     
    dnc100
    dnc1000
    dnc1500
    dnc200
    dnc300
    dnc400
    dnc600
    pas100k
    pas10k
    pas200k
    * pas20k
    pas300k
    pas40k
    pas5k
    pas60k
    Note: You must select the exact size or a larger one when there is no match available. For example, for a PAS2k, since an exact match of pas2k is not available, you may choose the next larger size i.e. pas5k to accommodate the 2000 licenses for pas2k.
    Important: To configure all SevOne NMS appliance modules to a particular size in one go, execute the following command. For example, set size to pas60k.
    
    SevOne-select all appliance -m <enter size>
    SevOne-select all appliance -m pas60k

    All SevOne NMS appliance modules are now set to size pas60k. The -m flag updates the peers table with the necessary capacity values and restarts the database.

    Check size of SevOne NMS appliance modules mysql, redis, and cli-php. It should now be set to pas60k.
    
    SevOne-select <mysql / redis / cli-php> appliance
     
    dnc100
    dnc1000
    dnc1500
    dnc200
    dnc300
    dnc400
    dnc600
    pas100k
    pas10k
    pas200k
    pas20k
    pas300k
    pas40k
    pas5k
    * pas60k
    Check size of SevOne NMS appliance module kafka. It should now be set to pas60k.
    
    SevOne-select <kafka> appliance
     
    dnc
    pas100k
    pas10k
    pas200k
    pas20k
    pas300k
    pas40k
    pas5k
    * pas60k
  9. To configure the mode of SevOne NMS Appliance module crontab, execute the following command.

    List available modes

    
    SevOne-select crontab
    
    Usage:
    /usr/local/scripts/SevOne-select [OPTION [...]] crontab <option> <value>
    OPTION may include:
    -h --help | Show this help and exit.
    --no-color | Show this help in plain text without any colors and exit.
    --no-restart | Do not restart underlying service just make config changes (only for ng
    inx and sshd).
    -p --pretend | Do not actually take any action.
    mode | Configure the 'mode' to use.
    active-model | Configure the active model to use.
    passive-model | Configure the passive model to use.

    List options for active model

    
    SevOne-select crontab active-model
     
    dnc
    * pas
    The option with an asterisk (*) indicates that it is currently selected. In the example above, pas is currently selected.

Example# 1: for PAS

If SevOne instance is vPAS200k, please change the module settings by using the -m option in the command. The -m flag updates the peers table with the necessary capacity values and restarts the database.

SevOne-select all appliance -m pas200k
Note: Command changes all appliance modules such as, mysql, redis, cli-php, and kafka to pas200k. And,
  • crontab <active / passive>-model will be set to pas
  • system supervisord.d will be set to master (i.e., leader)
  • model will be set to PAS

Example# 2: for DNC

If SevOne instance is DNC100, please change the module settings by using the -m option in the command. The -m flag updates the peers table with the necessary capacity values and restarts the database.


SevOne-select all appliance -m dnc100
Note: Command changes all appliance modules such as, mysql, redis, and cli-php to dnc100. Module kafka is set to dnc. And,
  • crontab <active / passive>-model will be set to dnc
  • system supervisord.d will be set to dnc
  • model will be set to DNC