Optima Management System System Administration Guide ...support.westell.com/documents/user-guide/Opt115_SysAdmin.pdfWESTELL.COM Page TOC-4 Optima Version 11.2x System Administration

SYSTEM A

D

Optima Management System

System Administration Guide

Version 11.5x

WESTELL.COM

MIN

ISTRATIO

N G

UID

E

© Westell Technologies

Part # 030-101885 Rev A

WESTELL.COM

Copyright © 2015 by Westell, Inc. All Rights Reserved. Westell, Kentrox and Optima Management System are registered trademarks of Westell. All other names are trademarks of their respective owners.

Information is correct at time of publication and is subject to change without notice. Contact Westell in Aurora, Illinois, to verify current product information. Westell, Inc. is an Equal Opportunity/Affirmative Action employer.

Westell Inc.750 North Commons Drive

Aurora, IL 60504 USAToll Free: (800) 377-8766

International: +1 (630) 375-4950Fax: +1 (630) 375-4931

TABLE O

F CON

TENTS

Table of Contents

Preface:......................................................................................... Preface iAbout This Document: .......................................................................................Preface iOptima Users and Tasks: ................................................................................ Preface iiiDocument Conventions: .................................................................................. Preface ivCustomer Assistance:...................................................................................... Preface vi

Chapter 1: Product Overview ................................................................ 1-1Overview of the Optima Management System ......................................................... 1--2

Benefits ......................................................................................................... 1--2Features ................................................................................................................... 1--3

Chapter 2: Installing and Upgrading Optima ..........................................2-1Performing a Fresh Optima Installation .................................................................... 2--2

Installing a Standalone Server ...................................................................... 2--2Installing Separate OMS and DMC Servers ................................................. 2--4

Upgrading to Optima v11.x from Optima v9.00 or later versions .............................. 2--7Before Starting .............................................................................................. 2--7Upgrading a Standalone Server ................................................................... 2--8Upgrading an OMS ....................................................................................... 2--9Upgrading a DMC Server ........................................................................... 2--10optimainstaller Troubleshooting .................................................................. 2--11Post-Upgrade Tasks ................................................................................... 2--12

Upgrading to the latest version of Optima from Optima Versions Older Than v9.00 .. 2--14Installing Optima Patch Files .................................................................................. 2--15Adding and Editing Systems ................................................................................... 2--18

Page TOC-1

WESTELL.COM

Optima Version 11.2x System Administration GuideTable of Contents

Chapter 3: Optima Client ........................................................................3-1System Requirements .................................................................................................3--2Installing and Uninstalling Redirect .............................................................................3--3

Installing Redirect ............................................................................................3--3Uninstalling Redirect .......................................................................................3--3

Chapter 4: Optima Server ....................................................................... 4-1Overview .....................................................................................................................4--2

Optima Management Server (OMS) ................................................................4--3Data & Measurement Collector (DMC) ............................................................4--3

System and Hardware Requirements .........................................................................4--4Server Size ......................................................................................................4--4Hardware Specifications for OMS Servers ......................................................4--4Hardware Specifications for DMC Servers ......................................................4--5

Executing Linux Commands .......................................................................................4--6Initial Setup Administrative Tasks ...............................................................................4--7

Changing the PostgreSQL Password ..............................................................4--7Configuring the System Clock .........................................................................4--8Configuring the Map View ...............................................................................4--8Setting Up Optima in a Firewalled Environment ............................................4--11DMC Registration ..........................................................................................4--11Configuring the User Session Inactivity Timer ..............................................4--13Configuring Default and Maximum Maintenance Mode Duration ..................4--13

Ongoing Administrative Tasks ..................................................................................4--15Starting and Stopping the Optima Service ....................................................4--15Troubleshooting Using the RHEL Service Configuration Window .................4--16Configuring Logging Options .........................................................................4--16Using the Optima Network Check Utility .......................................................4--17Using the Snapshot Utility .............................................................................4--17Accessing Logging Files ................................................................................4--17Backup and Restore ......................................................................................4--19Inventory Importer and Exporter ....................................................................4--20Event Fix Actions Importer ............................................................................4--24Editing the IP Address and/or Hostname ......................................................4--25Administering Licenses .................................................................................4--26Administering Permissions ............................................................................4--26Configuring Email Notifications .....................................................................4--27Configuring Notifications for Clears and Acknowledgements ........................4--27Adjusting Data Retention Intervals ................................................................4--28Adjusting the Memory Limit for Reports ........................................................4--29Configuration to Show Priority and Outages in Site View .............................4--29Configuration to Directly Connect DAS Site NEs to OMS Server and Enable DAS

Carrier Assignments and Uptime Measurements .................................................................4--31Process Monitoring ...................................................................................................4--32

WESTELL.COM

Page TOC-2

1-800-377-8766


Optima Server Monitor ..................................................................................4--32Node Status Poller .........................................................................................4--34Daemon Watcher ...........................................................................................4--35Fault Generator .............................................................................................4--35Process Monitoring Log Files ........................................................................4--36

Appendix A: Configuring a Removable Direct Access Storage Device ...A-1Installing Red Hat Patch 007 ...................................................................................... A--3Unmounting the Previous Storage Device ................................................................. A--4Installing RAIDar Software ......................................................................................... A--5Connecting the ReadyNAS 2100 ............................................................................... A--6Configuring the ReadyNAS 2100 ............................................................................... A--7Configuring Static IP Addresses for the ReadyNAS 2100 and Optima Server .......... A--9

Assigning a Static IP to the LAN 2 Ethernet Interface .................................... A--9Configuring a Static Route to the ReadyNAS 2100 on the Optima Server ... A--11Configuring the iSCSI Target Area on the ReadyNAS 2100 ........................ A--12Installing Red Hat Patch 007 ........................................................................ A--12Identifying the iSCSI Target .......................................................................... A--12Formatting the iSCSI Target Area ................................................................ A--13

Configuring the iSCSI Mount Point ........................................................................... A--16Mounting the RealNAS 2100 Without Disk Growth .................................................. A--17Mounting the ReadyNAS 2100 with Disk Growth ..................................................... A--18Configuring a NFS mount point ................................................................................ A--19Dell RD1000 Administration Instructions .................................................................. A--20Determining the Device Name ................................................................................. A--20

Internal RD1000 Drive .................................................................................. A--20External RD1000 Drive ................................................................................. A--20

Repartitioning the Device ......................................................................................... A--21Deleting the Partition and Creating a New Partition ..................................... A--21Formatting the Drive to Use an ext3 Filesystem ........................................... A--23

Configuring the Mount Point ..................................................................................... A--23Ejecting and Reinserting the Removable DirectAccess Storage Cartridge .............. A--24

Appendix B: Updating Kentrox Remote Devices .....................................B-1Prerequisites and Assumptions .................................................................................. B--2Upgrading Kentrox Remote Software ......................................................................... B--3Transferring Files to Kentrox Remote ........................................................................ B--4Updating Firmware on Kentrox Remote ..................................................................... B--7Installing Modules on Kentrox Remote Devices ....................................................... B--12

Using the Modulemanager Script ................................................................. B--12

WESTELL.COM

1-800-377-8766

Page TOC-3


Appendix C: .................................................... OMS Disaster Recovery C-1Prerequisites and Assumptions .................................................................................. C--2Recovery Procedure .................................................................................................. C--4

Appendix D: Dell Remote Access Card (DRAC) Guide ..........................D-1Configuring DRAC Network Settings ......................................................................... D--2Accessing the DRAC Web Interface .......................................................................... D--8Configuring DRAC Users ......................................................................................... D--10Configuring DRAC Services ..................................................................................... D--14

Appendix E: Northbound Interface ..........................................................E-1Introduction .................................................................................................................E--2

NBI Integration Methods ..................................................................................E--3SNMP Integration ........................................................................................................E--4

Configuring Optima to Forward Events as SNMP Notifications ......................E--4Decoding the SNMP Notification .....................................................................E--6

NBI Integration Using JMS ........................................................................................E--14Subscribing to NBI JMS Connection .............................................................E--14Extracting Relevant Information from CBEs ..................................................E--16

JMS Message Selectors ...........................................................................................E--20Example JMS Selectors ................................................................................E--20

