background image

OpenLane

®

 SLM 5.5

Administrator’s Guide

Document No. 7800-A2-GB32-00

January 2002

Summary of Contents for OpenLane SLM 5.5

Page 1: ...OpenLane SLM 5 5 Administrator s Guide Document No 7800 A2 GB32 00 January 2002...

Page 2: ...al sales representative service representative or distributor directly for any help needed For additional information concerning warranty sales service repair installation documentation training distr...

Page 3: ...a 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...

Page 4: ...P 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 Star...

Page 5: ...ting 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 und...

Page 6: ...md 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 OLC...

Page 7: ...pter 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 Op...

Page 8: ...epresentative 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 Tec...

Page 9: ...ss 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 s...

Page 10: ...tomer 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 H...

Page 11: ...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 installin...

Page 12: ...lication Communications Port 3890 LDAP Lightweight Directory Access Protocol Directory Services Port 8007 Apache JServ for Java Servlet Communications Optional Distributed architecture with customer s...

Page 13: ...cedure 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...

Page 14: ...ctions 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 We...

Page 15: ...o 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 com...

Page 16: ...ne 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 L...

Page 17: ...e 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 re...

Page 18: ...he 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...

Page 19: ...ng 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 wi...

Page 20: ...pe 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 Hi...

Page 21: ...another service Procedure To change the TCP port 1 From a terminal window change the directory to opt pdn OpenLane cd opt pdn OpenLane 2 To stop OpenLane type OLControl stop and press Enter 3 Change t...

Page 22: ...2 Installing OpenLane on Solaris 2 12 January 2002 7800 A2 GB32 00...

Page 23: ...your OpenLane Service Level Management software installed and running as quickly as possible Installers should be familiar with Windows administration Planning the Installation Before installing Open...

Page 24: ...rt 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 Optio...

Page 25: ...evel Management software you need to verify that the Java Runtime Environment JRE has been installed correctly Procedure To verify the JRE installation 1 Open an MS DOS command prompt window Type jre...

Page 26: ...Do not uninstall the earlier version If you use an Oracle database use the supplied migration script to update the schema See the OpenLane SLM 5 5 Oracle Database Administration Instructions Uninstall...

Page 27: ...the Cloudscape Java SQL Database Default installation path for OpenLane software C opt pdn OpenLane Establishes OpenLane as a Windows service that starts automatically when Windows does Includes Manag...

Page 28: ...software from www paradyne com pdn key 3 Save the setup exe file in C temp or any directory you choose 4 Exit your Web browser if it is running 5 Run the setup exe file 6 Follow the instructions on e...

Page 29: ...rt to arrange this type of installation 1 800 795 8004 Installing the Permanent License Key Procedure 1 Open an MS DOS command prompt window and change to the OpenLane directory cd opt pdn OpenLane 2...

Page 30: ...o 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 Migrati...

Page 31: ...the OpenLane Monitor service manually see Stopping OpenLane Web and Database Services on page 3 10 you can restart it by restarting Windows or by following this procedure Procedure To restart OpenLan...

Page 32: ...Directory Service is dependent on the OpenLane Monitor Service OpenLDAP should be shut down rather than OpenLane Monitor Procedure 1 Invoke the Services management screen It can be found In the Contr...

Page 33: ...che When you use a port other than 80 the port must be specified in URLs directed to the Apache server For example if you use Port 8080 on the host olserver com the URL for OpenLane is http olserver c...

Page 34: ...3 Installing OpenLane on Windows 3 12 January 2002 7800 A2 GB32 00...

Page 35: ...able framework Distribution of OpenLane functions can be used to share workload over several servers and to provide a more secure configuration This chapter describes Distributing the Web server Distr...

Page 36: ...names on both servers The directory path cannot exceed 18 characters Installation Path examples Solaris If the OpenLane server and or the Web server use a Solaris server then install OpenLane in opt...

Page 37: ...e and add the address of the Web server to the security allowedAddresses directive and set the bind address to the IP address of the OpenLane server security allowedAddresses 127 0 0 1 172 20 1 20 172...

Page 38: ...t OLServlets2 ajpv12 172 20 1 20 OLServlets2 7 Start the Web server In this example you can now access the OpenLane Management System by entering http 172 20 1 10 OpenLane Operational Notes An httpd s...

Page 39: ...ample diagram 1 Stop OpenLane cd opt pdn OpenLane OLControl stop 2 Edit etc dfs dfstab and add the following line at the end share F nfs o rw opt pdn OpenLane uhpoller 3 Stop and start the NFS server...

