Paradyne OpenLane SLM 5.5 Service manual

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

AJanuary 2002 7800-A2-GB32-00
Copyright © 2002 Paradyne Corporation.
All rights reserved.
Printed in U.S.A.
Notice
This publication is protected by federal copyright law. No part of this publication may be copied or distributed,
transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language in any form or
by any means, electronic, mechanical, magnetic, manual or otherwise, or disclosed to third parties without the express
written permission of Paradyne Corporation, 8545 126th Ave. N., Largo, FL 33773.
Paradyne Corporation makes no representation or warranties with respect to the contents hereof and specifically
disclaims any implied warranties of merchantability or fitness for a particular purpose. Further, Paradyne Corporation
reserves the right to revise this publication and to make changes from time to time in the contents hereof without
obligation of Paradyne Corporation to notify any person of such revision or changes.
Changes and enhancements to the product and to the information herein will be documented and issued as a new
release to this manual.
Warranty, Sales, Service, and Training Information
Contact your local sales representative, service representative, or distributor directly for any help needed. For additional
information concerning warranty, sales, service, repair, installation, documentation, training, distributor locations, or
Paradyne worldwide office locations, use one of the following methods:

Internet: Visit the Paradyne World Wide Web site at www.paradyne.com. (Be sure to register your warranty at
www.paradyne.com/warranty.)

Telephone: Call our automated system to receive current information by fax or to speak with a company
representative.
—Within the U.S.A., call 1-800-870-2221
—Outside the U.S.A., call 1-727-530-2340
Document Feedback
We welcome your comments and suggestions about this document. Please mail them to Technical Publications,
Paradyne Corporation, 8545 126th Ave. N., Largo, FL 33773, or send e-mail to [e-mail]. Include the
number and title of this document in your correspondence. Please include your name and phone number if you are
willing to provide additional clarification.
Trademarks
ACCULINK, COMSPHERE, FrameSaver, Hotwire, MVL, NextEDGE, OpenLane, and Performance Wizard are
registered trademarks of Paradyne Corporation. ReachDSL and TruePut are trademarks of Paradyne Corporation. All
other products and services mentioned herein are the trademarks, service marks, registered trademarks, or registered
service marks of their respective owners.

7800-A2-GB32-00 January 2002 i
Contents
About This Guide

Document Purpose and Intended Audience . . . . . . . . . . . . . . . . . . . . v

Document Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Product-Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
1 Introduction to OpenLane SLM

OpenLane SLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Network Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Easy Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

OpenLane Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
2 Installing OpenLane on Solaris

About These Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Planning the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Minimum Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Checking the Java Runtime Environment Version. . . . . . . . . . . . . . . . 2-3

Upgrading from Earlier Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Uninstalling DCE Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Uninstalling Performance Wizard . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

The OpenLane Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Obtaining a License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Installing from Paradyne’s Web Site . . . . . . . . . . . . . . . . . . . . . . . 2-6
Installing from CD-ROM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Installing from FTP Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Installing Remotely Using X. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Installing the Permanent License Key . . . . . . . . . . . . . . . . . . . . . . 2-8
Locating the License Key On an Installed System . . . . . . . . . . . . 2-9
Displaying the License Key Expiration Date . . . . . . . . . . . . . . . . . 2-9

Migration to Current Release for Oracle . . . . . . . . . . . . . . . . . . . . . . . 2-9

Starting OpenLane Web and Database Services . . . . . . . . . . . . . . . . 2-10

Stopping OpenLane Web and Database Services. . . . . . . . . . . . . . . . 2-10

Configuring Apache to Use a Different Port. . . . . . . . . . . . . . . . . . . . . 2-11

Contents
ii January 2002 7800-A2-GB32-00
3 Installing OpenLane on Windows

About These Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Planning the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Minimum Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Web Client Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . 3-3

Checking the Java Runtime Environment Version. . . . . . . . . . . . . . . . 3-3

Upgrading from Earlier Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Uninstalling DCE Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Uninstalling Performance Wizard . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