Event Object Model ...................................................................................................E--21

Appendix F: Red Hat Installation Tasks .................................................. F-1Installing Red Hat ........................................................................................................F--2Increasing Red Hat Linux Swap Space .......................................................................F--7Installing a Service Pack .............................................................................................F--9

Appendix G: Importer and Exporter File Formats ...................................G-1Export File Format ...................................................................................................... G--2Import File Format ...................................................................................................... G--3CSV File Columns ...................................................................................................... G--4

necategory ...................................................................................................... G--4ne ................................................................................................................... G--4neaccess ........................................................................................................ G--7netype ............................................................................................................. G--8

WESTELL.COM

Page TOC-4

1-800-377-8766


netypeaccess ..................................................................................................G--9user ...............................................................................................................G--10protocol .........................................................................................................G--11alarm .............................................................................................................G--11alarmtranslation ............................................................................................G--11measurementtemplate ..................................................................................G--12signaldefinition ..............................................................................................G--13signalcategory ..............................................................................................G--15measurement ................................................................................................G--15

XML Import/Export Types .........................................................................................G--16Event Fix Actions Importer CSV Columns ................................................................G--17

Appendix H: Configuring LDAP User Authentication ...............................H-1Configuring LDAP User Authentication ...................................................................... H--2Creating the Initial User Account (Bootstrapping) ...................................................... H--3Authenticating Via a Simple User Bind ....................................................................... H--4Authenticating Via an Administration User Bind ......................................................... H--6Authenticating Users with MS Active Directory .......................................................... H--8Configuring Optima for LDAP Failover ..................................................................... H--11

Using LDAP DNS Aliases ............................................................................. H--11Using Designated LDAP Servers ................................................................. H--11

Authenticating Against LDAP Over SSL ................................................................... H--12

Appendix I: Event Information Fields, Event Types, and Alarms ............. I-1Event Information Window Fields .................................................................................I--2Kentrox Optima Server Monitor Events ........................................................................I--9Kentrox Remote Product Monitor Events ...................................................................I--10Kentrox Remote Default Analog Events .....................................................................I--11IP and Kentrox Device Alarms ...................................................................................I--12Optima Self-Monitoring Alarms ..................................................................................I--14

Optima System Monitoring .............................................................................I--14Optima Server Resource Monitoring ..............................................................I--15Optima UI to NBI Terminology Mapping .........................................................I--22

Glossary: ..................................................................................... Glossary 1

:Index .................................................................................................Index 1

WESTELL.COM

1-800-377-8766

Page TOC-5


WESTELL.COM

Page TOC-6

1-800-377-8766

PREFACE

Preface

About This Document

This document explains how to administer and operate Optima servers and how to administer Optima client machines. You should have a working knowledge of the following:

Red Hat Enterprise Linux

The PostgreSQL database

Oracle 11g

Table 1 summarizes the general content of the three Optima Management System documents, including the primary target audience and the primary tasks and menus that are covered in each document.

Page Preface-i

WESTELL.COM

Optima Version 11.5x System Administration GuidePreface: About This Document

Table 1 Optima Documentation Content Summary

Document/Part # Primary Target Audience Primary Tasks/Menus

Optima Management System User/Configuration Guide

Network Operators Primary tasks performed from the following Optima Management System menus: My Optima > My Profile Dashboards Map View Event View Report View Live View Optima Configuration > Event

Configuration > Event Filtering & Mediation

Optima Configuration > Event Configuration > Threshold Templates

Optima Management System User/Configuration Guide

Network Managers Primary tasks performed from the following Optima Management System Optima Configuration menu: Network Configuration Event Correlation Notification Rules Busy Hour Templates Measurement Templates Report Scheduling Time Templates Manage Users Job Scheduling System Preferences

Optima Management System Administration Guide

System Administrators Responsible for overall Optima server functions, including installation, system performance, hardware/software reconfiguration, system startup and shutdown, and backup and restoration of configuration data.Tasks are typically performed from a browser and various command lines, not from the Optima Management System.

WESTELL.COM

Page Preface-ii

1-800-377-8766

Optima Version 11.5x System Administration GuidePreface: Optima Users and Tasks

Optima Users and TasksWhile companies and local policies may vary, there are typically assumed to be three user types for the Optima product:

Network Operators. Network operators are the basic users of Optima. General tasks include using the Graphical User Interface (GUI) to monitor the network and view events in the form of dashboards, maps, event lists and reports. The tasks and supporting information for network operators are addressed in the Optima User/Configuration Guide.

Network Managers. Network managers typically use the Optima GUI to configure system parameters such as sites, network elements, reports, user accounts and notifications.The tasks and supporting information for network managers are addressed in the Optima User/Configuration Guide.

System Administrators. System administrators are typically responsible for overall administration of the Optima server functions, including installation, system performance, hardware/software reconfiguration, system startup and shutdown, and backup and restoration of configuration data. The tasks and supporting information for system administrators are addressed in this document (the Optima System Administration Guide).

WESTELL.COM

1-800-377-8766

Page Preface-iii

Optima Version 11.5x System Administration GuidePreface: Document Conventions

Document ConventionsTable 2 describes the text conventions used in this document.

Table 2 Document Conventions

Convention Meaning

Screen Text, Menu Items, System Prompts, Messages and Reports

This style indicates Westell’s Kentrox configuration screen text, menu items, system prompts, messages, and reports.

Static Command Text In a command statement, this style indicates text that should be entered exactly as shown at a command line.

Variable Command Text

In a command statement, this style indicates user-specified text.

... In a command statement, ellipses (...) signify that the preceding parameter can be repeated a number of times.

[ ][ | ]

In a command statement, square brackets indicate an optional parameter. Two or more parameters in square brackets with a vertical bar ( | ) between them indicate a choice of optional parameters.

{ | } In a command statement, two or more parameters in braces with a vertical bar ( | ) between them indicate a choice of required parameters.

Menus and Menu Commands

This style indicates menu and menu commands. An angle bracket ( > ) separates the menus from the submenus or menu commands. The right arrow also indicates the order in which you should click the menus, submenus, and menu commands.

Dialog Boxes, Tabs, Fields, Check Boxes, and Command Buttons

This style indicates dialog boxes, tabs, fields, check boxes, and command buttons.

Variable Field Text This style indicates variable information you type in a dialog box field.

KEYS Uppercase body text indicates keys on a keyboard, such as the TAB or ENTER keys. Keys used in combination are connected with a plus symbol (+).

WESTELL.COM

Page Preface-iv

1-800-377-8766

Optima Version 11.5x System Administration GuidePreface: Document Conventions

Labels This style designates physical components on Kentrox products such as jumpers, switches, and cable connectors.

Note:

Note messages emphasize or supplement important points of the main text.

Important: Important messages provide information that is essential to the completion of a task.

Tip:Tip messages provide information that assists users in operating equipment more effectively.

Table 2 Document Conventions (Continued)

Convention Meaning

WESTELL.COM

1-800-377-8766

Page Preface-v

Optima Version 11.5x System Administration GuidePreface: Customer Assistance

Customer AssistanceAll customers, partners, and resellers who have a valid Westell Support and Services Agreement have complete access to the technical support resources.

Pre-sales Support

Westell offers pre-sales technical support from 9 a.m. to 5 p.m. Eastern time, Monday - Friday. Representatives are standing by to assist with customer account information and product ordering and answer questions regarding Westell products and solutions.

Phone number: 800-377-8766, option 1

Before you call or email

Before you contact Westell for assistance, please have the following information available:

The versions of hardware and software you are currently running

The error number and exact wording of any messages that appeared on your screen

What happened and what you were doing when the problem occurred

How you tried to solve the problem

Email Technical Support

Email support is available. You may send email at any time during the day; however, responses will be provided only during normal business hours, in accordance with your Service and Support Agreement.

To contact Technical Support, send email to:

[email protected]

Telephone Technical Support

Available to qualified Westell customers or partners who have not been able to resolve their technical issue by using our online services. To qualify for support, you must have a valid Support and Services Agreement.

Phone number: 800-377-8766, option 2

Normal Business Hours: 8 a.m. to 6 p.m. Eastern time

After-Hours Support: Available to qualified customers who are experiencing service-affecting outages that cannot wait until the next business day. To qualify for after-

