This section makes frequent use of data contained in the Technical Requirements.
All relevant sections of the Technical Requirements Data collection should be completed or known before commencing with the steps in this section.
There are two parts to the configuration, the first being the server(s) under management, and the second being the supporting configuration on the web portal.
Both are covered in this chapter.
Linux Server Setup
The VSM collector requires SSH access with Administrative rights. Add an account that when used provides access to the Linux bash prompt.
- Start an SSH session. At the command prompt type su root. When prompted enter the ‘root’ user password.
- Use the command ‘useradd NAME’ where NAME is the account name to create and hit enter.
- Use the command ‘passwd NAME’ where NAME is the account name created above and hit enter. Enter the password then hit enter (need to do this twice).
- Enter the command ‘chage –M 99999 NAME’ where NAME is the account created above and hit enter to set the account password to not expire.
Web Portal Setup
Linux Servers are set up in VSM to enable access concentration to these devices and/or to add a friendly name to devices that are not administered under their own specific vendor.
Linux Server resource and performance data is collected for Linux servers and is available in Capacity Manager Reports along with the Linux Server Health Dashlet.
To add a Linux Server to VSM select the customer you wish to add the device to then navigate to Service Desk> Equipment Locations. Right-click on the Equipment Location that will serve this particular UC Server and select ‘Manage Equipment’
At the bottom of the ‘Manage Equipment’ page click on the ‘Add Equipment’ Button
A form will open which you can populate with the equipment details.
Select the Vendor ‘Linux Server’.
If you are adding more than one piece of the same equipment type check the ‘Add another’ box at the bottom of the form and the bulk of the configuration will be carried over for the next item.
Linux Servers Field descriptions
Field | Setting |
Vendor | Generic Devices |
Equipment Name | Friendly Name of the device |
IP address/Host Name | IP Address or FQDN of the device |
Site | Free text field, this information will be included in alarm notifications from the VSM Workflow. |
User Name | Username allowing access to the Linux shell |
Password | Password |
Complete the Equipment tab and then click on the ‘SNMP Query’ tab.
Optional
The minimum required information is a Name and IP address or Hostname, however, you can add an SNMP version and community string if you wish VSM to query this device for basic information.
To do this, select the ‘SNMP’ tab. Click on the down arrow and select the SNMP version you wish VSM to use for querying the Linux Server:
SNMP V1 or V2
Linux Server SNMP V1/V2 Field Descriptions
Field | Setting |
Version | V1, V2 |
Community String | Community String that is allowed Read access to the device. |
SNMP V3
Linux Server SNMP V3 Field Description
Field | Setting |
Vendor | V3 |
Username | SNMP V3 Username |
Authentication Protocol | SHA (recommended) |
Authentication Password | Password |
Privacy Protocol | DES (recommended) |
Privacy Password | Password |
Once all fields are populated Click on the Test Access button. This will test that VSM can connect to the Linux Server using the settings you have entered:
Both SSH and SNMP (if configured) should return success. If not, troubleshoot the configuration.
Once testing is successful, click Save.