Page 40: ...OpenLane cd opt pdn OpenLane OLControl start 8 Define the location of the database Use the appropriate command for your database type OLCmd dbconfig m 172 20 1 10 Cloudscape OLCmd dbconfig m 172 20 1...

Page 41: ...on 0 off Change DOMAIN and READER_DOMAIN from default to the new domain name poller1 in this example Example of the OLControlConfig file DOMAIN default Change to poller1 READER_DOMAIN default Change...

Page 42: ...poller poller_poller1 This is a temporary mount and will not be reestablished after a reboot To set up a permanent mount add the following line to the etc vfstab file 172 20 1 10 opt pdn OpenLane uhpo...

Page 43: ...nt variable to CGI programs Methods and protocols include HTTP Challenge Response SSL Secure Sockets Layer Secure HTTP with a well configured firewall VPN Virtual Private Network A router The followin...

Page 44: ...n OpenLane database config in Solaris and C opt pdn OpenLane database config in Windows is correct If the Apache configuration files were installed during an OpenLane installation AuthUserFile is alre...

Page 45: ...sole window Solaris or MS DOS prompt Windows The confauth function configures OpenLane to run with an authenticated system For help and a list of command line parameters run confauth without any param...

Page 46: ...5 Apache User Access Authentication 5 4 January 2002 7800 A2 GB32 00...

Page 47: ...1 OpenLane NOTE You can use the IP address or the host machine name in the URL to access the OpenLane system OpenLane must be running on the host machine 2 When the OpenLane login screen appears enter...

Page 48: ...d 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 Diagnostics 3 Sel...

Page 49: ...bles RMON Data Collection Default Disabled Polling Domain User history polling domain Should be left as default Polling Interval Number of minutes between each RMON Data Collection Default 480 minutes...

Page 50: ...y and endpoints and circuits are discovered See the OpenLane online Help for more information Adding a Customer Profile Procedure To create a new Customer Profile for Web based report access 1 Log in...

Page 51: ...eports and DSL inventory reports and run on demand reports Realtime The customer can can generate Performance graphs real time and historical generate on demand reports view scheduled reports view Hea...

Page 52: ...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 profile 9 Assign d...

Page 53: ...of OLCmd See Deleting Older Records from the Database on page 7 5 Critical Daily Run the processreports function of OLCmd See Generating Scheduled Reports on page 7 6 Required for scheduled reports u...

Page 54: ...ws Customized default template files customized default preferences opt pdn OpenLane database Solaris C opt pdn OpenLane database Windows Directory services LDAP database includes device information r...

Page 55: ...hat you have sufficient space in the backup directory called backup_dir in this example to accommodate a copy of the files 3 From a command prompt execute the tar tape archive command tar cvf backup_d...

Page 56: ...a backup of the directories listed in Table 7 1 Directories That May Contain User Modified Files that contain altered files Using WinZip for example you might begin an archive file by selecting all f...

Page 57: ...e the deletion of outdated records For a complete description of the dbage command see Appendix A OLCmd Reference Frequency How often dbage needs to be run depends in part on the disk space allotted t...

Page 58: ...t the times or intervals specified by the scheduler Using Cron Under Solaris to Automate Reports Procedure 1 Using a text editor create a shell script in the opt pdn OpenLane directory that contains t...

Page 59: ...all the scheduled commands on the computer are canceled yes Used with cancel all jobs command when no further confirmation is desired time Specifies the time when command is to run interactive Allows...

Page 60: ...med OpenLane every Sunday morning starting at 12 15 am on a Solaris system 1 Move opt pdn OpenLane data sql scripts Oracle Maintenance ol_rbldidx sql to the ORACLE_HOME directory 2 Create a shell scri...

Page 61: ...rofile Administration System Access logins and logouts PVC Maintenance Periods Other OpenLane log files may be created in opt pdn OpenLane logs Solaris or opt pdn OpenLane logs Windows and can be disp...

Page 62: ...se of the command keeps your log files at a manageable size For example the command OLCmd clean logs log 14 executed in the OpenLane home directory performs two functions It Renames any file in the Op...

Page 63: ...rch devices and refresh the lower frame Devices selected according to your criterion are listed in the lower frame 3 If there are devices listed in the lower frame that you do not want to be part of t...

