Introduction

It is essential that certain prerequisites are met before you use this document to configure Linux Servers. Refer to the Implementation Guide for the correct process flow.

By following the flow chart you will have all the information required, and the work will be completed in the correct order so that work won’t have to be repeated and tests run at the time will be relevant.

Prerequisite

This document makes frequent use of data contained in the Technical Requirements document.

All relevant sections of the Technical Requirements document must be completed before commencing with the steps in this document.

Linux Servers

Linux Server Setup

The VSM Probe requires 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 setup 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 then navigate to Service Desk> Equipment Locations. Right-click on the Equipment Location (Appliance) 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 as per table 1. 

Select the Vendor ‘Linux Server’.

Figure 1 –  Add 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.

Table 1 – Linux Servers Field descriptions

Figure 2 – Web Portal – Linux Server Configure Equipment

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

Figure 3 - Web Portal – Linux Server SNMP V1/V2 Query

Table 2 – Linux Server SNMP V1/V2 Field Descriptions

SNMP V3

Figure 4 - Web Portal – Linux Server SNMP V3 Query

Table 3 – Linux Server SNMP V3 Field Description

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:

Figure 5 - Web Portal – Linux Server Test Access

Both SSH and SNMP (if configured) should return success. If not, trouble-shoot the configuration.

Once testing is successful, click Save.