WESTELL.COM

Page Preface-vi

1-800-377-8766

mailto:[email protected]


hours support, you must have a valid 24x7 Support and Services Agreement. Call the number above, option 2, and follow the prompts for after-hours service.

Product DocumentationYou can also access and view the most current versions of Westell product documentation on our Web site at:

http://www.westell.com

WESTELL.COM

1-800-377-8766

Page Preface-vii

http://www.westell.com


WESTELL.COM

Page Preface-viii

1-800-377-8766

CHA

PTER 1

1

Product Overview

This chapter provides an overview of the Optima Management System software and features.

Guide to this Chapter

Overview of the Optima Management System

Features

Page 1-1

WESTELL.COM

Optima Version 11.5x System Administration GuideProduct Overview: Overview of the Optima Management System

Overview of the Optima Management SystemOptima Site Solutions provide mobile and fixed-line network operators with complete 360 degree views of and control over their network infrastructure sites.

BenefitsThe key benefits for companies utilizing Optima are to:

Gain operational efficiencies by remotely resolving issues

Implement one-time intelligent dispatches to reduce costly truck rolls

Improve site visibility with remote diagnosis and management

Adopt practices that reduce cost and improve mean time to repair (MTTR)

WESTELL.COM

Page 1-2

1-800-377-8766

Optima Version 11.5x System Administration GuideProduct Overview: Features

FeaturesOptima features can be grouped into the following general categories:

Event Management The event management feature captures and records all events at sites, providing the capability to:

View interrelationships between network and physical site elements (tower lights, door alarms, power systems)

View events displayed on dashboards, maps, Event Views, and reports

Set up notifications to alert parties when specific events occur (using, for example, email or SMS)

Performance ManagementThe performance management feature collects key performance indicators. These performance indicators allow you to create dashboards that illustrate overall network performance, as well as to correlate measurements from multiple network elements.

Element Management Element management provides status updates of network elements.

Remote Access Remote access provides access to network elements from anywhere using proprietary third party software or standard packages (Browser, Telnet, ProComm, Kentrox Redirect Profiles).

Site Data CollectionThis feature provides the capability to monitor, collect, and report site data. Reports can be executed on demand or scheduled.

WESTELL.COM

1-800-377-8766

Page 1-3

Optima Version 11.5x System Administration GuideProduct Overview: Features

WESTELL.COM

Page 1-4

1-800-377-8766

CHA

PTER 2

2

Installing and Upgrading Optima

This chapter provides information about installing Optima and upgrading to newer versions of Optima.


Performing a Fresh Optima Installation

Upgrading to Optima v11.x from Optima v9.00 or later versions

Upgrading to the latest version of Optima from Optima Versions Older Than v9.00

Installing Optima Patch Files

Adding and Editing Systems

Page 2-1

WESTELL.COM

Optima Version 11.5x System Administration GuideInstalling and Upgrading Optima: Performing a Fresh Optima Installation

Performing a Fresh Optima InstallationOptima is installed using the optimainstaller utility.The following sections describe how to install Optima on a server that meets the System and Hardware Requirements on page 4-4 and is running Red Hat Enterprise Linux 5.10.

Notes: See section Overview on page 4-2 for an explanation of OMS, DMC, and

standalone server functionality.

See section Using the Optima Network Check Utility on page 4-17 for more information about this utility.

Information needed before installation: Optima license file (obtain from Westell, as described in section Administering

Licenses on page 4-26)

Server ID

System name/names

IP or hostname for OMS

IP or hostname for DMC

SMTP server hostname

Installing a Standalone ServerTo install Optima on a single server that combines OMS and DMC functionality:

1. Log in as the root user.

2. Verify RHEL version using the following command:

# cat/etc/redhat-release3. If the Red Hat version is other than 5.10, install Kentrox Red Hat patches as

needed. See Appendix F: Red Hat Installation Tasks for installation details.

4. Execute the following commands to create directories on the server, then copy the installation files from the Optima distribution disks to the appropriate directories:

# mkdir /var/tmp/oms# mkdir /var/tmp/dmc# mkdir /var/tmp/tools# mkdir /var/tmp/platform

WESTELL.COM

Page 2-2

1-800-377-8766


5. Copy the installation files from the Optima distribution disks or transfer them using sftp to the appropriate directories.

6. Install Optima files by executing the following commands:

# cd /var/tmp# chmod +x optimainstaller# ./optimainstaller single

Tip: The JBOSS_CUSTOMER_NAME value is used in some email notifications and reports. This value can be added to the /etc/sysconfig/omsPrefs file when installation is complete. However, the user can specify it when running the optimainstaller utility by using the following syntax:

./optimainstaller --oms-customername=your_customername singleFor information about other available optimainstaller parameters, execute the following command:

./optimainstaller --helpWhen prompted, enter:

the dmc_name value for this DMC server

the hostname for an SMTP server (used for sending notification messages to users in response to events).

Note: Avoid using spaces in the DMC server name if possible. If the DMC server

name must contain spaces, enclose the value in double quotes.

Note: If optimainstaller fails, see section optimainstaller Troubleshooting on

page 2-11.

7. Install the Optima license file:

Save the license.properties.aes license file (obtained from Westell) to the following directory location:

/opt/oms/config/server 8. Execute the following commands to register the DMC:

# optimanetworkcheck -V# dmcregistrar -a -f dmc_name -i 127.0.0.1 -s system_mapwhere dmc_name is the same DMC server ID value specified in step 6, and system_map is one or more system names to map to the DMC. The first system

WESTELL.COM

1-800-377-8766

Page 2-3


listed is considered to be the default system for the DMC. In the following example, SYSTEM1 is the default system for the DMC server DMC1:# dmcregistrar -a -f DMC1 -i 127.0.0.1 -s SYSTEM1,SYSTEM2,SYSTEM3Important: Before the user runs the dmcregistrar utility, the user should plan

how many System NEs are necessary for their network and how these System NEs should be organized. The user should also be sure all these System NEs have been added to Optima. See section Adding and Editing Systems on page 2-18 for more information about hosting systems on Optima servers.

9. Verify the license value by viewing the Site Counts page (Optima Configuration >System Configuration > System Counts).

Installing Separate OMS and DMC Servers

Installing an OMSTo install a server with OMS functionality only:



# mkdir /var/tmp/oms# mkdir /var/tmp/tools# mkdir /var/tmp/platform


4. Install Optima files by executing the following commands. If the server is not active in DNS, specify the server’s IP address using the webhost parameter:# cd /var/tmp# chmod +x optimainstaller# ./optimainstaller oms [--oms-webhost=server_ip_address]If prompted, enter the hostname for an SMTP server (used for sending notification messages to users in response to events).


page 2-11.

5. Install the license file, as described in step 7 of the standalone server section. Then, enter:

WESTELL.COM

Page 2-4

1-800-377-8766


# optimanetworkcheck -V

Installing a DMC ServerTo install a server with DMC functionality only:



# mkdir /var/tmp/dmc# mkdir /var/tmp/tools# mkdir /var/tmp/platform


4. Install Optima files by executing the following commands:

# cd /var/tmp# chmod +x optimainstaller# ./optimainstaller dmcWhen prompted, enter:

the dmc_name value for this DMC server (if upgrading, this should be the dmcid value from Optima v9.x)

the IP address or hostname of the OMS

the IP address or hostname of the DMC server

Notes: Avoid using spaces in the DMC server name if possible. If the DMC

server name must contain spaces, enclose the value in double quotes.

If optimainstaller fails, see section optimainstaller Troubleshooting on page 2-11.

5. Execute the following commands to register the DMC:

# optimanetworkcheck -V# dmcregistrar -a -f dmc_name -i dmc_IP_address -s system_mapwhere dmc_name is the same DMC server ID value specified in step 4, and system_map is one or more system names to map to the DMC. The first system listed is considered to be the default system for the DMC. In the following example, SYSTEM1 is the default system for the DMC server DMC1:# dmcregistrar -a -f DMC1 -i 127.0.0.1 -s SYSTEM1,SYSTEM2,SYSTEM3

WESTELL.COM

1-800-377-8766

Page 2-5


Note: Before running the dmcregistrar utility, the user should plan how many

