Paradyne OpenLane SLM 5.5 Manual do Utilizador

OpenLane® SLM 5.5Administrator’s GuideDocument No. 7800-A2-GB32-00January 2002

1. Introduction to OpenLane SLM1-2 January 2002 7800-A2-GB32-00OpenLane FeaturesEasy-to-use Web browser-based user interfaceSupport for the full arra

A. OLCmd ReferenceA-30 January 2002 7800-A2-GB32-00OLCmd unassigndevThe unassigndev command removes devices from a customer record.Format:OLCmd unass

A. OLCmd Reference7800-A2-GB32-00 January 2002A-31OLCmd viewlogThe viewlog command displays selected records from a log file.Format:OLCmd viewlog [-l]

A. OLCmd ReferenceA-32 January 2002 7800-A2-GB32-00Example:The following command displays fatal and internal messages collected in the UHReader log f

A. OLCmd Reference7800-A2-GB32-00 January 2002A-33OLCmd xmlreportThe xmlreport command generates OpenLane reports based on eXtensible Markup Language

A. OLCmd ReferenceA-34 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 2002B-1BUsing XML to Produce ReportsXML ReportsOpenLane’s eXtensible Markup Language (XML) reporting capability allows reports

B. Using XML to Produce ReportsB-2 January 2002 7800-A2-GB32-00Servlet Interface (SlvXmlServlet)The XML report servlet can be found at:/opt/pdn/OpenL

B. Using XML to Produce Reports7800-A2-GB32-00 January 2002B-3XML and XSL ExamplesThe XML format of the report requests and the report outputs are doc

B. Using XML to Produce ReportsB-4 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 2002IN-1IndexAaccess authentication, 5-1access levels, 6-5accessingOpenLane applications, 6-1activatingfirmware, 8-4adding

7800-A2-GB32-00 January 20022-12Installing OpenLane on SolarisAbout These InstructionsThese instructions provide you with the necessary information to

IndexIN-2January 2002 7800-A2-GB32-00EexamplesXML and XSL, B-3Ffirmwarebuilding library, 8-1downloading and activating, 8-4library backup, 7-2freq

Index7800-A2-GB32-00 January 2002IN-3OOLCmd, A-1addcust, A-3chgrawfileext, A-5–A-6, A-30confauth, A-8dbage, 7-5, A-9dbconfig, A-10dbcopy, A-12d

IndexIN-4January 2002 7800-A2-GB32-00stoppingOpenLaneSolaris, 2-10Windows, 3-10sync, A-27TTCPchanging port, 3-11ports used, 3-2UUHReaderstarting

2. Installing OpenLane on Solaris2-2 January 2002 7800-A2-GB32-00Installation RequirementsReview the following Minimum Hardware Requirements and Soft

2. Installing OpenLane on Solaris7800-A2-GB32-00 January 20022-3Checking the Java Runtime Environment VersionBefore installing the OpenLane Service Le

2. Installing OpenLane on Solaris2-4 January 2002 7800-A2-GB32-00Upgrading from Earlier SoftwareIf you are installing OpenLane on a system that is cu

2. Installing OpenLane on Solaris7800-A2-GB32-00 January 20022-5The OpenLane Installation ProgramTo install OpenLane and the Apache Web server, execut

2. Installing OpenLane on Solaris2-6 January 2002 7800-A2-GB32-00NOTES:— You do not have to install the Apache Web server in /opt/apache and OpenLane

2. Installing OpenLane on Solaris7800-A2-GB32-00 January 20022-7Installing from CD-ROMProcedure1. Log on to the system as root.2. Exit your Web browse

2. Installing OpenLane on Solaris2-8 January 2002 7800-A2-GB32-00Installing Remotely Using XYou can install OpenLane from a remote host using the X W

2. Installing OpenLane on Solaris7800-A2-GB32-00 January 20022-9Locating the License Key On an Installed SystemTo locate the license key on the system

A January 2002 7800-A2-GB32-00Copyright © 2002 Paradyne Corporation.All rights reserved.Printed in U.S.A.NoticeThis publication is protected by federa

2. Installing OpenLane on Solaris2-10 January 2002 7800-A2-GB32-00Starting OpenLane Web and Database ServicesProcedure1. From a terminal window, chan

2. Installing OpenLane on Solaris7800-A2-GB32-00 January 20022-11Configuring Apache to Use a Different PortBy default, the Apache Web server is instal

