Paradyne SLM 5.5 - Manuals

Contents 7800-A2-GB32-00 January 2002 iii 6 Adding Devices and Customer Profiles „ Accessing the OpenLane Web Applications . . . . . . . . . . . . . . . . . . . . 6-1 „ Adding a Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 „ Adding a Customer Profile...

Contents iv January 2002 7800-A2-GB32-00 A OLCmd Reference „ OLCmd Helps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 „ OLCmd addcust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3 „ OLCmd assigndev . . . . . . ....

7800-A2-GB32-00 January 2002 v About This Guide Document Purpose and Intended Audience This guide contains information about the OpenLane Service Level Management (SLM) system, Version 5.5. It is designed both as an introduction for novice users and a reference for experienced users of OpenLane. Doc...

About This Guide vi January 2002 7800-A2-GB32-00 A master glossary of terms and abbreviations used in Paradyne documents is available online at www.paradyne.com. Select Library → Technical Manuals → Technical Glossary . Product-Related Documents Contact your sales or service representative to order ...

7800-A2-GB32-00 January 2002 1-1 1 Introduction to OpenLane SLM OpenLane SLM Paradyne’s OpenLane ® Service Level Management (SLM) is an open, standards-based, highly distributable system offering robust scalability and flexibility. A Web browser-enabled user interface provides accessibility anytime,...

1. Introduction to OpenLane SLM 1-2 January 2002 7800-A2-GB32-00 OpenLane Features „ Easy-to-use Web browser-based user interface „ Suppor t for the full array of Paradyne SNMP-manageable devices „ Suppor t for several different levels of user access „ Easy-to-use graphical interface installs and co...

7800-A2-GB32-00 January 2002 2-1 2 Installing OpenLane on Solaris About These Instructions These instructions provide you with the necessar y information to get your OpenLane Service Level Management software installed and running as quickly as possible. Installers should be familiar with Solaris an...

2. Installing OpenLane on Solaris 2-2 January 2002 7800-A2-GB32-00 Installation Requirements Review the following Minimum Hardware Requirements and Software Requirements to verify that you meet the prerequisites. Minimum Hardware Requirements Software Requirements „ Sun Solaris 2.6 or 2.8 operating ...

2. Installing OpenLane on Solaris 7800-A2-GB32-00 January 2002 2-3 Checking the Java Runtime Environment Version Before installing the OpenLane Service Level Management software, you need to verify that the Java Runtime Environment (JRE) has been installed correctly. Procedure To verify the JRE inst...

2. Installing OpenLane on Solaris 2-4 January 2002 7800-A2-GB32-00 Upgrading from Earlier Software If you are installing OpenLane on a system that is currently running: „ DCE Manager, see Uninstalling DCE Manager , below. „ Performance Wizard 4.2, see Uninstalling Performance Wizard , below. „ An ea...

2. Installing OpenLane on Solaris 7800-A2-GB32-00 January 2002 2-5 The OpenLane Installation Program To install OpenLane and the Apache Web ser ver, execute the OpenLane setup.sh program. Follow the instructions and respond to the queries it presents. The OpenLane installation program: „ Optionally ...

2. Installing OpenLane on Solaris 2-6 January 2002 7800-A2-GB32-00 NOTES: — You do not have to install the Apache Web ser ver in /opt/apache and OpenLane in /opt/pdn/OpenLane. However, it is highly recommended that you install Apache and OpenLane on the same mount point. If you do not use the standa...

2. Installing OpenLane on Solaris 7800-A2-GB32-00 January 2002 2-7 Installing from CD-ROM Procedure 1. Log on to the system as root . 2. Exit your Web browser if it is running. Inser t the OpenLane CD-ROM into the CD-ROM drive and mount it. 3. Change to the CD-ROM drive. 4. Change to the OpenLane di...

2. Installing OpenLane on Solaris 2-8 January 2002 7800-A2-GB32-00 Installing Remotely Using X You can install OpenLane from a remote host using the X Window System. Procedure 1. On the local host, execute the following commands: xhost + remote_host_name rlogin remote_host_name -l username username ...