System NEs are necessary for their network and how these System NEs should be organized. The user should also be sure all these System NEs have been added to Optima. See section Adding and Editing Systems on page 2-18 for more information about hosting systems on Optima servers.

WESTELL.COM

Page 2-6

1-800-377-8766

Optima Version 11.5x System Administration GuideInstalling and Upgrading Optima: Upgrading to Optima v11.x from Optima v9.00 or later versions

Upgrading to Optima v11.x from Optima v9.00 or later versions

These sections describe how to upgrade an existing Optima implementation from version 9.00or later to version 11.x.

Before Starting

Installation MediaUpgrading Optima requires software containing Optima v11.x.

Backing Up DataIt is suggested that users back up data before upgrading. Verify that a valid backup file (from automated nightly backups) is available. If not, execute the following commands as root:

# optimabackup

Note: It is suggested that users back up the /etc/sysconfig/omsPrefs file, or at

least note the configuration values contained therein.

Noting the dmcid ValueNote the dmcid value, as defined in /opt/dmc/conf/dmcid implementation. the user may need to enter this value as the dmc_name value during the Optima installation.

Noting System Names and the DMC IP AddressLog into the Optima GUI and note the names of all systems being monitored by the DMC. In addition, note the IP address of the DMC (if applicable). Execute the following command to remember the DMC ID, DMC IP address, and all monitored systems:

# dmcregistrar -lSee section Adding and Editing Systems on page 2-18 for more information about hosting systems on Optima servers.

Verify RHEL versionExecute the following command:

# cat /etc/redhat-release

If the Red Hat version is other than 5.10, install Kentrox Red Hat patches as needed. See Appendix F: Red Hat Installation Tasks for installation details.

WESTELL.COM

1-800-377-8766

Page 2-7


Noting Adapters with Start-At-Bootup Capability EnabledIf adapters are running on the Optima server and the start-at-bootup option has been enabled, take note of those adapter names by executing the following command as root:

# grep optima-adapter /opt/daemonwatcher/config/daemonwatchercfg.xml

An example output of the previous command is:

In this example output, the actual adapter name is AcmeFaultAdapter and optima-adapter- is a prefix that is automatically added by Optima.

Upgrading a Standalone ServerTo upgrade a single server that combines OMS and DMC functionality from Optima version 9.00or later to version 11.x:


2. If required install the license file, as described in step 7 of the Standalone Server section.

3. Verify the network configuration for the server and Optima daemons:

# optimanetworkcheck -V

Note: See section Using the Optima Network Check Utility on page 4-17 for more information.

4. Execute the following command to shut down Optima processes:

# optimacontroller stop5. Execute the following commands to create directories on the server, then copy the

installation files (from disk or file transfer) to the appropriate directories:

# mkdir /var/upgrade# mkdir /var/upgrade/oms# mkdir /var/upgrade/dmc# mkdir /var/upgrade/tools# mkdir /var/upgrade/platform

6. Find any unregistered (AutoStart is turned off) adapters by executing the following command:

# adaptermanager -L7. (optional) Stop the unregistered adapters found in step 6 by executing the

following command:

WESTELL.COM

Page 2-8

1-800-377-8766


# /etc/init.d/optima-adapter-instance stop8. Upgrade Optima by executing the following commands:

# cd /var/upgrade# chmod +x optimainstaller# ./optimainstaller singleIf prompted, enter:

the dmc_name value for this DMC server

the hostname for an SMTP server (used for sending notification messages to users in response to events).


page 2-11.

9. Execute the following command to verify whether or not the DMC register information was lost during the upgrade:

# dmcregistrar –l

Upgrading an OMSTo upgrade an OMS from Optima v9.00or later to v11.x:


2. Execute steps 3 through 4 of the procedure Upgrading a Standalone Server on page 2-8.

3. Execute step 5 of the procedure Upgrading a Standalone Server on page 2-8, but omit the following command:

# mkdir /var/upgrade/dmc4. Upgrade Optima by executing the following commands. If the server is not active

in DNS, specify the server’s IP address using the webhost parameter:# cd /var/upgrade# chmod +x optimainstaller# ./optimainstaller oms [--oms-webhost=server_ip_address]If prompted, enter the hostname for an SMTP server (used for sending notification messages to users in response to events).


page 2-11.

5. Perform the steps described in section Post-Upgrade Tasks on page 2-12

WESTELL.COM

1-800-377-8766

Page 2-9


Upgrading a DMC ServerTo upgrade a DMC server from Optima v9.00or later to v11.x:


2. Execute step 3 and 4 of the procedure Upgrading a Standalone Server on page 2-8.

3. Execute step 5 of the procedure Upgrading a Standalone Server on page 2-8, but omit the following command:

# mkdir /var/upgrade/oms4. Upgrade Optima by executing the following commands:

# cd /var/upgrade# chmod +x optimainstaller# ./optimainstaller dmcIf prompted, enter:

the dmc_name value for this DMC server (if upgrading, this should be the value already assigned to this DMC)

the IP address or hostname of the OMS

the IP address or hostname of the DMC server

Note: Avoid using spaces in the DMC server name if possible. If the DMC server

name must contain spaces, enclose the value in double quotes.


page 2-11.

5. Execute the following command to verify whether or not the DMC register information was lost during the upgrade:

# dmcregistrar –l6. If the DMC register information was lost during the upgrade, execute the following

command to register the DMC:

dmcregistrar -a -f dmc_name -i dmc_IP_address -s system_mapwhere dmc_name is the same DMC server ID value specified in step 4, and system_map is one or more system names to map to the DMC. The first system listed is considered to be the default system for the DMC. In the following example, SYSTEM1 is the default system for the DMC server DMC1:# dmcregistrar -a -f DMC1 -i 127.0.0.1 -s SYSTEM1,SYSTEM2,SYSTEM3

WESTELL.COM

Page 2-10

1-800-377-8766


optimainstaller Troubleshooting

Optima Processes Failed to StopIf Optima processes failed to stop prior to running optimainstaller, this can cause the upgrade to fail. If this problem is suspected:

1. As root, execute the following command to confirm that all optima processes are stopped:

# ps -ef | grep optima2. If any processes are still running, kill them by executing the following command

for each process:

# kill -9 pid3. Run the installer again:

# ./optimainstaller [ single | oms | dmc ]

DNS or Hostname Problems (Fresh Installation)If optimainstaller fails during a fresh installation, the most likely cause is a DNS or hostname problem. Review /var/lib/OptimaDirector/logs for details, then:1. Move the file /etc/resolv.conf to /etc/resolv.conf.bak.2. Execute the following commands:

# optimacontroller start# su - optima$ /opt/oms/bin/prefirststart.sh$ /opt/oms/bin/serverredeploy$ exit# /opt/dmi/bin/postInstall# /opt/dmc/bin/postInstall

# optimacontroller restart

DNS or Hostname Problems (Upgrade)If the upgrade fails due to a DNS or hostname problem, or running out of disk space, the user may be able to solve the problem by editing /etc/resolv.conf, /opt/oracle/product/11.2.0/network/admin/tnsnames.ora, or /etc/hosts. The user can then finish the installation by restarting Optima services:

# optimacontroller startAfter Optima services have started, execute the following commands:

WESTELL.COM

1-800-377-8766

Page 2-11


# su - optima$ /opt/oms/bin/omsInstall 9.20$ exit# /opt/dmi/bin/postInstall# /opt/dmc/bin/postInstall# optimacontroller restart

Post-Upgrade TasksPerform the following tasks after upgrading Optima server(s) from version 9.00or later to version 11.x.