The OpenLane Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Obtaining the License Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Installing from Paradyne’s Web Site . . . . . . . . . . . . . . . . . . . . . . . 3-6
Installing from CD-ROM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Installing from FTP Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Installing the Permanent License Key . . . . . . . . . . . . . . . . . . . . . . 3-7
Locating the License Key On an Installed System . . . . . . . . . . . . 3-7
Displaying the License Key Expiration Date . . . . . . . . . . . . . . . . . 3-8

Migration to Current Release for Oracle . . . . . . . . . . . . . . . . . . . . . . . 3-8

Starting OpenLane Web and Database Services . . . . . . . . . . . . . . . . 3-9

Stopping OpenLane Web and Database Services. . . . . . . . . . . . . . . . 3-10

Configuring Apache to Use a Different Port. . . . . . . . . . . . . . . . . . . . . 3-11
4 Configuring Distributed Components

OpenLane Distributed Components. . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Setting Up Web Server Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Operational Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Setting Up the Distributed Poller and Reader . . . . . . . . . . . . . . . . . . . 4-5
Distributed Poller/Reader —Management Server Setup . . . . . . . 4-5
Distributed Poller/Reader —Poller/Reader Setup. . . . . . . . . . . . . 4-7
5 Apache User Access Authentication

User Access Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Configuring HTTP Challenge/Response . . . . . . . . . . . . . . . . . . . . . . . 5-2

Removing a User’s Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
7 OpenLane Maintenance

Backing Up OpenLane Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Oracle Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Backing Up OpenLane Under Solaris . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

Restoring OpenLane Under Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

Backing Up OpenLane Under Windows. . . . . . . . . . . . . . . . . . . . . . . . 7-4

Restoring OpenLane Under Windows . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Deleting Older Records from the Database. . . . . . . . . . . . . . . . . . . . . 7-5
Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

Generating Scheduled Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
Automating the Generation of Scheduled Reports . . . . . . . . . . . . 7-6
Using Cron Under Solaris to Automate Reports . . . . . . . . . . . . . . 7-6
Using AT under Windows to Automate Reports . . . . . . . . . . . . . . 7-7

Rebuilding Oracle Database Indexes. . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

Monitoring Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Apache Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
SQL Database Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Legacy Logger Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

Archiving and Deleting Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

Uploading Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11
8 Building and Using a Firmware Library

Building a Firmware Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
New Device Models Not Supported by OpenLane . . . . . . . . . . . . 8-2

Downloading and Activating Firmware. . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Contents
iv January 2002 7800-A2-GB32-00
AOLCmdReference

OLCmd Helps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

OLCmd addcust. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

OLCmd assigndev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

OLCmd chgrawfileext. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6

OLCmd clean. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7

OLCmd confauth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

OLCmd dbage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9

OLCmd dbconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

OLCmd dbcopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-12

OLCmd dbip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13

OLCmd dbroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14

OLCmd delcust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-15

OLCmd deldev. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16

OLCmd dumpldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-17

OLCmd importldif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18

OLCmd key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19

OLCmd ldapmodify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20

OLCmd ldapsearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21

OLCmd logsvc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23

OLCmd processreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24

OLCmd snmpget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25

OLCmd snmptest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-26

OLCmd sync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-27

OLCmd uhread. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-29

OLCmd unassigndev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-30

OLCmd viewlog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-31

OLCmd xmlreport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-33
B Using XML to Produce Reports

XML Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Command Line Interface (OLCmd xmlreport) . . . . . . . . . . . . . . . . . . . B-1

Servlet Interface (SlvXmlServlet). . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Writing an Interface to the Servlet . . . . . . . . . . . . . . . . . . . . . . . . . B-2

XML and XSL Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3