Page 64: ...7 OpenLane Maintenance 7 12 January 2002 7800 A2 GB32 00...

Page 65: ...wnload the appropriate firmware file or files If the firmware file is a exe file it is a self extracting zip file Unarchive it on a Windows platform and if it will reside on a Solaris platform use FTP...

Page 66: ...y name with fw and follow with the device model number For example mkdir fw9880 2 Retrieve the firmware as described in Building a Firmware Library on page 8 1 3 Copy any firmware dat file into the di...

Page 67: ...odel number to the device type The syntax is model devicetype where devicetype is one of dbm Dial Backup Module dslaan GranDSLAM Access Node also used for older DSL dslasn Service Node dsldsn 5620 631...

Page 68: ...eature Maintenance screen appears Select Schedule firmware downloads activations The Schedule Downloads and Firmware Activations screen appears 2 Select one or more devices of the same model or enter...

Page 69: ...the tasks immediately or Scheduling tasks an amount of time can be specified for the maintenance window If the firmware download process has not started within the specified time set in the maintenan...

Page 70: ...8 Building and Using a Firmware Library 8 6 January 2002 7800 A2 GB32 00...

Page 71: ...database OLCmd dbcopy on page A 12 Copies data from one database instance to another OLCmd dbip on page A 13 Translates IP addresses from a string to an integer and vice versa OLCmd dbroll on page A 1...

Page 72: ...on page A 31 Displays OpenLane log files OLCmd xmlreport on page A 33 Generates OpenLane reports in XML format OLCmd must be executed in the OpenLane home directory For example in Windows cd opt pdn o...

Page 73: ...heduled reports schedreports The customer may view scheduled reports on devices network The customer may use the Network Navigator and view log files allcustreports The customer may view all on demand...

Page 74: ...of customers to the database with the same characteristics as those of the customer Exact_Corporation OLCmd addcust a realtime l customer_list txt t Exact_Corporation The file customer_data txt contai...

Page 75: ...ion OLCmd assigndev c Exact_Corporation a 137 16 255 5 The following command assigns a group of devices which are listed in the file exact_devices txt OLCmd assigndev c Exact_Corporation l exact_devic...

Page 76: ...ing domains to ftp OLCmd chgrawfileext o raw e ftp The following command renames bad files on the polling domain named dallas to raw OLCmd chgrawfileext d dallas o bad e raw d polling_domain Is the po...

Page 77: ...an logs log 7 The following command moves files in the opt apache logs directory named log to log_ date admin for example jserv log_2001_05_13admin and deletes any log_ date admin files older than 21...

Page 78: ...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 OLCmd confauth on on Specifi...

Page 79: ...f days in the system wide preferences preferences dat raw days Optionally specifies the age in days of the oldest Raw quarter hourly user history data record to be retained This overrides the Save Raw...

Page 80: ...udscape c or Oracle o a instance Alters the options specified on a specific database instance If a is omitted the default database is assumed c new instance Creates a new database instance If the c pa...

Page 81: ...spath for connections to work err number Specifies the vendor specific JDBC error number to ignore for duplicate keys If not set or correct duplicate key warnings are logged sm statmap Specifies the f...

Page 82: ...command enter the command OLCmd dbcopy d OracleStatsDB from_instance Specifies the database instance in the naming directory service to copy data from to_instance Specifies the database instance in t...

Page 83: ...four decimal integers separated by periods or a dotted decimal address into a single integer Format OLCmd dbip address Where Example The following are valid uses of the dbip command shown with respons...

Page 84: ...e default database is used s start_time Optionally specifies the start time of statistics to be rolled up in the form YYYYMMDDhhmmss Example 20011012235959 denotes one second before midnight 23 59 59...

Page 85: ...customer IDs on separate lines Rent a Phone com Rent a Phone_GmbH Rent a Phone_USA The following command deletes from the database all the customer IDs in the ex customer txt file OLCmd delcust l ex...

Page 86: ...lete 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 circuits...

Page 87: ...standard output The dumpldap command also uses the environmental variable LDAP located in the file OLControlConfig Solaris or OLControlConfig bat Windows to identify the socket used to connect to the...

Page 88: ...is or OLControlConfig bat Windows to identify the socket used to connect to the LDAP database Format OLCmd importldif h host ldif_file Where Example The following command imports data from an LDIF fil...

Page 89: ...key license_key Where Example The following command displays the expiration date of the OpenLane license key OLCmd key The following command sets the OpenLane license key to WZBCK AAM6E U898Q MX5HK O...