Editing system_configuration.propertiesEnable HTTPS for Google Maps by removing the pound sign (#) from the start of the https line of code and adding a pound sign to the start of the http line.When editing is complete in the system_configuration.properties file, execute the following command:

optimacontroller restart

Restoring omsPrefs ValuesCompare the parameters in /etc/sysconfig/omsPrefs to ensure they have not changed (particularly the JBOSS_EMAIL parameters). If the omsPrefs file is edited, execute the following commands to save changes:

su - optima -c '/opt/oms/install/install_config.ksh'exitoptimacontroller restart

Running Optima Network CheckAs the root user, execute optimanetworkcheck to set values in the /etc/optimanetworkcheck.conf file (see section Using the Optima Network Check Utility on page 4-17).

The following example configures the Ethernet interface eth0 with IP address 10.34.3.35, host name engsystest1, gateway 10.34.3.1, netmask 255.255.255.0, broadcast 10.34.3.255, and domain ai.aiinet.com:

# optimanetworkcheck -S -i eth0 -a 10.34.3.55 -n engsystest1 -g 10.34.3.1 -m 255.255.255.0 -b 10.34.3.255 -d ai.aiinet.comIf these values for this server are unknown, the user can obtain them by executing the following command:

WESTELL.COM

Page 2-12

1-800-377-8766


optimanetworkcheck -VIf this doesn’t return gateway information, the user can find this in the /etc/sysconfig/network file.

Restore Adapters with Start-At-Bootup Capability EnabledFor each adapter name that was noted in Noting Adapters with Start-At-Bootup Capability Enabled on page 2-8, execute the following two commands to toggle the state of this option. The first command will disable the start-at-bootup option and the second command will enable option.

# adaptermanager –a –n # adaptermanager –a –n

Clear Browser CachesAfter a new or updated version of Optima is installed. all Optima users should clear their browser cache to assure the best performance of the newly installed software.

WESTELL.COM

1-800-377-8766

Page 2-13

Optima Version 11.5x System Administration GuideInstalling and Upgrading Optima: Upgrading to the latest version of Optima from Optima Versions Older Than v9.00

Upgrading to the latest version of Optima from Optima Versions Older Than v9.00

Westell has a special optimainstaller utility for upgrading Optima versions older than version 9.00. For more information, contact Westell Technical Support. Refer to Customer Assistance.

WESTELL.COM

Page 2-14

1-800-377-8766

Optima Version 11.5x System Administration GuideInstalling and Upgrading Optima: Installing Optima Patch Files

Installing Optima Patch Files

To install an Optima patch1. Obtain patch file and release notes from Westell

2. Print and read release notes

3. Patch installation procedure (each patch will have specific installation requirements and steps based on these procedures; these are detailed in the release notes)

a. Copy the patch file to a new directory on the OMS server

b. Confirm from release notes under which user (root or optima) the installation should be run

c. Verify ownership & read/write permissions of the patch file using the command ls –al while in the new directory added in step a.

d. Revise the ownership & read/write permissions of the patch file as instructed by the release notes using the chown and chmod commands

e. Run the command md5sum –b * to verify the patch file check sum

Note: The release notes provide the correct value to compare to the results of

this command; if the results are different do not proceed as the patch file is corrupted. Delete it, obtain a new copy of the patch file, and restart the procedure)

f. Back up existing file or files as instructed in the release notes to a directory that is not under /opt/oms/lib or /opt/oms/kentroxlib; also avoid /tmp as a backup location

g. Stop Optima using the optimacontroller stop command

h. Overwrite files as instructed in the release notes using the cp –p file_name command

i. Start Optima using the optimacontroller start command

j. Verify update was successful using criteria provided in release notes

Optima patch release note example1. As Optima user, copy the included patch files to a new directory on the oms

server:

com.kentrox.director.optima.plugins.directorgui-11.1.0.zip

WESTELL.COM

1-800-377-8766

Page 2-15


kentrox-optima-presentation-11.10-optima1110b015.ear

2. Verify ownership & read/write permissions of patch files. Run "ls -al" (without the quotes)

a. The owner of both files should be optima:dba. If it is not, run the following:

chown optima:dba

com.kentrox.director.optima.plugins.directorgui-11.1.0.zipchown optima:dba kentrox-optima-presentation-11.10-optima1110b015.ear

b. The permissions should be -rw-r--r-- for com.kentrox.director.optima.plugins.directorgui-11.1.0.zip. If they are not, run:

chmod 644 com.kentrox.director.optima.plugins.directorgui-11.1.0.zip

c. The permissions should be -rw-rw-r-- for kentrox-optima-presentation-11.10-optima1110b015.ear. If they are not, run:

chmod 664 kentrox-optima-presentation-11.10-optima1110b015.ear

3. From that directory, run "md5sum -b *" (without quotes)The result should be:

64ebffa32ba87cf48405b9a168d7212e *com.kentrox.director.optima.plugins.directorgui-11.1.0.zip

01ce4bf85382fc43561bb8f23bb9bb59 *kentrox-optima-presentation-11.10-optima1110b015.ear

If the result differ for any of the files, DO NOT proceed with the install, because the patch file is corrupted.

4. Back up the following files to a backup directory that is *not* under /opt/oms/lib or /opt/oms/kentroxlib. Also avoid /tmp as the backup location.

/opt/oms/plugins/com.kentrox.director.optima.plugins.directorgui-11.1.0.zip

/opt/oms/lib/kentrox-optima-presentation-11.10-optima1110b015.ear

WESTELL.COM

Page 2-16

1-800-377-8766


5. As root user, stop all of Optima

# optimacontroller stop

6. In the patch directory created in step 1:

Overwrite the existing files with the file from the patch:

cp -p com.kentrox.director.optima.plugins.directorgui-11.1.0.zip /opt/oms/plugins/com.kentrox.director.optima.plugins.directorgui-11.1.0.zip

cp -p kentrox-optima-presentation-11.10-optima1110b015.ear /opt/oms/lib/kentrox-optima-presentation-11.10-optima1110b015.ear

7. As root user, start Optima:

# optimacontroller start

8. After all of Optima has started, do a quick test of the GUI to verify that the patches were applied correctly.

Note: Web browser cache may need cleared.)

a. Go to Event View, right click an Event, and select 'Open NE Tree to Source NE'. The NE Tree should expand to the source NE for the event.

b. Find a Remote in the NE Tree, right click -> View NE Details, and make sure Parent field near the bottom has the correct value, and that all tabs load properly.

WESTELL.COM

1-800-377-8766

Page 2-17

Optima Version 11.5x System Administration GuideInstalling and Upgrading Optima: Adding and Editing Systems

Adding and Editing SystemsNetwork elements of type System are the highest level in the visible hierarchy. By default, there are at least two Systems in an Optima implementation: the Optima Server System (named) and the Entire Network. The user should rename Entire Network to something more meaningful to their network, and add more System NEs to organize the network.

Optima Data and Management Collection (DMC) servers are automatically created as System NEs under the Optima Management Server (OMS). Customers cannot edit these DMC System NEs.

Before running the dmcregistrar utility, it is important that the user decide what System NEs are necessary for their network and how these System NEs should be organized. For example, if an Optima implementation involves one standalone server combining OMS and DMC functionality, the user might be able to organize all the regions and sites under one System NE. If the Optima implementation involves an OMS server and multiple DMC servers, the user will host one or more System NEs on each DMC server.

Keep in mind the following three considerations relating to System NE behavior:

1. When individual user accounts are created, they are explicitly granted or denied access to each System NE, and therefore to all subtended Region, Site, and Data Collection Device NEs.

2. A System and all its subtended NEs must reside on the same DMC server. A DMC may host more than one System NE; however, a System NE cannot reside on more than one DMC.

3. Users can view all System NEs in the Optima Navigation Tree. System NEs appear as the top-level NE in the NE Tree hierarchy.

Note: System NEs are assigned the NE category WSystem. This is helpful to

remember when searching for System NEs, or when creating a new System NE.

If a System NE is hosted on one Optima server and the user wants it to be hosted on a different DMC server, the user can use the dmcregistrar utility to move an entire System and its contents. If the user needs to move any other NEs from one System to another System on a different DMC, then any regions, sites and/or NEs under the original System NE must be recreated under the System NE on the new server. It is possible to use the Inventory Importer/Exporter to move NEs from the old server to the new one; however, these NEs still must be reconfigured in the Optima GUI to have the correct parent/child relationships.

WESTELL.COM

Page 2-18

1-800-377-8766

CHA

PTER 3

3

Optima Client

Westell’s Kentrox Redirect provides Optima client functionality. This chapter provides system requirements and installation information for Redirect.


System Requirements

Installing and Uninstalling Redirect

Page 3-1

WESTELL.COM

Optima Version 11.5x System Administration GuideOptima Client: System Requirements