2. Installing OpenLane on Solaris2-12 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 20023-13Installing OpenLane on WindowsAbout These InstructionsThese instructions provide you with the necessary information to

3. Installing OpenLane on Windows3-2 January 2002 7800-A2-GB32-00Installation RequirementsReview the Minimum Hardware Requirements and to verify that

3. Installing OpenLane on Windows7800-A2-GB32-00 January 20023-3Web Client Software RequirementsInternet Explorer Version 5.5 (for Windows-based clien

3. Installing OpenLane on Windows3-4 January 2002 7800-A2-GB32-00Upgrading from Earlier SoftwareIf you are installing OpenLane on a system that is cu

3. Installing OpenLane on Windows7800-A2-GB32-00 January 20023-5The OpenLane Installation ProgramTo install OpenLane and the Apache Web server, execut

3. Installing OpenLane on Windows3-6 January 2002 7800-A2-GB32-00Obtaining the License KeyAn OpenLane license key is required to install OpenLane. Yo

3. Installing OpenLane on Windows7800-A2-GB32-00 January 20023-7Installing from CD-ROMProcedure1. Log on to the Windows system as an administrator.2.

7800-A2-GB32-00 January 2002iContentsAbout This GuideDocument Purpose and Intended Audience . . . . . . . . . . . . . . . . . . . . vDocument Summary

3. Installing OpenLane on Windows3-8 January 2002 7800-A2-GB32-00Displaying the License Key Expiration DateYou can view your license key’s expiration

3. Installing OpenLane on Windows7800-A2-GB32-00 January 20023-9Starting OpenLane Web and Database ServicesOpenLane runs as a Windows service. It star

3. Installing OpenLane on Windows3-10 January 2002 7800-A2-GB32-00Stopping OpenLane Web and Database ServicesUse the Services management screen to sh

3. Installing OpenLane on Windows7800-A2-GB32-00 January 20023-11Configuring Apache to Use a Different PortBy default the Apache Web server is install

3. Installing OpenLane on Windows3-12 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 20024-14Configuring Distributed ComponentsOpenLane Distributed ComponentsOpenLane provides a highly distributable framework. D

4. Configuring Distributed Components4-2 January 2002 7800-A2-GB32-00Setting Up Web Server DistributionWith OpenLane, Web Server functionality can be

4. Configuring Distributed Components7800-A2-GB32-00 January 20024-33. On the OpenLane server (172.20.1.20), edit the jserv.properties file:—Solaris:

4. Configuring Distributed Components4-4 January 2002 7800-A2-GB32-006. On the Web server (172.20.1.10):—Solaris: Edit the /opt/apache/conf/jserv.con

4. Configuring Distributed Components7800-A2-GB32-00 January 20024-5Setting Up the Distributed Poller and ReaderOpenLane allows you to offload the Pol

Contentsii January 2002 7800-A2-GB32-003 Installing OpenLane on WindowsAbout These Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . .

4. Configuring Distributed Components4-6 January 2002 7800-A2-GB32-007. Restart OpenLane: cd /opt/pdn/OpenLaneOLControl start8. Define the location o

4. Configuring Distributed Components7800-A2-GB32-00 January 20024-7Distributed Poller/Reader — Poller/Reader SetupProcedurePerform the following step

4. Configuring Distributed Components4-8 January 2002 7800-A2-GB32-005. Stop OpenLane: OLControl stopIf OpenLane does not shut down within two minute

7800-A2-GB32-00 January 20025-15Apache User Access AuthenticationUser Access AuthenticationUser access authentication is used to specify who has acces

5. Apache User Access Authentication5-2 January 2002 7800-A2-GB32-00Configuring HTTP Challenge/ResponseFollow this procedure to configure HTTP Challe

5. Apache User Access Authentication7800-A2-GB32-00 January 20025-3Where username is the name of the user being added. For example:htpasswd -c /opt/p

5. Apache User Access Authentication5-4 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 20026-16Adding Devices and Customer ProfilesAccessing the OpenLane Web ApplicationsProcedure1. Using your Web browser, enter t

6. Adding Devices and Customer Profiles6-2 January 2002 7800-A2-GB32-00Adding a DeviceProcedureTo add a device to the OpenLane System:1. If you have

6. Adding Devices and Customer Profiles7800-A2-GB32-00 January 20026-3New Device Field Names Field Description*IP Address IP Address of the device bei

Contents7800-A2-GB32-00 January 2002iii6 Adding Devices and Customer ProfilesAccessing the OpenLane Web Applications . . . . . . . . . . . . . . . .

6. Adding Devices and Customer Profiles6-4 January 2002 7800-A2-GB32-005. Modify fields as desired. Make sure Discovered circuits and endpoints is ch

6. Adding Devices and Customer Profiles7800-A2-GB32-00 January 20026-55. The following form appears:6. Fill in the customer information in the fields

6. Adding Devices and Customer Profiles6-6 January 2002 7800-A2-GB32-00—Network – The customer can access the Network Navigator and view log files.—A

7800-A2-GB32-00 January 20027-17OpenLane MaintenanceThe following tasks are the responsibility of the OpenLane administrator:Task Importance Ideal Fre

7. OpenLane Maintenance7-2 January 2002 7800-A2-GB32-00Backing Up OpenLane FilesDirectories that cannot be restored by reinstalling OpenLane should b

7. OpenLane Maintenance7800-A2-GB32-00 January 20027-3Backing Up OpenLane Under SolarisProcedureTo back up files under Solaris:1. Create a text file (

7. OpenLane Maintenance7-4 January 2002 7800-A2-GB32-00Backing Up OpenLane Under WindowsWindows provides no tool for compressing files, but add-on ar

7. OpenLane Maintenance7800-A2-GB32-00 January 20027-5Deleting Older Records from the DatabaseThe dbage function of OLCmd has four modes:The -dparamet

7. OpenLane Maintenance7-6 January 2002 7800-A2-GB32-00Generating Scheduled ReportsTo generate scheduled reports, run the processreports function of

7. OpenLane Maintenance7800-A2-GB32-00 January 20027-7Using AT under Windows to Automate ReportsProcedure1. Using a text editor, create a batch script

Contentsiv January 2002 7800-A2-GB32-00AOLCmd ReferenceOLCmd Helps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7. OpenLane Maintenance7-8 January 2002 7800-A2-GB32-00Rebuilding Oracle Database IndexesAs records are added to and deleted from the database, index

7. OpenLane Maintenance7800-A2-GB32-00 January 20027-9Monitoring Log FilesThe following log files can be viewed from the View Log Files screen, or by

7. OpenLane Maintenance7-10 January 2002 7800-A2-GB32-00Legacy Logger Log FilesThese files are created if pdn.uhpoller.legacyLogger is enabled (set t

7. OpenLane Maintenance7800-A2-GB32-00 January 20027-11Uploading ConfigurationsYou can maintain a library of configuration files so that in the event

7. OpenLane Maintenance7-12 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 20028-18Building and Using a Firmware LibraryBuilding a Firmware LibraryOpenLane allows you to maintain a firmware library fro

8. Building and Using a Firmware Library8-2 January 2002 7800-A2-GB32-00New Device Models Not Supported by OpenLaneYou can create your own subdirecto

8. Building and Using a Firmware Library7800-A2-GB32-00 January 20028-35. Edit the /opt/pdn/OpenLane/database/firmware/mtypes.dat (Solaris) or c:\opt\

8. Building and Using a Firmware Library8-4 January 2002 7800-A2-GB32-00Downloading and Activating FirmwareUse the Schedule Downloads and Firmware Ac

8. Building and Using a Firmware Library7800-A2-GB32-00 January 20028-54. Select Make the firmware active (this causes a device reset) if you would li

7800-A2-GB32-00 January 2002vAbout This GuideDocument Purpose and Intended AudienceThis guide contains information about the OpenLane Service Level Ma

8. Building and Using a Firmware Library8-6 January 2002 7800-A2-GB32-00

7800-A2-GB32-00 January 2002A-1AOLCmd ReferenceOLCmd (OLCmd.bat in Windows) is the command line interface for OpenLane. OLCmd commands include:OLCmd a

A. OLCmd ReferenceA-2 January 2002 7800-A2-GB32-00OLCmd processreports on page A-24 – Generates scheduled reports.OLCmd snmpget on page A-25 – Gets a

A. OLCmd Reference7800-A2-GB32-00 January 2002A-3OLCmd addcustThe addcust command adds customers to the LDAP database.Format:OLCmd addcust -a access_

A. OLCmd ReferenceA-4 January 2002 7800-A2-GB32-00Examples:The following command adds a single customer to the LDAP database with a Realtime access l

A. OLCmd Reference7800-A2-GB32-00 January 2002A-5OLCmd assigndevThe assigndev command assigns devices to a customer ID.Format:OLCmd assigndev -c custo

A. OLCmd ReferenceA-6 January 2002 7800-A2-GB32-00OLCmd chgrawfileextThe chgrawfileext command changes the file extensions of raw data files on selet

A. OLCmd Reference7800-A2-GB32-00 January 2002A-7OLCmd cleanThe clean command creates archive copies of specified log files and deletes archived files

A. OLCmd ReferenceA-8 January 2002 7800-A2-GB32-00OLCmd confauthThe confauth command configures OpenLane for use in a system with Apache user access

A. OLCmd Reference7800-A2-GB32-00 January 2002A-9OLCmd dbageThe dbage command removes older records from the performance statistics database.Format:OL

About This Guidevi January 2002 7800-A2-GB32-00A master glossary of terms and abbreviations used in Paradyne documents is available online at www.para

A. OLCmd ReferenceA-10 January 2002 7800-A2-GB32-00OLCmd dbconfigInformation that OpenLane uses to connect to a database is stored in a naming/direct

A. OLCmd Reference7800-A2-GB32-00 January 2002A-11Advanced Parameters:Example:To change the default database to Oracle and set the database parameters

A. OLCmd ReferenceA-12 January 2002 7800-A2-GB32-00OLCmd dbcopyThe dbcopy command copies all the data in one database instance defined in the naming/

A. OLCmd Reference7800-A2-GB32-00 January 2002A-13OLCmd dbipIP addresses are maintained in the statistics database as single decimal integers. For exa

A. OLCmd ReferenceA-14 January 2002 7800-A2-GB32-00OLCmd dbrollUser history statistics are stored by 15-minute intervals. To speed up the processing

A. OLCmd Reference7800-A2-GB32-00 January 2002A-15OLCmd delcustThe delcust command allows you to delete a customer or a list of customers from the dat

A. OLCmd ReferenceA-16 January 2002 7800-A2-GB32-00OLCmd deldevThe deldev command allows you to delete a device and all associated circuits from the

A. OLCmd Reference7800-A2-GB32-00 January 2002A-17OLCmd dumpldapThe dumpldap command creates an LDAP Data Interchange Format (LDIF) file from the LDAP

A. OLCmd ReferenceA-18 January 2002 7800-A2-GB32-00OLCmd importldifThe importldif command adds entries to an LDAP database based on an LDAP Data Inte

A. OLCmd Reference7800-A2-GB32-00 January 2002A-19OLCmd keyThe key command sets the OpenLane license key, or tests the current key to determine its ex

7800-A2-GB32-00 January 20021-11Introduction to OpenLane SLMOpenLane SLMParadyne’s OpenLane® Service Level Management (SLM) is an open, standards-base

A. OLCmd ReferenceA-20 January 2002 7800-A2-GB32-00OLCmd ldapmodifyThe ldapmodify command adds or modifes entries in the LDAP database. It accepts in

A. OLCmd Reference7800-A2-GB32-00 January 2002A-21OLCmd ldapsearchThe ldapsearch command retrieves data from the LDAP database based on search criteri

A. OLCmd ReferenceA-22 January 2002 7800-A2-GB32-00Example:The following command exports the entire database to an LDIF file:OLCmd ldapsearch -D c=US

A. OLCmd Reference7800-A2-GB32-00 January 2002A-23OLCmd logsvcThe logsvc command sets the IP address of the logger when distributed logging is used.Fo

A. OLCmd ReferenceA-24 January 2002 7800-A2-GB32-00OLCmd processreportsThe processreports command generates scheduled reports for specified customers

A. OLCmd Reference7800-A2-GB32-00 January 2002A-25OLCmd snmpgetThe snmpget command performs an SNMP get on a specified MIB object.Format:OLCmd snmpget

A. OLCmd ReferenceA-26 January 2002 7800-A2-GB32-00OLCmd snmptestThe snmptest command tests SNMP connectivity using a specified community name. If su

A. OLCmd Reference7800-A2-GB32-00 January 2002A-27OLCmd syncThe sync command synchronizes a specified device and the database. If the device is not in

A. OLCmd ReferenceA-28 January 2002 7800-A2-GB32-00Example:The following command synchronizes device 172.20.4.7:OLCmd sync 172.20.4.7-ERequests that

A. OLCmd Reference7800-A2-GB32-00 January 2002A-29OLCmd uhreadThe uhread command starts and stops the User History Reader (UHReader) from a command li