English dropdown-ico

Paradyne SLM 5.5 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Paradyne SLM 5.5, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Paradyne SLM 5.5 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Paradyne SLM 5.5. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Paradyne SLM 5.5 should contain:
- informations concerning technical data of Paradyne SLM 5.5
- name of the manufacturer and a year of construction of the Paradyne SLM 5.5 item
- rules of operation, control and maintenance of the Paradyne SLM 5.5 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Paradyne SLM 5.5 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Paradyne SLM 5.5, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Paradyne service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Paradyne SLM 5.5.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Paradyne SLM 5.5 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    OpenLane ® SLM 5.5 Administrator’ s Guide Doc ument No. 7 800- A2-GB32 -00 J anuary 2002[...]

  • Page 2

    A Januar y 2002 7800-A2- GB32-0 0 Copyrigh t © 200 2 P aradyne Corp orati on. A l l r i g h t s re s e rv e d . Printe d in U .S.A. Notice This pub l i catio n is prote cte d by f edera l cop yright la w . No part of this pub l ication ma y be c opi ed or di stributed, tr ansmi tted, tr ans cribed, st or ed in a retrie v al syst em, or tr anslat e[...]

  • Page 3

    7800-A 2-GB32-00 January 2002 i Contents Ab o u t T h is G u id e Document Purpose and Intend ed Audience . . . . . . . . . . . . . . . . . . . . v Documen t Summar y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Pr oduct -Relat e d Do cuments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi 1 Intro[...]

  • Page 4

    Conten t s ii January 2002 7800-A2- GB32- 00 3 Installing Op enLane o n W indows About These Instruction s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Planning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 In st a l l a ti on Re q u i r e m en t s . . . . . . . . . . . . . . . .[...]

  • Page 5

    Content s 7800-A 2-GB32-00 January 2002 iii 6 Adding Devices and Customer Prof iles Accessing the OpenLane Web A pplication s . . . . . . . . . . . . . . . . . . . . 6-1 Addi ng a Devi ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Addi ng a Cust o mer Pr o file . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 6

    Conten t s iv January 2002 7800-A2- GB32- 00 AO L C m d R e f e r e n c e OLCmd He lp s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 OLCmd addcus t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3 OLCmd ass igndev . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 7

    7800-A 2-GB32-00 January 2002 v About Th is G uid e Document P u rpose and Intended A udience This gui de con tains information a bout the Open Lane S er vice L ev el M anag eme nt (SLM) s ystem, V ersi on 5.5. It is designed both as an in trodu ction f or novice users and a ref erenc e for e xperie nced use rs of OpenLan e. Docume nt Summ ar y Sec[...]

  • Page 8

    Ab out Th is Gu ide vi J anuary 2002 7800-A2-G B32-00 A m aster glo ssar y of t er ms and abbreviations used i n P aradyne docum ents is av ail able online at www. pa radyne . co m . S e le c t Library → T echnical M anuals → T e chnical Gl ossary . Pr oduct-Related Do cument s Contact your s ales or serv ice represent ativ e to order additiona[...]

  • Page 9

    7800-A 2-GB32-00 January 2002 1-1 1 In tr oduc tio n to Op enLa ne SL M OpenLane SL M P ara dyne ’ s O penLan e ® Ser vice Lev el Manage men t (SLM) is an open, stand ard s- bas ed, hi g hly d istr ibut able sy st em of ferin g ro bust sc ala b ility a nd flexibilit y . A Web bro ws er-e na bled u se r int er face pro vid es a cces sib ilit y an[...]

  • Page 10

    1. Int ro duction to OpenLa ne SLM 1-2 Januar y 2002 7800-A2- GB32- 00 Op enL ane Featu res Easy-to-use Web browser-based user interface Suppor t f or the full arra y of P aradyne S NMP-m anage able de v ices Suppor t f or sev eral diff eren t le vel s of user access Easy-to-use graphical interface installs and c onfigures each mo dule E-commerc e-[...]

  • Page 11

    7800-A 2-GB32-00 January 2002 2-1 2 Inst all ing OpenLa ne o n So laris Abo ut The se I nst ructi o ns These inst ructions provide you wi th the n ecessar y informa tion to get your OpenLane S er v ice Lev e l Manag eme nt software installed and runn ing as quickly as possible . I nstallers should be f a miliar with Solaris and Solar is administrat[...]

  • Page 12

    2. I nstall i ng Ope nLane on Sol aris 2-2 Januar y 2002 7800-A2- GB32- 00 Installatio n Requi r ements Re vie w the f ollowing Minimum Hardware Requirements and Soft ware Requiremen ts to v erify that you m eet the prerequ isites. Minim um Har d war e Requir ements Softwa r e Requir eme nts Sun Solaris 2.6 or 2.8 operating system (Solaris 2.7 is n[...]

  • Page 13

    2. In sta ll i ng OpenLan e on Solari s 7800-A 2-GB32-00 January 2002 2-3 Checking the J a va Runtime En vir onme nt V ersion Before inst allin g the Ope nLane S er vic e Lev e l M ana gem ent s oftware, you nee d t o veri fy that the J a va Runtime Environment (JRE) has been installed correctly . Proced ure T o verify the JRE installation: 1. Open[...]

  • Page 14

    2. I nstall i ng Ope nLane on Sol aris 2-4 Januar y 2002 7800-A2- GB32- 00 Upgr adi n g from Ea rl ie r Sof tw are If y ou are i nstalling OpenLane on a system that is c urrently running: DCE Ma nage r , see Uninstalling DCE Man ager , bel ow . P er formance Wizard 4.2 , see Uninstalling P e rf or ma nce Wizard , below . An earl i e r ve rsio n of [...]

  • Page 15

    2. In sta ll i ng OpenLan e on Solari s 7800-A 2-GB32-00 January 2002 2-5 The Ope nLa ne Instal l ati on Progr am T o i nstall OpenL ane and the A pache Web ser ver , ex ecute the Open Lane setup.sh program. F ollow the instr uctions a nd res pond to the qu erie s it p resents. The OpenLane inst allation program: Optiona lly installs a nd con figur[...]

  • Page 16

    2. I nstall i ng Ope nLane on Sol aris 2-6 Januar y 2002 7800-A2- GB32- 00 NO TES : — Y ou do not ha ve to install the Apache Web ser v er in /opt/apache and OpenLane in /opt/pdn/ OpenL ane. How e ver , it is highly recomm end ed th a t you inst all Apache and OpenL ane on the sam e mount point. If you d o not use the standard director y names, s[...]

  • Page 17

    2. In sta ll i ng OpenLan e on Solari s 7800-A 2-GB32-00 January 2002 2-7 Ins talling fr om CD-R OM Proced ure 1. Log on to the system as root . 2. Exit y our Web b r owser if it is running. Inser t the OpenL ane CD-ROM into the CD-ROM dri v e and m ount i t. 3. Change to the CD-R OM dr ive . 4. Change to the OpenLane direct or y and run t he setup[...]

  • Page 18

    2. I nstall i ng Ope nLane on Sol aris 2-8 Januar y 2002 7800-A2- GB32- 00 Installing Remote ly Usin g X Y ou can i nstall O penLa ne from a remote host u sing the X W indow Sys tem. Proced ure 1. On the local host, e xecute the f ollowing commands: xhost + remote_hos t_name rlogin remote_hos t_name -l username user nam e must ha ve root privilege.[...]

  • Page 19

    2. In sta ll i ng OpenLan e on Solari s 7800-A 2-GB32-00 January 2002 2-9 Loca ting th e License K e y On an Installed System T o locate the license k ey on the syst e m once Open Lane is installed, use one of these m ethods: Displa y the Op enLane About screen by clicki ng the Abou t Op e nLane Service Level Managem e nt link on the OpenLane A dm [...]

  • Page 20

    2. I nstall i ng Ope nLane on Sol aris 2-10 Januar y 2002 7800-A2- GB32- 00 Starting Op enL ane W eb and Database Services Proced ure 1. F rom a t er minal window , c hange the director y to /opt /pdn/OpenL ane: cd /opt/pdn/OpenLane 2. T ype OLControl start and pres s Enter . The fol lo wing ser vices are star te d: — Apache Web Ser ver — Cloud[...]

  • Page 21

    2. In sta ll i ng OpenLan e on Solari s 7800-A 2-GB32-00 January 2002 2-11 Con fig u ri n g Apa che to U s e a D i fferen t Port By default, the A pache Web ser ver is installed a nd c on figured to use T CP po r t 80 (unless you changed it at ins tallation time). Y o u can configure the A pache Web ser ver to use an other por t after inst allation[...]

  • Page 22

    2. I nstall i ng Ope nLane on Sol aris 2-12 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 23

    7800-A 2-GB32-00 January 2002 3-1 3 Inst all ing Op enLane o n Windows Abo ut The se I nst ructi o ns These inst ructions provide you wi th the n ecessar y informa tion to get your OpenLane S er v ice Lev e l Manag eme nt software installed and runn ing as quickly as po ssible . Installers shoul d be f amiliar with W indows adm inistration. Pla nni[...]

  • Page 24

    3. I nstall i ng Ope nLane on Win dows 3-2 Januar y 2002 7800-A2- GB32- 00 Installatio n Requi r ements Re vie w the Minimum Ha rdware Requi rements and to v erify that you m eet the prerequisites. Minim um Har d war e Requir ements Softwa r e Requir eme nts Windows NT 4. 0 with Ser vice Pac k 5 or higher – or – Windows 2000 Ser ver with Servic[...]

  • Page 25

    3. Inst al l ing OpenL ane on W indows 7800-A 2-GB32-00 January 2002 3-3 W eb Client Sof twar e Requir ement s Internet Explorer V ers ion 5.5 (f o r Win dows-based clients) – or – Netscape Com municator V ersion 4.76 or 4. 78 (for Solaris-based clien ts) Checking the J a va Runtime En vir onme nt V ersion Before inst allin g the Ope nLane S er[...]

  • Page 26

    3. I nstall i ng Ope nLane on Win dows 3-4 Januar y 2002 7800-A2- GB32- 00 Upgr adi n g from Ea rl ie r Sof tw are If y ou are i nstalling OpenLane on a system that is c urrently running: DCE Ma nage r , see Uninstalling DCE Man ager , bel ow . P er formance Wizard 4.2 , see Uninstalling P e rf or ma nce Wizard , below . An earl i e r ve rsio n of [...]

  • Page 27

    3. Inst al l ing OpenL ane on W indows 7800-A 2-GB32-00 January 2002 3-5 The Ope nLa ne Instal l ati on Progr am T o inst all Op enLane and the Apa che Web ser ver , ex ecute the Open Lane setup.exe progr a m. Fo llow th e instruct ions and res pond to the quer ies it pres en ts . When in stallation o f Open Lane is compl ete, restar t Windows. The[...]

  • Page 28

    3. I nstall i ng Ope nLane on Win dows 3-6 Januar y 2002 7800-A2- GB32- 00 Obtainin g the L icense K ey An O penLan e licens e ke y is required t o install OpenL ane. Y ou can reque st a temporar y license key f rom the P aradyne Web s i te at www.paradyne.com/pdn/key . Ins talling fr om Paradyne ’ s W e b S i te Proced ure 1. Log on to the W ind[...]

  • Page 29

    3. Inst al l ing OpenL ane on W indows 7800-A 2-GB32-00 January 2002 3-7 Ins talling fr om CD-R OM Proced ure 1. Log on to the W indows syst em as an administrat o r . 2. Exit y our Web b rowser if it i s ru nning. 3. Inser t the Open Lane CD-ROM into the CD-R OM dri ve. 4. Change to the OpenLane direct or y on the CD-ROM driv e and run the setup.e[...]

  • Page 30

    3. I nstall i ng Ope nLane on Win dows 3-8 Januar y 2002 7800-A2- GB32- 00 Displaying the L icense K ey Expiration Date Y ou can view your li cense key ’ s e xpiration date at any time using the key f unctio n of OL Cmd. Proced ure 1. Open an M S -DOS P rom pt and chang e t o the Op enLane di rector y . 2. Enter the command: OLCmd key The expirat[...]

  • Page 31

    3. Inst al l ing OpenL ane on W indows 7800-A 2-GB32-00 January 2002 3-9 Starting Op enL ane W eb and Database Services OpenLane run s as a Windows serv ice. It star ts automa tically when Windows does, whether or not a user has logged in to Windows. If you h ave shu t down the OpenLane Mo nitor serv ice m anually (see Stopping OpenLane Web and Dat[...]

  • Page 32

    3. I nstall i ng Ope nLane on Win dows 3-10 Januar y 2002 7800-A2- GB32- 00 Stopping OpenL ane W eb and Database Services Use the Ser vices mana gem ent screen to shut down OpenLane. Since the OpenLDAP Director y S er vice is dep endent o n the Ope nLane M onitor Ser v ice, OpenLDAP shou ld be s hu t down rath er than Ope nLane Monit or . Proced ur[...]

  • Page 33

    3. Inst al l ing OpenL ane on W indows 7800-A 2-GB32-00 January 2002 3-11 Con fig u ri n g Apa che to U s e a D i fferen t Port By defaul t the Apache Web ser ver is inst alled and configured to use TCP por t 80. Y ou can choose to con figure the Apache Web ser ver to us e any por t y ou wish as long as that por t is not in use by another serv ice.[...]

  • Page 34

    3. I nstall i ng Ope nLane on Win dows 3-12 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 35

    7800-A 2-GB32-00 January 2002 4-1 4 Conf iguring Distributed Componen ts OpenLane Distributed C omponent s OpenLane provides a highly di str ib utab le framework. Distr ibution of Open Lane functions can be used to share workload ov er sev e ral servers, and to provide a more secure configuration. This chapter descr ibe s: Distributing the W eb ser[...]

  • Page 36

    4. Conf iguri ng Dis trib ute d Components 4-2 Januar y 2002 7800-A2- GB32- 00 Setting Up W eb Server Di strib ution With OpenLane, Web S er v e r functionality can be distributed to another ser ver to offload the t ask of ser ving Web pages or provide a m ore secure conf iguration. T he Web Server and the Open Lane Ma nagem ent Server can be Solar[...]

  • Page 37

    4. Co nf iguri ng Distr ibuted Compon ents 7800-A 2-GB32-00 January 2002 4-3 3. On the OpenLa ne ser ver (172.20.1.20), edit the jser v .pro per ties file: — Sola ris: Edi t th e /opt/apache/conf/jserv.properties f il e a nd a dd the address o f th e Web ser ver to t he security.allowedAddresses directive: secu ri ty .al lo we dA dd re ss es =12 [...]

  • Page 38

    4. Conf iguri ng Dis trib ute d Components 4-4 Januar y 2002 7800-A2- GB32- 00 6. On th e Web ser ver (172. 20.1.10): — Sola ris: Edi t th e /opt/apache/conf/jserv.conf file. M odif y these directives: ApJS er vM anu al O n ApJS er vD efa ul tH os t 17 2. 20 .1. 20 ApJS er vM oun t /O LS er vl et s ajp v1 2: // 17 2. 20 .1 .20 /O LS er vl et s Ap[...]

  • Page 39

    4. Co nf iguri ng Distr ibuted Compon ents 7800-A 2-GB32-00 January 2002 4-5 Se ttin g Up th e Di stri b uted P oll er and R ea der OpenLane allows y ou to offload the P oller and Reader functions from the main Solar is OpenLan e s er ver to ano ther S olar is hardware plat f o rm . T he f ol lo wing procedures use this diagram to illustrate the di[...]

  • Page 40

    4. Conf iguri ng Dis trib ute d Components 4-6 Januar y 2002 7800-A2- GB32- 00 7. Restar t OpenLan e: cd /opt/pdn/OpenLane OLControl start 8. Define the location of t he database. Use the appropriate comman d for your database type: OLCmd dbconfig ‘-m 172.20.1.10’ (Cloudscape ) OLCmd dbconfig ‘-m 172.20.1.10:1521’ (Oracle) 9. Define the loc[...]

  • Page 41

    4. Co nf iguri ng Distr ibuted Compon ents 7800-A 2-GB32-00 January 2002 4-7 Distri buted Poller/Reader — P oller/Reader Setup Proced ure P e rform the f ol lo wing steps o n t he pros pective Distributed P o ller/Reader platf orm (172.20.1.20 in t he ex a mpl e diagram). 1. Install O penLane on t he Distributed Pol l er platf o rm . Do not insta[...]

  • Page 42

    4. Conf iguri ng Dis trib ute d Components 4-8 Januar y 2002 7800-A2- GB32- 00 5. Stop OpenLane : OLControl stop If OpenLane does not shut down within two m inutes, proceed with the next step regardlessly . 6. Reboot the ser ver . 7. Mo unt t he director y: mount -F nfs -o rw 172.20.1.10:/opt/pdn/OpenLane/uhpoller/poller_poller1 /opt/pdn/OpenLane/u[...]

  • Page 43

    7800-A 2-GB32-00 January 2002 5-1 5 A pache User Access A uthentication Use r Acce ss A uthen ti catio n User access a uthentication i s used to s pecify wh o ha s ac cess t o the Web ser ver . When authenticat ion is enabled on the Web server , it aff ect s all users of the syste m. There are many mechanisms that can be used to set user access. Hy[...]

  • Page 44

    5. Apache User Access Auth entication 5-2 Januar y 2002 7800-A2- GB32- 00 Conf iguring HTT P Challenge/R esponse F ollow t his procedure to configure HTTP Challenge/Res ponse for OpenLane access authenticat ion with the Apache Web s er ver . Proced ure 1. If OpenLane is runnin g, stop it. 2. Find the director y where Apache is installed. This is t [...]

  • Page 45

    5. Apac he User Ac cess Authent ication 7800-A 2-GB32-00 January 2002 5-3 Where user nam e is the name of the use r being added. For example: htpasswd -c /opt/pdn/OpenLane/database/config/.htpasswd Admin Add a dditional us er na mes by runn ing the htpasswd p rogram without the -c option. If additional help is needed, run the .htpa ss wd progr a m [...]

  • Page 46

    5. Apache User Access Auth entication 5-4 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 47

    7800-A 2-GB32-00 January 2002 6-1 6 Addi n g De vices and Custom er Pr of iles Accessing the OpenLa ne W e b A pplications Proced ure 1. Using your W eb browser , enter the URL of the OpenLane system . Exampl e: http://172.24.9.1/OpenLane/ NO TE: Y ou can use t he IP addres s or the ho st machine n ame in t he URL to access the OpenLa ne system. Op[...]

  • Page 48

    6. Addi ng Devices and Customer Prof iles 6-2 Januar y 2002 7800-A2- GB32- 00 Adding a Device Proced ure T o add a device to the OpenLan e System: 1. If you h ave n ot already done so , log in to the OpenLane system with the customer ID of: Admin 2. On th e O penLa ne Adm inistration scr een, select Network Dia g nostics . 3. Select t he New Device[...]

  • Page 49

    6. Adding Devi ces an d Custo m er Prof ile s 7800-A 2-GB32-00 January 2002 6-3 Ne w De vic e Field Names Field Description* IP Address IP Address of the de vice bein g added. Read Communi ty Read Communi t y Name mus t matc h the Read Comm uni ty Nam e set in the de vice. Def ault = pub l i c. Write Comm uni t y Wr ite Community Name mu st match t[...]

  • Page 50

    6. Addi ng Devices and Customer Prof iles 6-4 Januar y 2002 7800-A2- GB32- 00 5. Modify fields as desired. Make s ure Discovered c ircuits and endpoin ts is check ed and click on S ave and Sync . 6. Use the Device Browser or DS LAM Devi ce Displa y to v erify that t he devi ce is added pro perly and endpoi nts and circuits are discov ered. See the [...]

  • Page 51

    6. Adding Devi ces an d Custo m er Prof ile s 7800-A 2-GB32-00 January 2002 6-5 5. The f ollowing f orm a ppears: 6. Fill in t he customer information in the fi elds provided. No fields are required, bu t Customer N ame and Ac count # will no t appea r on repor ts if they are l eft bl ank here. 7. Under 2. Select a system access level , specify one[...]

  • Page 52

    6. Addi ng Devices and Customer Prof iles 6-6 Januar y 2002 7800-A2- GB32- 00 — Netw ork – The c ustome r can a ccess the Networ k Navigator and view lo g fi le s. — All Cu stomer Repor ts – The customer can view on-demand and scheduled repor t s f o r all customer IDs. 8. Clic k on the Sa ve button to save the cust omer profile. 9. Assign [...]

  • Page 53

    7800-A 2-GB32-00 January 2002 7-1 7 OpenL ane M aint ena nce The f o llowing tasks are the responsibility of the Ope nLane adm ini strator: T ask Impo rtanc e Ide a l Frequency Back up user - modif ied fi les . See Backi ng Up Ope nLane Fil e s on page 7-2. Recommend ed When y ou add or modify: Customer profiles or d evi ces Pa s s wo r d s Firmwar[...]

  • Page 54

    7. OpenLan e Maint enanc e 7-2 Januar y 2002 7800-A2- GB32- 00 Backi ng U p Ope n La ne F il es Directories that ca nnot be restored by reinstalling OpenLa ne should be backed up per iodically for saf e keeping. These m ay include directories listed in T able 7-1 . Directories shown he re are the recom m ended in stallation d irectories f or OpenLa[...]

  • Page 55

    7. OpenLane Maintenanc e 7800-A 2-GB32-00 January 2002 7-3 Backing Up OpenLa ne Under Solaris Proced ure T o back up files under Solaris: 1. Create a te xt fil e (called back u p .t xt in this e x ample) listing the director ies to be back ed up . F or ex ample: /opt/pdn/OpenLane/data /opt/pdn/OpenLane/database /opt/pdn/OpenLane/web/cgi-bin /opt/pd[...]

  • Page 56

    7. OpenLan e Maint enanc e 7-4 Januar y 2002 7800-A2- GB32- 00 Backing Up Open La ne Under Windows Windows pro vides no tool f or compress ing files, b ut add-on archiving software i s readily av ailab le. Use it t o creat e a backup of t he directori es listed in Ta b l e 7 - 1 , Directories That Ma y Contain User-Mo dified Files , that contain al[...]

  • Page 57

    7. OpenLane Maintenanc e 7800-A 2-GB32-00 January 2002 7-5 Deleting Older Records fro m the Data base The dba ge function of OLCmd has f our m odes : The -d parameter causes records to be deleted according to individual de v ice definitions (the Sav e Repor t Data Fo r and Sav e Raw Data For v alues se t when each device was added) The -a parameter[...]

  • Page 58

    7. OpenLan e Maint enanc e 7-6 Januar y 2002 7800-A2- GB32- 00 Generating S cheduled Repo rts T o gene rate sched uled repor ts, run the pr o cessr epor ts function of OLCmd. The proces srepor ts application c an gene rate repor t s ba sed on a date range. This allows , for e x ample, s e v e ral days ’ w or t h of repor ts to be generated at onc[...]

  • Page 59

    7. OpenLane Maintenanc e 7800-A 2-GB32-00 January 2002 7-7 Us ing A T u nder W ind ows to A utomat e Repo rts Proced ure 1. Using a te x t editor , create a batch scr ipt in the c:optpdnOpenLa ne director y that contai ns the comm and s y ou would ordinar ily use to ge nerate rep or ts. For exam ple, to create repor t s f or all customers, add t[...]

  • Page 60

    7. OpenLan e Maint enanc e 7-8 Januar y 2002 7800-A2- GB32- 00 Reb u ilding O racle Database Indexes As records are added to and deleted from the database, index es may become fragmented and index trees may increase in height, sl owing access to the database. The ol _r bldi dx. sql sc r i p t r e bui l d s in d exes to ma in t a i n perfo r ma nc e[...]

  • Page 61

    7. OpenLane Maintenanc e 7800-A 2-GB32-00 January 2002 7-9 Mon it o ring Log File s The fol lowing log file s can be viewed from th e View Log Files s creen, or by running th e viewlog func tion of OLCmd. Defau lt Polling Do ma in Additional P oll ing Domains (if any e x ist) Firm ware/Configuration /F eature Maintenance Database Reader P o ller C [...]

  • Page 62

    7. OpenLan e Maint enanc e 7-10 Januar y 2002 7800-A2- GB32- 00 Legacy Logger L og Files These f iles are c reated if p dn.uhp oller .legacyLo gger is en abled (set to t r ue) in preferences. da t : Sola ris: /opt/pdn/OpenLane/logs/UHReader.log /opt/pdn/OpenLane/logs/UHPoller_default.log Windows: c:optpdnOpenLanelogsUHReader.log c:optpdnOpe[...]

  • Page 63

    7. OpenLane Maintenanc e 7800-A 2-GB32-00 January 2002 7-11 Uploadi n g Configurat ion s Y ou can maintai n a libr ar y of configuration files so t hat in the e vent a de vice must be replaced, its configuration can be loaded into the ne w hardware quickly and without discrepancy . Use the Schedule Configuration Upload screen to schedule or immedia[...]

  • Page 64

    7. OpenLan e Maint enanc e 7-12 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 65

    7800-A 2-GB32-00 January 2002 8-1 8 Buildin g and Us ing a Firm ware Library Building a Firmwa re Librar y OpenLane al lows y ou to maintain a firm ware library from which you can download fir mware to devices in your net work. Bef ore the Downl oad Feat ure can schedule or activ at e fir mware download to a de vice , y o u must ret rie ve the firm[...]

  • Page 66

    8. Buildi ng and Using a Firmware Libr ary 8-2 Januar y 2002 7800-A2- GB32- 00 New De vice Models Not Supported by OpenLane Y ou can cr eate your o wn subdirector y and definition files for Paradyne dev ices not yet suppo r ted by OpenLan e. T he dev ice m odel number w ill appe ar in the drop-down De vi ce Model selection list for schedu ling down[...]

  • Page 67

    8. Buildi ng and Using a Firmwar e Libr ar y 7800-A 2-GB32-00 January 2002 8-3 5. Edit the /opt/pdn/OpenLane/database/firmware/mtypes.dat (Solaris) or c:optpdnOpenLanedatabasefirmwaremt ypes.dat (Windows) file to map the device mode l number to t he device type. The syntax is: model=devicetype where devi cetype is one of: dbm – Dial Bac kup[...]

  • Page 68

    8. Buildi ng and Using a Firmware Libr ary 8-4 Januar y 2002 7800-A2- GB32- 00 Downloading a nd A ctivating F irmwa r e Use the Schedule Downloads and Fir mware Activat ions screen to administer firmware f o r se lect e d de vice s . Proced ure 1. Select F irmw are/ Con f igurat ion /F eatur e Ma inte n ance f rom t he OpenL ane Home Page . The Fir[...]

  • Page 69

    8. Buildi ng and Using a Firmwar e Libr ar y 7800-A 2-GB32-00 January 2002 8-5 4. Select Make the firm ware active (this causes a device reset) if y ou w ou ld lik e to activate t he firmware imm ediately . The Alter nate Firm ware becomes the Active Firm ware, f ol lowed by a device reset. If do not want to activate the new fi r m w ar e ye t, u n[...]

  • Page 70

    8. Buildi ng and Using a Firmware Libr ary 8-6 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 71

    7800-A 2-GB32-00 January 2002 A-1 A OLCmd Refer ence OLCmd (OLCm d.bat in Windows) is t he comma nd line interf ac e f or OpenLane. OLCmd comm and s include: OLC m d addc ust on page A-3 – Adds custome r s to the OpenLane LD AP database. OLCmd assi gndev o n pa ge A -5 – Assi gns d e vice s to cust omers. OL C m d ch g r aw fi l e ex t on page [...]

  • Page 72

    A. OLCmd Reference A-2 Januar y 2002 7800-A2- GB32- 00 OLCm d processrepor ts o n p age A-24 – Gen erates sched uled repor ts . OLC md snm pget on pag e A -25 – Gets an SNMP ob jec t. OLCmd snmp test o n pa ge A-26 – T ests SNM P conne ction. OLCmd sync on pag e A -27 – Synchronizes a device. OLC m d uh re ad on pag e A -29 – Star ts and [...]

  • Page 73

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-3 OLCmd a ddcust The addcust com mand ad ds cust omers to the LDAP datab ase. Fo r m a t: OLCmd addcust -a access_l ev el [ [ -c cust omer_i d ] | [ -l customer_lis t ]] [ -o customer_de tails ] [ -t tem p la te ] Where: -a access_l ev e l Is the access le v el o f t he cu stomer or custome rs to [...]

  • Page 74

    A. OLCmd Reference A-4 Januar y 2002 7800-A2- GB32- 00 Ex amples : The following command ad ds a single custome r to t he LD A P d atabas e with a Re a l t i m e a c ce ss leve l : OLCmd addcust -a realtime -c Exact_Corporation The file customer_list.txt contains sev er al customer IDs on separate lines: Rent-a-Phone.com Rent-a-Phone_GmbH Rent-a-Ph[...]

  • Page 75

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-5 OLCmd a ssigndev The ass igndev command assig ns de vices to a customer ID . Fo r m a t: OLCmd assigndev -c customer_nam e [ -a devi ce_ad dress ] | [ -l device_l ist ] Where: Exampl e: The following command ad ds a single device to cus tome r Exac t_Cor poration: OLCmd assigndev -c Exact_Corpor[...]

  • Page 76

    A. OLCmd Reference A-6 Januar y 2002 7800-A2- GB32- 00 OLCm d c hgraw fi leext The chgrawfileext comm and ch anges the file ext ensions of ra w data files on seleted polling dom ains. Fo r m a t: OLCmd chgrawfileext [ -d po lling _domain ] [ -o current_extension ] [ -e ne w_extension ] Where: Exampl e: The f o llowing command renames all .ra w file[...]

  • Page 77

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-7 OLCmd cl ean The clean command c reates archive c opies of specified log files and deletes archived files older t han a specified age. Fo r m a t: OLCmd clean director y extension days [ ne w-e xtension ] Where: Exampl e: The fol lowing comm and mov es files in the optpdnopen lanelogs dire [...]

  • Page 78

    A. OLCmd Reference A-8 Januar y 2002 7800-A2- GB32- 00 OLCmd c onfauth The confau th command c onfigures OpenL ane for use in a system with Apache user a ccess authentic ation. Fo r m a t: OLCmd confauth on | of f Where: Exampl e: T o configure OpenLane for use i n a system with Apache user access authenticat ion: OLCmd confauth on on Specifies t h[...]

  • Page 79

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-9 OLCmd dba ge The dba ge comm and removes older records from the pe rf ormance s tatistics database. Fo r m a t: OLCmd dbage [ -n instance ] [ [ -d | -a ] | [ [ -raw days ] [ -rpt da ys ]] | -dd ] Where: Ex ample: T o delete Rep or t dat a records ol der than 90 days and Raw data records older th[...]

  • Page 80

    A. OLCmd Reference A-10 Januar y 2002 7800-A2- GB32- 00 OLCmd dbc onf i g Inf or m ation that OpenL ane us es to connect to a database is stored in a naming/direct or y ser vice. The dbcon fig command creates or modifies the naming/direct or y ser vice dat abase entr y that p oints to the perfor mance statistics database. Fo r m a t: Sol aris: OLCm[...]

  • Page 81

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-11 Adv anced Par am et ers: Exampl e: T o change the default database to Oracle and set the databas e paramet ers, enter the com mand: OLCmd dbconfig '-d o -m mycomputer.mycompany.com:1521 -n mydb -u myself -p mypassword' -url Specifies the data base con nection UR L i n raw f orm. It ma[...]

  • Page 82

    A. OLCmd Reference A-12 Januar y 2002 7800-A2- GB32- 00 OLCmd dbc opy The db cop y c omm and copie s all the data in one databa se instance define d in the naming/director y ser vice to a noth er da tabase in stance. It can be used, f or exam ple, to con ver t an outgrown Cl ouds cape dat abase to an Oracle database. Fo r m a t: OLCmd dbcopy [ from[...]

  • Page 83

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-13 OLCmd dbi p IP addresses are maintained in the statistics database as single decimal integers. F or e xam pl e, the I P address 135.2 6.10.37 is maintained in the databas e as – 2028336603. T he dbi p comm and conver ts a s ingle integer into a dotted decimal address (four decima l integers s[...]

  • Page 84

    A. OLCmd Reference A-14 Januar y 2002 7800-A2- GB32- 00 OLCmd dbroll User history s tatistics are stored b y 15-m inute intervals. T o speed up the processing of S L V repo r ts, and to reduc e the size of t he d atabase, you can rol l u p statistics into hourly inter v a ls b y using the db rol l function of OLCmd. Fo r m a t: OLCmd dbroll [ -d da[...]

  • Page 85

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-15 OLCmd de lcust The de lcu st comma nd allows y ou t o delete a customer or a list of customers f rom the da tabase. Fo r m a t: OLCmd delcust [ -c cu st o m e r ] | [ -l cu st o m e r - lis t ] Where: Exampl e: The file e x-custom ers.txt contains customer IDs on separate lines: Rent-a-Phone.co[...]

  • Page 86

    A. OLCmd Reference A-16 Januar y 2002 7800-A2- GB32- 00 OLCmd de lde v The del de v command allows y ou to delete a de vice and all associated circuits from the database. Fo r m a t: OLCmd deldev ip_address Where: Exampl e: The fol lo wing command d eletes the dev i ce whos e IP addres s is 135.26. 10.37 and all its cir c uit s. OLCmd deldev 135.26[...]

  • Page 87

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-17 OLCmd dum pldap The dum p ld ap command creat es an LDA P Dat a Interchange Format (LDIF) fi le from the LD AP database. The file m a y be used for expor t to a diff erent director y server syst em. The file created is written t o standard output . The dumpl dap command also us es the environme[...]

  • Page 88

    A. OLCmd Reference A-18 Januar y 2002 7800-A2- GB32- 00 OLCmd imp or tl dif The i mp o r t ld if comm and adds ent rie s to an LD AP database based on an LD AP Data Interchange Form at (LDIF) file. The impor tldif comma nd also uses t he environm ental variabl e LD AP , located in the file OLCon trolConfig (S olaris) o r OL Cont rolConfig.bat (Wi n[...]

  • Page 89

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-19 OLCmd key The key command sets the OpenLa ne license ke y , or t ests the current k ey to deter mi ne its expir a tion date. Fo r m a t: OLCmd key [ license_key ] Where: Exampl e: The following command di splays the expiration dat e o f the O penLan e l icense ke y: OLCmd key The f o llowing co[...]

  • Page 90

    A. OLCmd Reference A-20 Januar y 2002 7800-A2- GB32- 00 OLCmd lda pmod if y The ldapmo dify command adds or modif es entrie s in the LDAP database. It accepts input from the STDIN stream. Fo r m a t: OLCmd ldapmodify [ -D bindDN ] [ -w password ] [ -h host ] [ -p por t ] [ -F ] [ -a | -r ] [ -b ] [ -c ] [ -v ] Where: Exampl e: The file new . ldif c[...]

  • Page 91

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-21 OLCmd lda psea r ch The ldap search comm and retr iev es data from the LD A P database bas ed on search crit e ria. Fo r m a t: OLCmd ldapsearch [ -n ] [ -D bindDN ] [ -w password ] [ -h host ] [ -p por t ] [ -b searchbase ] [ -F separator ] [ -S sort _attrib ] [ -l time _lim it ] [ -z size _ l[...]

  • Page 92

    A. OLCmd Reference A-22 Januar y 2002 7800-A2- GB32- 00 Exampl e: The f o llowing command e xpor ts the entire database to an LDIF f i le: OLCmd ldapsearch -D c=US -w admin -b c=US -L objectclass=* > data/alldata.ldif -v Specifies t hat d ebugging inf o r mation shoul d be retur ned. -d debug_l evel Specifies the le vel of det ail of deb ugging [...]

  • Page 93

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-23 OLCmd logs v c The log svc com mand sets the IP addres s of the log ger when distributed logging is used. Fo r m a t: OLCmd logsvc ip_address Where: Exampl e: The f o llowing command sets the IP address of the l ogger : OLCmd logsvc 135.26.10.37 ip_address Is the address of the host that will s[...]

  • Page 94

    A. OLCmd Reference A-24 Januar y 2002 7800-A2- GB32- 00 OLCm d processre ports The processrep orts com man d generates sche duled repor ts f or spec ified customers a nd d ates. Fo r m a t: OLCmd processreports [ -date date ] [ -enddate enddat e ] [ -customer customer_id ] [ -customerlist list _fi le ] Where: Exampl e: The f o llowing command gener[...]

  • Page 95

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-25 OLCm d snmp get The snm pget co mmand perfor ms an SNMP get on a specified MIB object. Fo r m a t: OLCmd snmpget [ communi ty_name ] ip_address ob ject_id Where: Exampl e: The f o ll owi ng command per f or ms an SNMP get and displa ys the sysDescr MIB object: OLCmd snmpget 135.26.10.37 1.3.6.1[...]

  • Page 96

    A. OLCmd Reference A-26 Januar y 2002 7800-A2- GB32- 00 OLCmd snmpte st The snm ptest command tests SNMP connec tivity using a specified commu nity name. If successful, snmptest displa ys sysDescr , sysNam e , sysContact, and sysL ocati on. Fo r m a t: OLCmd snmptest ip_address [ co mmun it y _na me ] Where: Exampl e: The f o llowing command tests [...]

  • Page 97

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-27 OLCmd sy nc The sync co mmand s ync hronizes a specified dev i c e and the database. If the device i s not in the database, i t is added. Fo r m a t: OLCmd sync [ [ -v ] [ -c communit y-strin g ] [ -w co m mu n i ty -s tr in g ] [ [ -i ftp_user ] [ -p ftp_passwd ] ] [ -g groupid ] [ -s ] [ -f ][...]

  • Page 98

    A. OLCmd Reference A-28 Januar y 2002 7800-A2- GB32- 00 Exampl e: The following command sync hronizes device 172.20. 4.7: OLCmd sync 172.20.4.7 -E Reques ts that endp oints already discovered be resynchroni zed. -O Spe cifies that circuit names m a y be o verwritten.[...]

  • Page 99

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-29 OLCmd uhread The u hread command star ts an d stops the Use r Histor y Reader (UHRea der) from a command line. It can be used to process user histor y records automatical ly dur ing per iods of low network activity . Fo r m a t: OLCmd uhread -c command [ -n poller-name ] Where: Exampl e: The fo[...]

  • Page 100

    A. OLCmd Reference A-30 Januar y 2002 7800-A2- GB32- 00 OLCmd una ssigndev The unassign dev command rem oves de vices from a customer record. Fo r m a t: OLCmd unassigndev -c customer_nam e [ -a devi ce_ad dress ] | [ -l d evi ce _l is t ] Where: Exampl e: The f o llowing command remov es a single de v ice from custom er Exact_Cor p oration: OLCmd [...]

  • Page 101

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-31 OLCmd viewl og The viewlog command displays selected records from a log file . Fo r m a t: OLCmd viewlog [ -l ] [ -f log_type ] [ -sd mm/dd/ yyyy ] [ -ed mm/dd/ yyyy ] [ -st hh: mm:ss ] [ -et hh:mm: ss ] [ -u user id ] [ -ip ip_address ] [ log_name ] Where: -l Requests a list o f a vai lable lo[...]

  • Page 102

    A. OLCmd Reference A-32 Januar y 2002 7800-A2- GB32- 00 Exampl e: The f o llowing command displays f atal and inter nal messages collected in the UHReader log file during one week: OLCmd viewlog -f fi -sd 05/07/2000 -ed 05/13/2000 UHReader -ip ip_address Specifies an IP address. Log records containi ng the IP address a re di splay ed. log_name Is t[...]

  • Page 103

    A. OLCmd Referenc e 7800-A 2-GB32-00 January 2002 A-33 OLCmd xmlr eport The xmlrep ort command gene rates O penLa ne rep or ts ba se d on eX tens ib le Markup L anguage (X ML) repor t requ ests, a nd o ptionally t ransf o r ms the output based on an eXtensible Stylesheet Langu age T ransf or m ations (XSL T ) file. F or more in f ormati on, see A p[...]

  • Page 104

    A. OLCmd Reference A-34 Januar y 2002 7800-A2- GB32- 00[...]

  • Page 105

    7800-A 2-GB32-00 January 2002 B-1 B Using XML to Pr oduce Repo rts XML Reports OpenLane ’ s eXtensible Markup Langua ge (XML) repor t ing capabi lity allo ws repor ts to be requested using XML. The f or m at of the repor t to be retur ned is defined in the XML request itself . Repor ts can be generated in XML, HyperT ext Markup L anguage (HT ML),[...]

  • Page 106

    B. Us i ng XML to Pr oduce Report s B-2 Januar y 2002 7800- A2-GB32-00 Servle t Inter fac e (SlvXm lS ervl et ) The X ML repo r t ser vle t c an be found at: /opt/pdn/OpenLane/OLServlets/pdn.webcgi.SlvXmlServlet The SlvXm lSer vlet ser v let accept s a repor t request in XML and generate s a repor t in a specified forma t. The output is sent to the[...]

  • Page 107

    B. Using XML to Produce Repor ts 7800-A 2-GB32-00 January 2002 B-3 XML and XSL Exam ples The X ML for mat of the re por t requests and the repo r t ou tpu ts ar e docu mented through e x am pl es. The primar y repor t request e xample, with comm ent s showing XML tags, attributes, and possible v al ues, is at /opt/pdn/ OpenLane/samples/xml/reports/[...]

  • Page 108

    B. Us i ng XML to Pr oduce Report s B-4 Januar y 2002 7800- A2-GB32-00[...]

  • Page 109

    7800-A 2-GB32-00 January 2002 IN-1 Ind ex A access authe nticat ion, 5- 1 access leve ls, 6-5 access ing Open Lane appl ications, 6-1 acti vati ng firm w a re , 8- 4 addin g cust omer profil es, 6-4 cust omers, A-3 devi ces t o Open Lane, 6-2 new dev ice mod els, 8-2 admini strator resp onsibili tie s, 7-1 Apache inst all at ion par am et er s Sola[...]

  • Page 110

    Index IN-2 J anuar y 2002 7800- A2-GB32-00 E exam ples XML and XSL, B- 3 F firm wa re buil di ng l ibr ar y, 8-1 downlo ading and activati ng , 8-4 li brar y backup, 7- 2 fre quenc y of maint ena nce tasks, 7-1 G genera t ing schedul ed repor t s, 7-6 H hardwar e requir ement s Solar is, 2-2 Windows, 3-2 htpas swd, 5-2 HTTP Chall enge/ Response, 5-[...]

  • Page 111

    Inde x 7800-A 2-GB32-00 January 2002 IN-3 O OLCmd, A-1 addcust , A-3 chgra wfileext , A-5 – A-6, A-30 confa u th, A-8 dbage, 7-5, A- 9 dbconf i g, A-10 dbcopy, A-12 dbip, A- 13 dbrol l, A-14 delc ust, A-15 delde v , A-16 dump lda p, A- 17 helps , A-2 impor t ldif, A- 18 key , A- 19 ldapmod ify, A-20 ldaps earch, A-21 logs vc, A-23 proce ssreports[...]

  • Page 112

    Index IN-4 J anuar y 2002 7800- A2-GB32-00 stopp i ng Open Lane Solar is, 2-10 Windows, 3-10 sync, A-27 T TCP changi ng port, 3-11 port s used, 3-2 U UHReader star ting and stopping , A-29 upgrad i ng Open Lane Solar is, 2-4 Windows, 3-4 user acc ess authenti cat ion, 5-1 user hi story reader star ting and stopping , A-29 user I Ds, 5-2 user- modi [...]