Page 90: ...istinguished Name DN used to bind to the directory w password Is the database password h host Is the name or IP address of the OpenLane management server p port Is the port used to connect to the LDAP...

Page 91: ...earchbase Is an attribute value denoting the starting point of the search F separator Is the character used as a separator between attribute names and values The default is an equal sign This paramete...

Page 92: ...md ldapsearch D c US w admin b c US L objectclass data alldata ldif v Specifies that debugging information should be returned d debug_level Specifies the level of detail of debugging information that...

Page 93: ...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...

Page 94: ...ed la_west txt OLCmd processreports customerlist la_west txt date date Is the optional starting date of the reports If date is not specified the current date is used enddate enddate Is the optional en...

Page 95: ...et community_name ip_address object_id Where Example The following command performs an SNMP get and displays the sysDescr MIB object OLCmd snmpget 135 26 10 37 1 3 6 1 2 1 1 1 0 community_name Is the...

Page 96: ...st displays sysDescr sysName sysContact and sysLocation Format OLCmd snmptest ip_address community_name Where Example The following command tests SNMP connectivity using a community name of nmswrite O...

Page 97: ...r the FTP session used to collect performance statistics p ftp_passwd Specifies the password for an FTP session initiated by ftp_user g groupid Specifies the group ID for the device s Enables SCM poll...

Page 98: ...anuary 2002 7800 A2 GB32 00 Example The following command synchronizes device 172 20 4 7 OLCmd sync 172 20 4 7 E Requests that endpoints already discovered be resynchronized O Specifies that circuit n...

Page 99: ...uses UHReader to read all collected user history poll files then stop OLCmd uhread c singleRead c command Specifies the action to be taken command may be one of singleRead Reads all collected user his...

Page 100: ...Exact_Corporation OLCmd unassigndev c Exact_Corporation a 137 16 255 5 The following command assigns a group of devices which are listed in the file exact_devices txt OLCmd unassigndev c Exact_Corpor...

Page 101: ...d ficw Fatal internal critical and warning messages are displayed full All messages are displayed If f is not specified all messages are displayed sd mm dd yyyy Is the optional starting date for log r...

Page 102: ...layed log_name Is the name of the log file to be displayed It is required unless the l option is used log_name may be one of AlarmConfigServer Alarm Configuration batch_slv_rpt Scheduled SLV Reports C...

Page 103: ...ommand generates a report The report request is in the file named request1234 xml and the report is written to a file named report_10122001 html OLCmd opt pdn openlane cust_requests request1234 xml op...

Page 104: ...A OLCmd Reference A 34 January 2002 7800 A2 GB32 00...

Page 105: ...applied to that report to reformat the output into different XML or into a totally different format Note that some web browsers such as Internet Explorer 5 can interpret XML in the correct hierarchic...

Page 106: ...rts DeviceReports Requests opt pdn OpenLane samples xml reports SlvReports Requests Writing an Interface to the Servlet The servlet expects a HyperText Transfer Protocol HTTP post with up to three par...

Page 107: ...nly for FrameSaver devices see the files in opt pdn OpenLane samples xml reports SlvReports Requests Examples of the outputs for those reports are in opt pdn OpenLane samples xml reports SlvReports Re...

Page 108: ...B Using XML to Produce Reports B 4 January 2002 7800 A2 GB32 00...

Page 109: ...inistrator tasks 7 1 Cloudscape log files 7 9 Cloudscape database backing up 7 2 confauth A 8 configuration uploading from device 7 11 creating password file 5 2 customer ID adding to LDAP database A...

Page 110: ...s 2 7 Windows 3 7 from Paradyne Web site Solaris 2 6 Windows 3 6 remotely using X 2 8 Solaris 2 1 2 5 Windows 3 1 3 5 introduction OpenLane SLM 1 1 J JRE Java Run Time Environment Solaris 2 3 Windows...

Page 111: ...4 user interface 6 1 Oracle distributed database v Oracle database rebuilding indexes 7 8 overview OpenLane SLM 1 1 P passwords 5 2 deleting 5 3 password file location 5 2 poller reader distributed c...

Page 112: ...Solaris 2 4 Windows 3 4 user access authentication 5 1 user history reader starting and stopping A 29 user IDs 5 2 user modified files 7 2 users adding profiles to OpenLane 6 4 V viewlog A 31 W Web se...

Reviews: