Paradyne SLM 5.5 Bedienungsanleitung

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

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[...]

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[...]

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 . . . . . . . . . . . . . . . .[...]

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 . . . . . . . . . . . . . . . . . . . . . .[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . [...]

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[...]

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[...]

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[...]

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-[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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.[...]

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 [...]

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[...]

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[...]

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

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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.[...]

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

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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 [...]

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

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[...]

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[...]

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[...]

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 [...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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

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[...]

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[...]

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[...]

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[...]

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[...]

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

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 [...]

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 [...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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 ][...]

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.[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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

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),[...]

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[...]

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/[...]

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

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[...]

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-[...]

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[...]

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 [...]