2. Installing OpenLane on Solaris 7800-A2-GB32-00 January 2002 2-9 Locating the License Key On an Installed System To locate the license key on the system once OpenLane is installed, use one of these methods: „ Display the OpenLane About screen by clicking the About OpenLane Service Level Management...

2. Installing OpenLane on Solaris 2-10 January 2002 7800-A2-GB32-00 Starting OpenLane Web and Database Services Procedure 1. From a terminal window, change the directory to /opt/pdn/OpenLane: cd /opt/pdn/OpenLane 2. Type OLControl start and press Enter. The following services are star ted: — Apache ...

2. Installing OpenLane on Solaris 7800-A2-GB32-00 January 2002 2-11 Configuring Apache to Use a Different Port By default, the Apache Web server is installed and configured to use TCP port 80 (unless you changed it at installation time). You can configure the Apache Web server to use another por t a...

3. Installing OpenLane on Windows 7800-A2-GB32-00 January 2002 3-3 Web Client Software Requirements „ Internet Explorer Version 5.5 (for Windows-based clients) – or – „ Netscape Communicator Version 4.76 or 4.78 (for Solaris-based clients) Checking the Java Runtime Environment Version Before install...

3. Installing OpenLane on Windows 3-4 January 2002 7800-A2-GB32-00 Upgrading from Earlier Software If you are installing OpenLane on a system that is currently running: „ DCE Manager, see Uninstalling DCE Manager , below. „ Performance Wizard 4.2, see Uninstalling Performance Wizard , below. „ An ea...

3. Installing OpenLane on Windows 3-6 January 2002 7800-A2-GB32-00 Obtaining the License Key An OpenLane license key is required to install OpenLane. You can request a temporary license key from the Paradyne Web site at www.paradyne.com/pdn/key . Installing from Paradyne’s Web Site Procedure 1. Log ...