System RequirementsKentrox Redirect provides Optima client functionality for serial-to-IP remote access. Any customers originally using AIredirect should upgrade to Kentrox Redirect, which provides Optima client functionality.

Redirect requires the following system components:

System Component Minimum Requirements

Operating System Windows XP or Vista

Platform Java 2 Runtime Environment 1.6.x Adobe Flash Player 10 Microsoft Internet Explorer 8.0 A working Internet connection to www.google.com (to

support Map View)

WESTELL.COM

Page 3-2

1-800-377-8766

Optima Version 11.5x System Administration GuideOptima Client: Installing and Uninstalling Redirect

Installing and Uninstalling Redirect

Installing RedirectTo install Redirect:

1. Open Redirect distribution media in a file browser.

2. Locate the setup.exe file, then double-click to launch it. The InstallShield wizard guides you through the installation process.

Notes: A Redirect shortcut icon will appear on your desktop for starting the client.

Uninstalling RedirectTo uninstall Redirect:

1. Open the Control Panel (click Start > Settings > Control Panel).

2. Double-click Add/Remove Programs.

3. In the list of currently installed programs, select Optima.

4. Click Remove. The InstallShield wizard guides you through the rest of the uninstallation process.

WESTELL.COM

1-800-377-8766

Page 3-3

Optima Version 11.5x System Administration GuideOptima Client: Installing and Uninstalling Redirect

WESTELL.COM

Page 3-4

1-800-377-8766

CHA

PTER 4

4

Optima Server

This chapter explains system requirements and administrative tasks pertaining to the Optima server.


Overview

System and Hardware Requirements

Executing Linux Commands

Initial Setup Administrative Tasks

Ongoing Administrative Tasks

Process Monitoring

Page 4-1

WESTELL.COM

Optima Version 11.5x System Administration GuideOptima Server: Overview

OverviewThe Optima server is the interface between the Optima client and the monitored network elements. The server performs database queries and creates responses containing data from the query results.

Figure 4-1 Optima Servers

There is only one Optima Management Server (OMS) in an Optima network. There can be one or more Data & Measurement Collector (DMC) servers, depending on the size of the network. Smaller networks may combine OMS and DMC functionality on the same “standalone” server.

WESTELL.COM

Page 4-2

1-800-377-8766

Optima Version 11.5x System Administration GuideOptima Server: Overview

Optima Management Server (OMS)The OMS interfaces with clients. It does not interface directly with monitored devices. It maintains a database of performance/fault data, signal data, and event data (forwarded from the DMC) for all monitored devices in the network. It also maintains some databases containing element configuration data. Finally, the OMS maintains an “element inventory” database containing an inventory of element configuration information for all monitored devices in the network.

Data & Measurement Collector (DMC)The DMC servers interface with monitored devices. Each DMC maintains databases containing port status, IP status (SNMP and ICMP), file backups, and restore points for the devices it monitors.

Note: For more information on restore points, see the Optima User/Configuration

Guide.

Each DMC server also maintains a “shadow element inventory” database, containing an inventory of element configuration information only for those devices it monitors (not for all devices in the network as the OMS “element inventory” database does).

WESTELL.COM

1-800-377-8766

Page 4-3

Optima Version 11.5x System Administration GuideOptima Server: System and Hardware Requirements

System and Hardware RequirementsWestell supports Optima using the Dell servers specified below. They can be purchased through Westell or directly from Dell.

Server SizeWestell recommends the following Dell PowerEdge R730 servers for these respective network sizes:

Hardware Specifications for OMS Servers

Westell Part Number

# of Sites (max) OMS Server DMC Server

750 DELLSVR-MA

751-2500 DELLSVR-MA DELLSVR-MA

System Components Minimum Requirements

Base Unit Intel Xeon E5-2630 v3, 2.4GHz, 20M cache, 8.00GT/s QPI, Turbo, HT, 8C/16T (85W) Max Mem 1866MHz

Memory Two 16GB RDIMM, 2133 MT/s, Dual Rank, x4 Data Width

Hard Drives Five 600GB 10K RPM SAS 6Gbps 2.5-in.Hot-plug Hard Drives, 13G

Backup File Storage Optima requires a storage location for backup files. Requirements are NFS-mounted storage with 1000 Mbps ethernet connection and 4TB of storage capacity. Westell offers an optional Netgear ReadyNAS Network Access Storage device to meet this requirement.

Previous Optima systems have included the Dell PowerVault RD1000 for storage. This system offers storage up to 500GB, which is adequate for small to medium Optima deployments.

NIC Broadcom® 5720 QP 1Gb Network Daughter Card

Remote Access iDRAC8 Enterprise integrated Dell Remote Access Controller

Optical Drive DVD-ROM, SATA, Internal

RAID RAID 0 for H330/H730/H730P (1-16 HDDs or SSDs)

Power Dual, Hot-plug, redundant power supply (1+1), 495W

WESTELL.COM

Page 4-4

1-800-377-8766

Optima Version 11.5x System Administration GuideOptima Server: System and Hardware Requirements

Hardware Specifications for DMC Servers

System Components Minimum Requirements

Base Unit Intel Xeon E5-2630 v3, 2.4GHz, 20M cache, 8.00GT/s QPI, Turbo, HT, 8C/16T (85W) Max Mem 1866MHz

Memory 16GB RDIMM, 2133 MT/s, Dual Rank, x4 Data Width

Hard Drives 600GB 10K RPM SAS 6Gbps 2.5-in.Hot-plug Hard Drive, 13G

NIC Broadcom® 5720 QP 1Gb Network Daughter Card

Remote Access iDRAC8 Enterprise integrated Dell Remote Access Controller

DVD-ROM Drive DVD-ROM, SATA, Internal

RAID RAID 0 for H330/H730/H730P (1-16 HDDs or SSDs)

Power Dual, Hot-plug, redundant power supply (1+1), 495W

WESTELL.COM

1-800-377-8766

Page 4-5

Optima Version 11.5x System Administration GuideOptima Server: Executing Linux Commands

Executing Linux CommandsInstalling and administering the Optima server requires you to open the Red Hat terminal command line interface, from which you can execute Linux commands.

There are two ways to open the terminal CLI:

Click Applications > Accessories > Terminal

Right-click the desktop, then click Open Terminal from the context menu

Note: You must open a terminal CLI any time it is necessary to enter Linux

commands.

WESTELL.COM

Page 4-6

1-800-377-8766

Optima Version 11.5x System Administration GuideOptima Server: Initial Setup Administrative Tasks

Initial Setup Administrative TasksDepending on your implementation, several tasks may require completion when you set up an Optima server for the first time. These tasks include:

Changing the PostgreSQL Password

Configuring the System Clock

Configuring the Map View

Setting Up Optima in a Firewalled Environment

DMC Registration

Configuring the User Session Inactivity Timer

Changing the PostgreSQL PasswordWhen it is first installed, Optima uses a standard generic password for the PostgreSQL database. To ensure security, you may wish to change the default password on both the OMS and DMC servers.

To change the PostgreSQL password:

1. Stop all Optima daemons:

# /usr/sbin/optimacontroller stop2. As root, log into PostgreSQL using the original password oldpassword:

# psql AIdirector dirserverPassword: oldpassword

3. At the Optima prompt, change the password from oldpassword to newpassword:

alter user dirserver with password ‘newpassword’;4. Log out of PostgreSQL:

\q5. As root, run the dbconfig utility:

# /usr/bin/dbconfig6. Enter the default username:

dirserver7. Enter the password for the default username.

8. Re-enter the password to confirm that it is correct. Optima restarts. The PostgreSQL password has been changed.

WESTELL.COM

1-800-377-8766

Page 4-7


Configuring the System ClockThe system clock should be configured with an NTP server by default. If an NTP server was not provided for initial installation, you can enable NTP using the following steps:

1. Ensure that NTP is available to run by executing the following command:

# /sbin/chkconfig --add ntpd2. Open the /etc/ntp.conf file.3. Edit the /etc/ntp.conf file to match the following:

#set the server and fudge options:server time.nist.govfudge time.nist.gov stratum 10#enable multicastclientmulticastclient # listen on default 224.0.1.1

4. Start the NTP service:

# service ntpd start

Note: Be sure your system clock is accurate. System clock inaccuracies can cause strange reports and event timestamps. Execute the date command to check your current system clock settings.

