Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

This section

Table of Contents

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

...

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.

Table of Contents

 

...

Linux Server Setup

The VSM Probe 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 setup 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 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’.

Image ModifiedFigure 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

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


Info
Site ID information in the ‘Site’ field will advise your NOC staff of the site where the Linux Server is physically located. This is particularly helpful when the customer has multiple sites.


Image ModifiedFigure 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

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


Table 2 –  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

Image ModifiedFigure 4 - Web Portal – Linux Server SNMP V3 Query



Table 3 – 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:

Image ModifiedFigure 5 - Web Portal – Linux Server Test Access


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

Info
The SSH test ensures the VSM probe collector can connect to, and login using the account configured.


Info
The SNMP test ensures an SNMP query can be run.

Once testing is successful, click Save.