Additional Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Index

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.
Document Summary
Section Description
Chapter 1, Introduction to
OpenLane SLM
Describes the general purpose and features of
OpenLane.
Chapter 2,
Installing OpenLane on
Solaris
Contains procedures for installing OpenLane on a
Solaris platform.
Chapter 3,
Installing OpenLane on
Windows
Contains procedures for installing OpenLane on a
Windows platform.
Chapter 4,
Configuring Distributed
Components
Explains how to run a Web server and a
poller/reader server separate from the OpenLane
management server.
To configure a distributed Oracle database, see the
OpenLane SLM 5.5 Oracle Database
Administration Instructions
.
Chapter 5,
Apache User Access
Authentication
Explains how to set up user access authentication
through Apache.
Chapter 6,
Adding Devices and
Customer Profiles
Presents the basic tasks necessary to set up a
customer on OpenLane.
Chapter 7,
OpenLane Maintenance Lists and describes the tasks necessary to maintain
the OpenLane system.
Chapter 8,
Building and Using a
Firmware Library
Explains how to administer a library of device
firmware.
Appendix A,
OLCmd Reference Describes the functions of the command line
program OLCmd.
Index Lists key terms, concepts, and sections in
alphabetical order.

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 additional product
documentation.
Paradyne documents are also available online at www.paradyne.com. Select
Library
→
Technical Manuals
.
OpenLane’s Online Help is available in the Technical Manuals area, as well as on
Paradyne’s documentation CD-ROM. The Online Help is the user’s guide for
OpenLane.
Document Number Document Title
7800-A2-GB30
OpenLane SLM Reports Reference Guide
7800-A2-GZ46
OpenLane SLM 5.5 Oracle Database Administration
Instructions

7800-A2-GB32-00 January 2002 1-1
1
Introduction to OpenLane SLM
OpenLane SLM
Paradyne’sOpenLane®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,
anywhere.
Paradyne’s network management solution features support for diagnostics,
real-time performance monitoring, historical reporting, and detailed health and
status indicators for Paradyne’s wide array of SNMP-managed narrow and
broadband network access device families. Support is provided for Paradyne’s
FrameSaver®and Hotwire®products. OpenLane also supports Paradyne’s 31xx,
7xxx, and 9xxx T1 and subrate access products.
Network Monitoring
OpenLane lets you proactively and reactively monitor, analyze, and troubleshoot
your network with easy-to-use management tools, letting you discover and
eliminate trouble spots before they affect service. With OpenLane you can verify
line quality and the level of service provided, as well as monitor bandwidth
utilization.
OpenLane comprises several features that provide extensive element, network,
and service level management capabilities for network service providers, network
managers, and their end customers.
Easy Installation
OpenLane is installed through an easy-to-use graphical interface. OpenLane’s
highly scalable architecture offers flexibility to grow your system as management
scope increases. OpenLane can span customer network sizes from small
customers with a few dozen devices and a few users to carrier-class installations
with thousands of devices and many users.

1. Introduction to OpenLane SLM
1-2 January 2002 7800-A2-GB32-00
OpenLane Features

Easy-to-use Web browser-based user interface

Support for the full array of Paradyne SNMP-manageable devices

Support for several different levels of user access

Easy-to-use graphical interface installs and configures each module

E-commerce-class distributed architecture supports small-scale end-user
networks up to carrier-class deployments

Distributed architecture supports:
—Optional customer-supplied Oracle 8i database
—Distributed Web server
—Distributed Poller/Reader (on Solaris platform)
—LDAP (Lightweight Directory Access Protocol) directory service

Integrates with HP OpenView

Online Help system with full text search capability

Device configuration through the Web interface

Scheduled and on-demand firmware maintenance downloads

Service level reporting, enabling quality of service (QoS) verification

Historical data collection and reporting (FrameSaver only)

On-demand polling

Real-time device health and status, diagnostics, and performance monitoring

Extensive Web-based diagnostics, including non-disruptive PVC loopbackand
end-to-end connectivity testing

7800-A2-GB32-00 January 2002 2-1
2
Installing OpenLane on Solaris
About These Instructions
These instructions provide you with the necessary information to get your
OpenLane Service Level Management software installed and running as quickly
as possible. Installers should be familiar with Solaris and Solaris administration.
Planning the Installation
Before installing OpenLane:

Review the
Installation Requirements
on page 2-2.

Verify the JRE version on your system. Refer to
Checking the Java Runtime
Environment Version
on page 2-3.

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 system (Solaris 2.7 is not supported)