Configuring the Map ViewThe Map View is available by clicking Map View in the Optima menu bar. For more information about using the map in the Optima Management System, see chapter Using the Map View in the Optima User/Configuration Guide.

You can configure map parameters such as the default map location and zoom threshold by editing the appropriate code in the system_configuration.properties file, which is located in the opt/oms/config/AFrame directory. A sample system_configuration.properties map configuration is shown below. See Table 4-1 on page 4-9 for an explanation of the parameters.

global.map.zoom-threshold=10global.map.locations.1.label=Hazlet - NJglobal.map.locations.1.lat=40.427439global.map.locations.1.lng=-74.18136global.map.locations.1.mapType=G_NORMAL_MAPglobal.map.locations.1.zoom=9

WESTELL.COM

Page 4-8

1-800-377-8766


After you have edited map parameters, restart all server processes:

optimacontroller restart

Table 4-1 Map Configuration Parameters

Parameter Description

global.map.zoom-threshold Specifies the zoom level at which the Map View switches from displaying sites (Figure 4-2 on page 4-10) to displaying clusters (Figure 4-3 on page 4-10) when the user zooms out. Valid values are 0 (maximum zoom-out) to 19 (maximum zoom-in).

global.map.locations.1 Specifies the default location that appears in the Locations list on the Map View Map Options tab. Users can add more locations by adding them as map favorites, as described in the Optima User’s Guide and in the Online Help.

global.map.locations.1.label Specifies a name for the default location. In the example shown above, the default location is labeled Hazlet - NJ.

global.map.locations.1.lat Specifies the GPS latitude coordinate for the default location. Valid values are -90 to 90.

global.map.locations.1.lng Specifies the GPS longitude coordinate for the default location. Valid values are -180 to 180.

global.map.locations.1.mapType Specifies the map type as one of the following: normal (G_NORMAL_MAP) satellite (G_SATELLITE_MAP) hybrid (G_HYBRID_MAP)

global.map.locations.1.zoom Specifies the zoom level when location x is selected. Valid values are 0 to 19.

WESTELL.COM

1-800-377-8766

Page 4-9


Figure 4-2 Map View (Site Display Mode)

Figure 4-3 Map View (Region Display Mode)

WESTELL.COM

Page 4-10

1-800-377-8766


Setting Up Optima in a Firewalled EnvironmentTo use Optima in a firewalled environment, open the following ports:

Port 80 (the Web server port)

Port 443 (the secure HTTP port)

Port 1521 (the ODBC port)

Open Database Connectivity (ODBC) AccessODBC is an application programming interface (API) supported by Optima and its Oracle database system. To use the ODBC interface, you must have ODBC client software installed on your Optima client PC, and your IP network must have port 1521 open. If you need to design an ODBC application that leverages Optima’s collected data, contact Westell Professional Services.

DMC RegistrationBeginning with Optima version 8.0x, DMC servers are registered with the OMS by the use of two utilities: dmcregistrar and dmcsystemmanager.DMC registration:

registers the DMC’s IP address and faultname with the OMS

creates a DMC Server element to represent events

maps Systems to a DMC (see section b. Find a Remote in the NE Tree, right click -> View NE Details, and make sure Parent field near the bottom has the correct value, and that all tabs load properly. on page 2-17)

adds the DMC to the status poller, which begins ICMP monitoring

dmcregistrarThe dmcregistrar utility is available on a standalone server (OMS and DMC combined) or on a dedicated DMC.

To run the dmcregistrar utility, enter the following command as root:# dmcregistrar [options]Optional arguments, or flags, for the dmcregistrar utility are explained in Table 4-2 below.

Table 4-2 Optional dmcregistrar and dmcsystemmanager Arguments

Argument Description

-h Prints a help message with usage statement and examples.

WESTELL.COM

1-800-377-8766

Page 4-11


dmcsystemmanagerThe dmcsystemmanager utility is available only on the OMS. Its functionality and usage are similar to dmcregistrar with one exception: the -a argument is not available, so dmcsystemmanager cannot be used to add DMC system mapping.To run the dmcsystemmanager utility, enter the following command as root:# dmcsystemmanager [options]Optional arguments, or flags, for the dmcsystemmanager utility are explained in Table 4-2 above.

-l Lists all DMCs and their system mappings.-x Displays list output as raw XML. Requires -l.-a Adds DMC system mapping. Requires -i, -f, and -s.

Not available for dmcsystemmanager.

-u Updates a DMC system mapping (when used with -s) or IP address (when used with -i). Requires -f.

-r Removes DMC system mapping. Requires -f.-i ip_address Specifies the IP address of the DMC, which will be used

by the OMS for status polling.

-f dmc_name Identifies the DMC to add, remove, or update.-n Enables registration without verifying that the IP

address is either reachable by the OMS, or assigned to an interface on the DMC. This flag is intended for use with DMCs that are connected via Network Address Translation (NAT) from the OMS.

-s system_map Specifies a comma-separated list of system names to map to the DMC (for example, SYSTEM1,SYSTEM2,SYSTEM3). The first system listed is considered to be the default system for the DMC.

Table 4-2 Optional dmcregistrar and dmcsystemmanager Arguments (Continued)


WESTELL.COM

Page 4-12

1-800-377-8766


Configuring the User Session Inactivity TimerUse Optima’s user session inactivity timer to automatically log users off an Optima session after a period of inactivity. To configure the user session inactivity timer:

1. In the /opt/oms/config/AFrame/system_configuration.properties file, set property global.idleSessionTimeout to one of the following values: Any integer 2 to 20 to specify the number of minutes Optima will wait before

logging off users from an Optima session due to inactivity.

0 to disable the user session inactivity timer. When the inactivity timer is disabled, user sessions will not expire unless the user logs out.

Note: It is not recommended that the user session inactivity timer be configured

for 1 minute. This time period is too short and will interfere with Optima’s attempts to check the period of inactivity for a user.

2. Execute the following command as the root user:

optimacontroller restart oms-serverd

Note: The user session inactivity timer is a system-wide setting, and it applies to all

Optima users, except those in the NOCEnvironment user group. Users in the NOCEnvironment group are never logged off Optima.

Configuring Default and Maximum Maintenance Mode DurationOptima’s Schedule NE Maintenance feature comes with factory default settings for a seven-day maintenance mode duration, as shown in Figure 4-4, and a maximum maintenance mode duration of 30 days. These defaults can be adjusted.

Figure 4-4 Schedule Maintenance dialog duration settings

Durationsetting

Factory defaultmaximumduration is 30 days

Factory defaultsetting is7 days

WESTELL.COM

1-800-377-8766

Page 4-13


To change the default duration:

In the /opt/oms/config/AFrame/system_configuration.properties file, set property global.ne_maintenance_window_default_duration to the desired number of days.

This example sets the default duration at 45 days:

global.ne_maintenance_window_default_duration=45To change the default maximum duration:

In the /opt/oms/config/AFrame/system_configuration.properties file, set property global.ne_maintenance_window_max_duration to the desired number of days.

This example sets the maximum duration at 180 days:

global.ne_maintenance_window_max_duration=180

WESTELL.COM

Page 4-14

1-800-377-8766

Optima Version 11.5x System Administration GuideOptima Server: Ongoing Administrative Tasks

Ongoing Administrative TasksSeveral tasks may require completion as part of the ongoing administration of your Optima servers. These tasks include:

Starting and Stopping the Optima Service

Troubleshooting Using the RHEL Service Configuration Window

Configuring Logging Options

Using the Optima Network Check Utility

Using the Snapshot Utility

Accessing Logging Files

Backup and Restore

Inventory Importer and Exporter

Event Fix Actions Importer

Editing the IP Address and/or Hostname

Administering Licenses

Administering Permissions

Configuring Email Notifications

Adjusting Data Retention Intervals

Adjusting the Memory Limit for Reports

Starting and Stopping the Optima ServiceThe Optima service consists of several daemon processes. They are automatically stopped when the server machine is shut down, and automatically started when the server machine is rebooted. You can manually start and stop Optima services by using the optimacontroller utility. Enter this command as the root user to start, stop, or restart all services:

