Pre-Installation

If you are deploying on a remote Virtual Machine, execute the steps below to enable and start the docker service.

1. Login to the targeted remote Virtual Machine.

   $ ssh root@<remote Virtual Machine>

2. Ensure docker is installed.
   Minimum docker version requirement for the WLC collector is 18.06.1.
   
   To install a specific version of the docker, please refer to https://docs.docker.com/install/ for details.
3. After docker is successfully installed, enable and start the docker service.

   Enable Docker

   $ systemctl enable docker
   Created symlink from /etc/systemd/system/multi-user.target.wants/docker.service to /usr/lib/systemd/system/docker.service.

   Start Docker

   $ systemctl start docker

4. Verify docker version.

   $ docker version
   Client: Docker Engine - Community
    Version:           23.0.1
    API version:       1.42
    Go version:        go1.19.5
    Git commit:        a5ee5b1
    Built:             Thu Feb  9 19:49:07 2023
    OS/Arch:           linux/amd64
    Context:           default
   
   Server: Docker Engine - Community
    Engine:
     Version:          23.0.1
     API version:      1.42 (minimum version 1.12)
     Go version:       go1.19.5
     Git commit:       bc3805a
     Built:            Thu Feb  9 19:46:47 2023
     OS/Arch:          linux/amd64
     Experimental:     false
    containerd:
     Version:          1.6.21
     GitCommit:        3dce8eb055cbb6872793272b4f20ed16117344f8
    runc:
     Version:          1.1.7
     GitCommit:        v1.1.7-0-g860f061
    docker-init:
     Version:          0.19.0
     GitCommit:        de40ad0

   If the minimum docker version requirement is met but the docker service is not enabled and/or started, the install script automatically enables and starts the docker service. Please refer to Install or Upgrade Collector on SevOne NMS - the extracted tar file contains the install script.
   Docker is now installed.
5. Using the text editor of your choice, change docker bridge0 ip by adding the following to /etc/docker/daemon.json file. This is an optional step.
   This step is needed if you have devices with IPs that match docker0 address space in order to be able to reach them.

   Example: /etc/docker/daemon.json

   {
       "bip": "172.23.1.1/24",
       "storage-driver": "overlay2",
       "storage-opts": [
           "overlay2.override_kernel_check=true"
       ]
   }

   If docker is not installed and you need to install the docker components, please contact IBM SevOne Support.

To disable the Mask Read Community String, execute the steps below on the SevOne NMS appliance.

1. To access the SevOne NMS login page, navigate to the appropriate URL in your browser.
2. From the navigation bar, click the Administration menu > select Cluster Manager > Cluster Settings tab > Security subtab > uncheck Mask Read Community String check box.

To create MySQL user, execute the following steps on the MySQL instance of SevOne NMS.

$ SHOW GRANTS FOR '{user_name}'@'{host}';

1. SSH to SevOne NMS appliance.

   $ ssh root@<NMS appliance>

2. Open a MySQL instance.

   $ mysql

   For the following steps
   
   • <user> is the username. This should also be provided as MYSQL_USER in the .env files for the collector.
   • <ip_address> is the IP Address of the NMS (if running the collector on NMS) or the IP Address of the remote Virtual Machine (if running the collector on the remote Virtual Machine).
   • <password> is the password to be set for the user. This should also be provided as MYSQL_USER_PASSWORD in the .env files for the collector.

3. Create a user.

   $ CREATE USER '<user>'@'<ip_address>' IDENTIFIED BY '<password>';

4. Grant privileges to the user.

   $ GRANT SELECT, EXECUTE ON *.* to '<user>'@'<ip_address>' identified by '<password>';

   IMPORTANT
   You must run the following command to measure the values of the Radio Signal Strength and Signal Noise indicators in dBm.

   $ GRANT INSERT ON  *.*  to '<user>'@'<ip_address>' identified by '<password>';

5. Flush the privileges.

   $ FLUSH PRIVILEGES;