Java Runtime Environment (JRE) Version 1.1.8_10
The JRE is included on the OpenLane CD.

Internet Explorer 5.5 (for Windows-based clients) or Netscape Communicator
Version 4.76 or 4.78 (for Solaris-based clients)

The following default TCP ports are used by the OpenLane server:
—Port 80: Apache Web server 1.3.12 (for HTTP Requests. The port can be
changed; see
Configuring Apache to Use a Different Port
on page 2-11)
—Port 1521: Oracle Database (if used)
—Port 2099: Remote Method Invocation (RMI for Application
Communications)
—Port 3890: LDAP (Lightweight Directory Access Protocol) Directory
Services
—Port 8007: Apache JServ (for Java Servlet Communications)

Optional:
Distributed architecture with customer-supplied Oracle 8i (Standard
or Enterprise)
OpenLane’s internal Cloudscape database accommodates up to 80 PVCs
(160 DLCIs). For larger networks, an Oracle database must be installed.

Optional:
HP OpenView Network Node Manager 6.1 or 6.2
To install OpenLane on a UNIX system (not Solaris), a graphical interface such as
the X Window System is required. This is inherent in Solaris.
Networks with
Less Than 500 Devices*
* A device is an SNMP-manageable CSU, DSU, or DSL port.
Networks with
500–2000 Devices Networks with
2000–5000 Devices

Sun Ultra 10

256 MB RAM

Sun Ultra 10

512 MB RAM

Sun Enterprise 450 Server

512 MB RAM

100 MB free disk space

Additional disk space for storage of performance data:
–Cloudscape: 120 KB of disk space per PVC per day (60 KB per DLCI per day)
–Oracle: 62 KB of disk space per PVC per day (31 KB per DLCI per day)

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 installation:
1. Open a terminal window. Type jre and press Enter.
The window should display the Java Runtime Environment Version number
and a list of options. Verify that you have Version 1.1.8_10.
2. If you receive a message that the JRE cannot be found or another version is
found, verify that the path to the correct JRE is in your PATH environment
variable. To display the PATH environment variable:
Type echo $PATH and press Enter.
Version Number

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 earlier version of OpenLane 5, the upgrade is handled automatically
during the OpenLane installation. Do not uninstall the earlier version.
If you use an Oracle database, you must execute a migration script to update
the schema. See the
OpenLane SLM 5.5 Oracle Database Administration
Instructions
.
Uninstalling DCE Manager
To uninstall DCE Manager, follow this procedure before installing OpenLane:
Procedure
1. Start the DCEinstall program.
—If you downloaded the software from the World Wide Web, change to the
directory where you expanded the file and run the installation program:
cd <directory>
./DCEinstall
—If you mounted the CD-ROM for Sun systems:
cd /tmp/cdrom/DCE/Solaris2
./DCEinstall
2. The script detects the existing version and prompts you to uninstall it.
Select OK.
3. When the software is uninstalled, the installation script prompts you to install
DCE Manager. Select No.
Uninstalling Performance Wizard
Procedure
1. Run UnInstallToOV:
cd /opt/OV/pdn/PerfWiz
./UnInstallToOV
2. Delete the /opt/OV/pdn/ directory and all subordinate directories and files:
rm -rf /opt/OV/pdn

2. Installing OpenLane on Solaris
7800-A2-GB32-00 January 2002 2-5
The OpenLane Installation Program
To install OpenLane and the Apache Web server, execute the OpenLane setup.sh
program. Follow the instructions and respond to the queries it presents. The
OpenLane installation program:

Optionally installs and configures the Apache 1.3.12 Web server and the
Apache JServ. (This is not required for upgrades from earlier versions of
OpenLane 5.)
By default, the Apache software is installed with the following parameters:
These options can be changed during the installation process. To modify the
Apache Web server to use a port other than port 80 after installation, see
Configuring Apache to Use a Different Port
on page 2-11.
The default installation path for Apache software is:
/opt/apache