# /usr/sbin/optimacontroller [start | stop | restart]You can check the status of all Optima services by executing the following command as the root user:

# /usr/sbin/optimacontroller status

WESTELL.COM

1-800-377-8766

Page 4-15


The optimacontroller utility also can be used to start, stop, restart, and check status of individual services. For more information, including a list of individual services, enter:

# /usr/sbin/optimacontroller --help

Note: During server startup, it may take a significant amount of time before all services are available, especially if your Optima implementation involves many sites and monitored NEs. If you log into the Optima GUI during this time and query for status of an NE, you may encounter a Server Error message. Should you encounter this error shortly after starting an Optima server, wait several minutes, then try your query again.

Troubleshooting Using the RHEL Service Configuration WindowIn addition to entering commands at a shell prompt, you also can start, restart, stop, and check status of the Optima services and daemon processes by using the Service Configuration dialog within Red Hat Enterprise Linux on the OMS or DMC server.

To open the Service Configuration dialog, click System > Administration > Server Settings > Services.

Configuring Logging OptionsOptima includes the following loggable subsystems, called extensions:

com.aiinet.director.ext.alarmtablecom.aiinet.director.ext.conncom.aiinet.director.ext.emscom.aiinet.director.ext.filemanagercom.aiinet.director.ext.monitorcom.kentrox.director.ext.collectorcom.kentrox.director.ext.configservicecom.kentrox.director.ext.sigmeas

To activate logging and set the logging level for a specific subsystem, add to the end of the file com.aiinet.director.ext or com.kentrox.director.ext:

com.{aiinet | kentrox}.director.ext.extension_name.level=[WARNING|INFO|FINE|FINER|FINEST]

For example, to set logging for the monitor extension to FINE, for the connectivity (conn) extension to FINEST, and the sigmeas extension to FINER, add the following code to the end of the file:

com.aiinet.director.ext.monitor.level=FINEcom.aiinet.director.ext.conn.level=FINEST

WESTELL.COM

Page 4-16

1-800-377-8766


com.kentrox.director.ext.sigmaes.level=FINER

Using the Optima Network Check UtilityThe optimanetworkcheck utility (located in /usr/sbin/) is used to verify and/or update network-related configuration, including:

the IP address for a specified interface, including bonding interfaces

network configuration (gateway, broadcast, netmask

Hostname information

Oracle configuration

Optima’s external host (if applicable), including NAT support

Optima’s SSL certificate

DNS server information

Optima Network Check is run automatically every time optimacontroller is executed. It can be run manually by executing the following command as root:

# /usr/sbin/optimanetworkcheckThere are many optional arguments you can use for configuring network-related parameters. To view these arguments and an example, execute the following command:

# /usr/sbin/optimanetworkcheck -h

Using the Snapshot UtilityThe optimadiagsnapshot utility takes a snapshot of your Optima system’s configuration settings and provides the result in a .tgz file for your review. If you specify the -l option, the current values of several log files will be included in the .tgz file. To take a snapshot, execute the following command as root:

# /usr/sbin/optimadiagsnapshot [ -l ]By default, the .tgz file is saved to the /var/lib/optima/snapshots directory.

Accessing Logging FilesTable 4-3 on page 4-18 lists logging files that you may find useful when troubleshooting Optima servers.

Logging configuration files can be found in the following locations:

/opt/dmi/conf/logging.properties/opt/dmc/conf/logging.properties

WESTELL.COM

1-800-377-8766

Page 4-17


User Audit LoggingThe user audit log (found at /var/log/oms/auditlog.csv) logs the following user activities:

User logs in, logs out, or the session expires

User creates, edits, or deletes an NE, NE type, NE category, NE group, user account, measurement template, signal definition, or report

User creates, edits, or deletes attributes, including NE connectivity data, protocols, alarm translations, or measurement translations

User applies a signal via Product Configurator

User downloads a Remote configuration

User schedules a job

User clears or acknowledges all alarms (Clear All, Ack All)

User manages or unmanages services

User launches an application via Optima

Table 4-3 Commonly-Used Logging Files

Log Location Log Description

/var/log/oms/auditlog.csv Tracks user activity. See User Audit Logging.

/var/log/oms/server/inventory.log Maintains system inventory.

/var/log/oms/server/guierror.log Tracks GUI-related errors. For example, if a user encounters an “Internal Server Error” page while using the Optima Management System, an error is logged here.

/var/log/oms/server/error.log Tracks all errors from the application server process.

/var/log/oms/fault/flowcontrol.log Logs the activity of the event storm protection subsystem.

/var/log/dmi/serverDiag0.log Logging for the code in the dmi Httpd daemon.

/var/log/dmc/serverDiag0.log Logging for the code in the dmc Httpd daemon.

WESTELL.COM

Page 4-18

1-800-377-8766


User changes the state of a site

The log file is a comma-separated file (.csv), so it can be opened with a spreadsheet program such as Microsoft Excel. Log entries take the following format:

SortableTime,ReadableTime,SomeUserName,SomeActionName,SomeObjectOfTheAction,SomeDescriptionOfTheAction

The following is an example log entry:

20100719164911,2010-07-19 16:49:11,admin,Logged In,Optima System,The admin user logged in to the Optima GUI

Backup and RestoreOptima provides the optimabackup and optimarestore scripts to back up and restore the OMS and dmi server databases and configurations. The optimabackup script saves a snapshot of Optima configuration data. You use optional arguments to specify whether to back up all data, or a subset of available data. The optimarestore script overwrites the existing configuration with backup data. It accepts optional flags as well, allowing you to specify whether to perform a total or partial restoration.

For customers that do not have an offline backup location, Westell offers an optional NetGear ReadyNAS 2100 drive to store system backups offline from the primary disk storage. See appendix Configuring a Removable Direct Access Storage Device on page A-1 for information on configuring this drive if it is not already configured from the factory.

Notes: The optimarestore script cannot restore data from older versions of

Optima. You must run optimarestore on files from the same Optima version used by optimabackup. Therefore, optimabackup and optimarestore cannot be used to migrate from an older version of Optima to a newer version.

The $OPTIMA_BACKUP_DEST location is specified in the /etc/sysconfig/oms file, and can be overridden by adding OPTIMA_BACKUP_DEST= to the /etc/sysconfig/omsPrefs file.

The files /etc/sysconfig/oms, /etc/sysconfig/dmi, and /etc/sysconfig/dmc should not be modified directly. Instead, the env variables contained in those config files can be overwritten by changing the corresponding file: /etc/sysconfig/omsPrefs, /etc/sysconfig/dmiPrefs, and /etc/sysconfig/dmcPrefs.

Running the Backup ScriptTo run the backup script, enter the following command as root:

# /usr/sbin/optimabackup [options]

WESTELL.COM

1-800-377-8766

Page 4-19


Optional arguments, or flags, for the optimabackup utility are explained in Table 4-4.

Daily BackupThere is a symlink under the etc/cron.daily directory to /usr/sbin/optimabackup that causes an automatic backup of all the OMS and DMI data on a daily basis. By default, the backup runs at 4:02 a.m. daily. This can be changed by modifying the etc/cron.daily entry in the etc/crontab file.

Running the Restore Script Without Disk Growth Using ASMTo run the restore script, enter the following command as root:

# /usr/sbin/optimarestoreTo display help, enter -h 1. Execute the following command to stop Optima processes:

# optimacontroller stop2. Execute the following commands to start postgress processes:

# optimacontroller start optima-postgresgl3. Run the restore script:

# optimarestore4. Execute the following command to restart Optima processes:

# optimacontroller restart

Inventory Importer and ExporterOptima includes an Inventory Exporter/Importer tool to simplify the task of exporting data from an Optima implementation into a database, and importing that data into another Optima implementation.

Table 4-4 Optional optimabackup Arguments


-h Prints a help message.-incremental If set, the database backup will be incremental. If not

set, the system will automatically perform a full backup on Sunday (can change the day by redefining OPTIMA_DB_BACKUP_LEVEL0_DAY in /etc/sysconfig/omsPrefs) and an incremental backup on all other da

Documents

Optima Management System System Administration Guide ...support.westell.com/documents/user-guide/Opt115_SysAdmin.pdfWESTELL.COM Page TOC-4 Optima Version 11.2x System Administration