3. Installing OpenLane on Windows 7800-A2-GB32-00 January 2002 3-9 Starting OpenLane Web and Database Services OpenLane runs as a Windows service. It star ts automatically when Windows does, whether or not a user has logged in to Windows. If you have shut down the OpenLane Monitor service manually (...

3. Installing OpenLane on Windows 3-10 January 2002 7800-A2-GB32-00 Stopping OpenLane Web and Database Services Use the Services management screen to shut down OpenLane. Since the OpenLDAP Directory Service is dependent on the OpenLane Monitor Service, OpenLDAP should be shut down rather than OpenLa...

3. Installing OpenLane on Windows 7800-A2-GB32-00 January 2002 3-11 Configuring Apache to Use a Different Port By default the Apache Web ser ver is installed and configured to use TCP por t 80. You can choose to configure the Apache Web server to use any por t you wish as long as that por t is not i...

7800-A2-GB32-00 January 2002 4-1 4 Configuring Distributed Components OpenLane Distributed Components OpenLane provides a highly distributable framework. Distribution of OpenLane functions can be used to share workload over several servers, and to provide a more secure configuration. This chapter de...

4. Configuring Distributed Components 4-2 January 2002 7800-A2-GB32-00 Setting Up Web Server Distribution With OpenLane, Web Server functionality can be distributed to another server to offload the task of serving Web pages or provide a more secure configuration. The Web Server and the OpenLane Mana...

4. Configuring Distributed Components 7800-A2-GB32-00 January 2002 4-3 3. On the OpenLane ser ver (172.20.1.20), edit the jserv.properties file: — Solaris: Edit the /opt/apache/conf/jserv.properties file and add the address of the Web server to the security.allowedAddresses directive: security.allow...

4. Configuring Distributed Components 4-4 January 2002 7800-A2-GB32-00 6. On the Web server (172.20.1.10): — Solaris: Edit the /opt/apache/conf/jserv.conf file. Modify these directives: ApJServManual On ApJServDefaultHost 172.20.1.20 ApJServMount /OLServlets ajpv12://172.20.1.20/OLServlets ApJServMo...

4. Configuring Distributed Components 7800-A2-GB32-00 January 2002 4-5 Setting Up the Distributed Poller and Reader OpenLane allows you to offload the Poller and Reader functions from the main Solaris OpenLane server to another Solaris hardware platform. The following procedures use this diagram to ...

4. Configuring Distributed Components 7800-A2-GB32-00 January 2002 4-7 Distributed Poller/Reader — Poller/Reader Setup Procedure Perform the following steps on the prospective Distributed Poller/Reader platform (172.20.1.20 in the example diagram). 1. Install OpenLane on the Distributed Poller platf...

7800-A2-GB32-00 January 2002 5-1 5 Apache User Access Authentication User Access Authentication User access authentication is used to specify who has access to the Web server. When authentication is enabled on the Web server, it affects all users of the system. There are many mechanisms that can be ...

5. Apache User Access Authentication 5-2 January 2002 7800-A2-GB32-00 Configuring HTTP Challenge/Response Follow this procedure to configure HTTP Challenge/Response for OpenLane access authentication with the Apache Web server. Procedure 1. If OpenLane is running, stop it. 2. Find the directory wher...

5. Apache User Access Authentication 7800-A2-GB32-00 January 2002 5-3 Where username is the name of the user being added. For example: htpasswd -c /opt/pdn/OpenLane/database/config/.htpasswd Admin Add additional usernames by running the htpasswd program without the -c option. If additional help is n...

7800-A2-GB32-00 January 2002 6-1 6 Adding Devices and Customer Profiles Accessing the OpenLane Web Applications Procedure 1. Using your Web browser, enter the URL of the OpenLane system. Example: http://172.24.9.1/OpenLane/ NOTE: You can use the IP address or the host machine name in the URL to acce...

6. Adding Devices and Customer Profiles 6-2 January 2002 7800-A2-GB32-00 Adding a Device Procedure To add a device to the OpenLane System: 1. If you have not already done so, log in to the OpenLane system with the customer ID of: Admin 2. On the OpenLane Administration screen, select Network Diagnos...

6. Adding Devices and Customer Profiles 6-4 January 2002 7800-A2-GB32-00 5. Modify fields as desired. Make sure Discovered circuits and endpoints is checked and click on Save and Sync. 6. Use the Device Browser or DSLAM Device Display to verify that the device is added properly and endpoints and cir...

6. Adding Devices and Customer Profiles 7800-A2-GB32-00 January 2002 6-5 5. The following form appears: 6. Fill in the customer information in the fields provided. No fields are required, but Customer Name and Account # will not appear on repor ts if they are left blank here. 7. Under 2. Select a sy...

6. Adding Devices and Customer Profiles 6-6 January 2002 7800-A2-GB32-00 — Network – The customer can access the Network Navigator and view log files. — All Customer Reports – The customer can view on-demand and scheduled reports for all customer IDs. 8. Click on the Save button to save the customer...

7800-A2-GB32-00 January 2002 7-1 7 OpenLane Maintenance The following tasks are the responsibility of the OpenLane administrator: Task Importance Ideal Frequency Back up user-modified files. See Backing Up OpenLane Files on page 7-2. Recommended When you add or modify: „ Customer profiles or devices...

7. OpenLane Maintenance 7-2 January 2002 7800-A2-GB32-00 Backing Up OpenLane Files Directories that cannot be restored by reinstalling OpenLane should be backed up periodically for safekeeping. These may include directories listed in Table 7-1 . Directories shown here are the recommended installatio...

7. OpenLane Maintenance 7800-A2-GB32-00 January 2002 7-3 Backing Up OpenLane Under Solaris Procedure To back up files under Solaris: 1. Create a text file (called backup.txt in this example) listing the directories to be backed up. For example: /opt/pdn/OpenLane/data /opt/pdn/OpenLane/database /opt/...

7. OpenLane Maintenance 7-4 January 2002 7800-A2-GB32-00 Backing Up OpenLane Under Windows Windows provides no tool for compressing files, but add-on archiving software is readily available. Use it to create a backup of the directories listed in Table 7-1, Directories That May Contain User-Modified ...

7. OpenLane Maintenance 7800-A2-GB32-00 January 2002 7-5 Deleting Older Records from the Database The dbage function of OLCmd has four modes: „ The -d parameter causes records to be deleted according to individual device definitions (the Save Report Data For and Save Raw Data For values set when eac...

7. OpenLane Maintenance 7-6 January 2002 7800-A2-GB32-00 Generating Scheduled Reports To generate scheduled repor ts, run the processreports function of OLCmd. The processrepor ts application can generate reports based on a date range. This allows, for example, several days’ wor th of reports to be ...

7. OpenLane Maintenance 7800-A2-GB32-00 January 2002 7-7 Using AT under Windows to Automate Reports Procedure 1. Using a text editor, create a batch script in the c:\opt\pdn\OpenLane directory that contains the commands you would ordinarily use to generate reports. For example, to create repor ts fo...

7. OpenLane Maintenance 7-8 January 2002 7800-A2-GB32-00 Rebuilding Oracle Database Indexes As records are added to and deleted from the database, indexes may become fragmented and index trees may increase in height, slowing access to the database. The ol_rbldidx.sql script rebuilds indexes to maint...

7. OpenLane Maintenance 7800-A2-GB32-00 January 2002 7-9 Monitoring Log Files The following log files can be viewed from the View Log Files screen, or by running the viewlog function of OLCmd. „ Default Polling Domain „ Additional Polling Domains (if any exist) „ Firmware/Configuration/Feature Maint...

7. OpenLane Maintenance 7-10 January 2002 7800-A2-GB32-00 Legacy Logger Log Files These files are created if pdn.uhpoller.legacyLogger is enabled (set to true) in preferences.dat: Solaris: /opt/pdn/OpenLane/logs/UHReader.log/opt/pdn/OpenLane/logs/UHPoller_default.log Windows: c:\opt\pdn\OpenLane\log...

7. OpenLane Maintenance 7800-A2-GB32-00 January 2002 7-11 Uploading Configurations You can maintain a library of configuration files so that in the event a device must be replaced, its configuration can be loaded into the new hardware quickly and without discrepancy. Use the Schedule Configuration U...

7800-A2-GB32-00 January 2002 8-1 8 Building and Using a Firmware Library Building a Firmware Library OpenLane allows you to maintain a firmware library from which you can download firmware to devices in your network. Before the Download Feature can schedule or activate firmware download to a device,...

8. Building and Using a Firmware Library 8-2 January 2002 7800-A2-GB32-00 New Device Models Not Supported by OpenLane You can create your own subdirector y and definition files for Paradyne devices not yet supported by OpenLane. The device model number will appear in the drop-down Device Model selec...

8. Building and Using a Firmware Library 8-4 January 2002 7800-A2-GB32-00 Downloading and Activating Firmware Use the Schedule Downloads and Firmware Activations screen to administer firmware for selected devices. Procedure 1. Select Firmware/Configuration/Feature Maintenance from the OpenLane Home ...

7800-A2-GB32-00 January 2002 A-1 A OLCmd Reference OLCmd (OLCmd.bat in Windows) is the command line interface for OpenLane. OLCmd commands include: „ OLCmd addcust on page A-3 – Adds customers to the OpenLane LDAP database. „ OLCmd assigndev on page A-5 – Assigns devices to customers. „ OLCmd chgraw...

A. OLCmd Reference A-2 January 2002 7800-A2-GB32-00 „ OLCmd processreports on page A-24 – Generates scheduled repor ts. „ OLCmd snmpget on page A-25 – Gets an SNMP object. „ OLCmd snmptest on page A-26 – Tests SNMP connection. „ OLCmd sync on page A-27 – Synchronizes a device. „ OLCmd uhread on page...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-3 OLCmd addcust The addcust command adds customers to the LDAP database. Format: OLCmd addcust -a access_level [ [ -c customer_id ] | [ -l customer_list ] ] [ -o customer_details ] [ -t template ] Where: -a access_level Is the access level of the cus...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-5 OLCmd assigndev The assigndev command assigns devices to a customer ID. Format: OLCmd assigndev -c customer_name [ -a device_address ] | [ -l device_list ] Where: Example: The following command adds a single device to customer Exact_Corporation: OL...

A. OLCmd Reference A-6 January 2002 7800-A2-GB32-00 OLCmd chgrawfileext The chgrawfileext command changes the file extensions of raw data files on seleted polling domains. Format: OLCmd chgrawfileext [ -d polling_domain ] [ -o current_extension ] [ -e new_extension ] Where: Example: The following co...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-7 OLCmd clean The clean command creates archive copies of specified log files and deletes archived files older than a specified age. Format: OLCmd clean directory extension days [ new-extension ] Where: Example: The following command moves files in t...

A. OLCmd Reference A-8 January 2002 7800-A2-GB32-00 OLCmd confauth The confauth command configures OpenLane for use in a system with Apache user access authentication. Format: OLCmd confauth on | off Where: Example: To configure OpenLane for use in a system with Apache user access authentication: OL...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-9 OLCmd dbage The dbage command removes older records from the performance statistics database. Format: OLCmd dbage [ -n instance ] [ [ -d | -a ] | [ [ -raw days ] [ -rpt days ] ] | -dd ] Where: Example: To delete Report data records older than 90 da...

A. OLCmd Reference A-10 January 2002 7800-A2-GB32-00 OLCmd dbconfig Information that OpenLane uses to connect to a database is stored in a naming/directory ser vice. The dbconfig command creates or modifies the naming/directory ser vice database entry that points to the performance statistics databa...

A. OLCmd Reference A-12 January 2002 7800-A2-GB32-00 OLCmd dbcopy The dbcopy command copies all the data in one database instance defined in the naming/directory ser vice to another database instance. It can be used, for example, to conver t an outgrown Cloudscape database to an Oracle database. For...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-13 OLCmd dbip IP addresses are maintained in the statistics database as single decimal integers. For example, the IP address 135.26.10.37 is maintained in the database as –2028336603. The dbip command conver ts a single integer into a dotted decimal ...

A. OLCmd Reference A-14 January 2002 7800-A2-GB32-00 OLCmd dbroll User history statistics are stored by 15-minute intervals. To speed up the processing of SLV reports, and to reduce the size of the database, you can roll up statistics into hourly inter vals by using the dbroll function of OLCmd. For...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-15 OLCmd delcust The delcust command allows you to delete a customer or a list of customers from the database. Format: OLCmd delcust [-c customer ] | [ -l customer-list ] Where: Example: The file ex-customers.txt contains customer IDs on separate lin...

A. OLCmd Reference A-16 January 2002 7800-A2-GB32-00 OLCmd deldev The deldev command allows you to delete a device and all associated circuits from the database. Format: OLCmd deldev ip_address Where: Example: The following command deletes the device whose IP address is 135.26.10.37 and all its circ...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-17 OLCmd dumpldap The dumpldap command creates an LDAP Data Interchange Format (LDIF) file from the LDAP database. The file may be used for export to a different directory server system. The file created is written to standard output. The dumpldap co...

A. OLCmd Reference A-18 January 2002 7800-A2-GB32-00 OLCmd importldif The importldif command adds entries to an LDAP database based on an LDAP Data Interchange Format (LDIF) file. The importldif command also uses the environmental variable LDAP , located in the file OLControlConfig (Solaris) or OLCo...

A. OLCmd Reference A-20 January 2002 7800-A2-GB32-00 OLCmd ldapmodify The ldapmodify command adds or modifes entries in the LDAP database. It accepts input from the STDIN stream. Format: OLCmd ldapmodify [ -D bindDN ] [ -w password ] [ -h host ] [ -p por t ] [ -F ] [ -a | -r ] [ -b ] [ -c ] [ -v ] W...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-21 OLCmd ldapsearch The ldapsearch command retrieves data from the LDAP database based on search criteria. Format: OLCmd ldapsearch [ -n ] [ -D bindDN ] [ -w password ] [ -h host ] [ -p por t ] [ -b searchbase ] [ -F separator ] [ -S sort_attrib ] [ ...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-23 OLCmd logsvc The logsvc command sets the IP address of the logger when distributed logging is used. Format: OLCmd logsvc ip_address Where: Example: The following command sets the IP address of the logger: OLCmd logsvc 135.26.10.37 ip_address Is th...

A. OLCmd Reference A-24 January 2002 7800-A2-GB32-00 OLCmd processreports The processreports command generates scheduled repor ts for specified customers and dates. Format: OLCmd processreports [ -date date ] [ -enddate enddate ] [ -customer customer_id ] [ -customerlist list_file ] Where: Example: ...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-25 OLCmd snmpget The snmpget command performs an SNMP get on a specified MIB object. Format: OLCmd snmpget [ community_name ] ip_address object_id Where: Example: The following command performs an SNMP get and displays the sysDescr MIB object: OLCmd ...

A. OLCmd Reference A-26 January 2002 7800-A2-GB32-00 OLCmd snmptest The snmptest command tests SNMP connectivity using a specified community name. If successful, snmptest displays sysDescr, sysName, sysContact, and sysLocation. Format: OLCmd snmptest ip_address [ community_name ] Where: Example: The...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-27 OLCmd sync The sync command synchronizes a specified device and the database. If the device is not in the database, it is added. Format: OLCmd sync [ [ -v ] [ -c community-string ] [ -w community-string ] [ [ -i ftp_user ] [ -p ftp_passwd ] ] [ -g...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-29 OLCmd uhread The uhread command star ts and stops the User Histor y Reader (UHReader) from a command line. It can be used to process user history records automatically during periods of low network activity. Format: OLCmd uhread -c command [ -n po...

A. OLCmd Reference A-30 January 2002 7800-A2-GB32-00 OLCmd unassigndev The unassigndev command removes devices from a customer record. Format: OLCmd unassigndev -c customer_name [ -a device_address ] | [ -l device_list ] Where: Example: The following command removes a single device from customer Exa...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-31 OLCmd viewlog The viewlog command displays selected records from a log file. Format: OLCmd viewlog [ -l ] [ -f log_type ] [ -sd mm/dd/yyyy ] [ -ed mm/dd/yyyy ] [ -st hh:mm:ss ] [ -et hh:mm:ss ] [ -u userid ] [ -ip ip_address ] [ log_name ] Where: ...

A. OLCmd Reference 7800-A2-GB32-00 January 2002 A-33 OLCmd xmlreport The xmlreport command generates OpenLane reports based on eXtensible Markup Language (XML) repor t requests, and optionally transforms the output based on an eXtensible Stylesheet Language Transformations (XSLT) file. For more info...

7800-A2-GB32-00 January 2002 B-1 B Using XML to Produce Reports XML Reports OpenLane’s eXtensible Markup Language (XML) reporting capability allows repor ts to be requested using XML. The format of the repor t to be returned is defined in the XML request itself. Repor ts can be generated in XML, Hyp...

B. Using XML to Produce Reports B-2 January 2002 7800-A2-GB32-00 Servlet Interface (SlvXmlServlet) The XML report servlet can be found at: /opt/pdn/OpenLane/OLServlets/pdn.webcgi.SlvXmlServlet The SlvXmlServlet servlet accepts a repor t request in XML and generates a repor t in a specified format. T...

B. Using XML to Produce Reports 7800-A2-GB32-00 January 2002 B-3 XML and XSL Examples The XML format of the report requests and the report outputs are documented through examples. The primary repor t request example, with comments showing XML tags, attributes, and possible values, is at /opt/pdn/Ope...

7800-A2-GB32-00 January 2002 IN-1 Index A access authentication, 5-1access levels, 6-5accessing OpenLane applications, 6-1 activating firmware, 8-4 adding customer profiles, 6-4customers, A-3devices to OpenLane, 6-2new device models, 8-2 administrator responsibilities, 7-1Apache installation paramet...