Installs the OpenLane components, including the Cloudscape Java SQL
Database.
The default installation path for OpenLane software is:
/opt/pdn/OpenLane

Provides a startup command to control all Apache and OpenLane processes.

Includes Management Platform Integration Adapters for HP OpenView
Network Node Manager for Sun Solaris.
The software-based platform adapters provide integration points for:
—Paradyne device-specific map icon creation
—Trap definition files
In addition, OpenLane is added to OpenView’s menu structure.
Apache Parameter Setting
Installation directory /opt/apache
TCP Port for HTTP requests 80
User nobody
Group nobody

2. Installing OpenLane on Solaris
2-6 January 2002 7800-A2-GB32-00
NOTES:
—You do not have to install the Apache Web server 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 standard directory names, substitute the names you
use for the directory references in this document.
—If you will be distributing the Web server, you must install OpenLane and
Apache in the same directory path on the Web server and the OpenLane
Management system.
Obtaining a 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. A 30-day temporary license key is provided by
e-mail.
Installing from Paradyne’s Web Site
Procedure
1. Log on to the system as root.
2. Obtain a temporary license key and the OpenLane software from
www.paradyne.com/pdn/key.
3. Save the setup.sh file in /tmp or any directory you choose.
4. Exit
your Web browser if it is running. Change to the directory chosen in
Step 3.
5. Change the file permissions:
chmod 777 setup.sh
6. Run the setup.sh file:
./setup.sh
7. Follow the instructions on each screen with these exceptions:
—If you are upgrading a version of OpenLane 5, do not remove the old
version when prompted. Select Continue.
—When prompted for the Apache User and Group information, use the
default User and Group:
User = nobody
Group = nobody

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. Insert the OpenLane CD-ROM into the
CD-ROM drive and mount it.
3. Change to the CD-ROM drive.
4. Change to the OpenLane directory and run the setup.sh file.
5. Follow the instructions on each screen with these exceptions:
—If you are upgrading a version of OpenLane 5, do not remove the old
version when prompted. Select Continue.
—When prompted for the Apache User and Group information, use:
User = nobody
Group = nobody
Installing from FTP Files
Contact Technical Support to arrange this type of installation:

1-800-795-8004

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
must have root privilege.
2. On the remote host, execute the following command or commands:
—If using the Bourne shell (sh):
DISPLAY=
local_host_name
:0.0
export DISPLAY
—If using the Korn shell (ksh):
export DISPLAY=
local_host_name
:0.0
—If using the C shell (csh):
setenv DISPLAY
local_host_name
:0.0
3. On the remote host, change the directory to the path where setup.sh resides:
cd /tmp
4. Run setup.sh:
./setup.sh
Installing the Permanent License Key
Procedure
1. Change the directory to /opt/pdn/OpenLane:
cd /opt/pdn/OpenLane
2. Enter the command to install the permanent key:
OLCmd key
permanent_key
Where
permanent_key
is the key e-mailed or faxed to you by Paradyne. For
example:
OLCmd key ALUKB-KAC9Y-H987N-CX5GK

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 link on the OpenLane Administration screen

Display the /opt/pdn/OpenLane/pdnKey.txt file using a text editor

Issue the command OLCmd key from a command line (see
Displaying the
License Key Expiration Date
)
Displaying the License Key Expiration Date
You can view your license key’s expiration date at any time using the key function
of OLCmd.
Procedure
1. Open a terminal window and change to the OpenLane directory.
2. Enter the command:
OLCmd key
The expiration date is displayed in day-month-year format. For example:
License expires on: 02-Jan-03
This license expires on January 2, 2003.
Migration to Current Release for Oracle
If you use an Oracle database for an earlier release of OpenLane, you must run a
migration script to update the schema after OpenLane is installed. See the
OpenLane SLM 5.5 Oracle Database Administration Instructions
.

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
started:
—Apache Web Server
—Cloudscape JDBMS (if used)
—OpenLane Services
—RMI Application Server
—SCM Poller
—OpenLDAP Directory Services
—User History Poller
—User History Reader
Stopping 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 stop and press Enter.