Paradyne SLM 5.5 manual Servlet Interface SlvXmlServlet, Writing an Interface to the Servlet

Page 106

B. Using XML to Produce Reports

Servlet Interface (SlvXmlServlet)

he XML report servlet can be found at:

/opt/pdn/OpenLane/OLServlets/pdn.webcgi.SlvXmlServlet

he SlvXmlServlet servlet accepts a report request in XML and generates a report in a specified format. The output is sent to the browser window. XML output can optionally be transformed into different formats by an XSL Transformation.

here is a sample Web page to demonstrate the use of the servlet at

/opt/pdn/OpenLane/samples/xml/reports/xmlentry.html. You can

run the sample page from the URL

http://your.domain.name/OpenLane/xmlentry.html when OpenLane is running.

he easiest way to try the sample Web page is to open an XML report request file, select and copy the text, and paste it into the Web page. Sample XML report requests can be found in the following directories:

/opt/pdn/OpenLane/samples/xml/reports/DeviceReports/Requests

/opt/pdn/OpenLane/samples/xml/reports/SlvReports/Requests

Writing an Interface to the Servlet

he servlet expects a HyperText Transfer Protocol (HTTP) post with up to three parameters:

XmlReportRequest. The first and only mandatory parameter is

TXmlReportRequest, which contains the report request in XML format.

OutputClassOrMime. The post may also contain a parameter called OutputClassOrMime, which tells a Web browser how to interpret the reply for viewing. This usually matches the output type specified in the report request, but does not have to. For example, you may want to view an HTML/JavaScript report as ASCII by using text/plain as the Multipurpose Internet Mail Extension (MIME) type. The normal reply types for the supported report formats are

Tshown in the following table:

Output

Default MIME Type

 

 

DEFAULT (not specified)

text/plain

and errors

 

 

 

XML

text/xml

 

 

HTML/JavaScript

text/html

 

 

CSV

text/plain

 

 

XslRequest. When the requested report output type is XML, the post optionally may also contain a parameter called XslRequest, which contains an XSL Transformation to apply.

B-2

January 2002

7800-A2-GB32-00

Image 106
Contents OpenLane SLM Copyright 2002 Paradyne Corporation All rights reserved Contents Configuring Distributed Components Installing OpenLane on WindowsApache User Access Authentication Building and Using a Firmware Library OpenLane MaintenanceAdding Devices and Customer Profiles OLCmd Reference Using XML to Produce ReportsIndex Document Purpose and Intended Audience About This GuideDocument Summary Product-Related Documents Library → Technical ManualsOpenLane SLM Easy InstallationIntroduction to OpenLane SLM Network MonitoringOpenLane Features Planning the Installation Installing OpenLane on SolarisAbout These Instructions Minimum Hardware Requirements Installation RequirementsSoftware Requirements Procedure Checking the Java Runtime Environment VersionDCEinstall Uninstalling DCE ManagerUninstalling Performance Wizard Cd /opt/OV/pdn/PerfWiz UnInstallToOVOpt/apache OpenLane Installation ProgramOpt/pdn/OpenLane Setup.sh Obtaining a License Key Installing from Paradyne’s Web SiteUser = nobody Group = nobody Installing from CD-ROM Installing from FTP FilesExport DISPLAY=localhostname0.0 Installing Remotely UsingInstalling the Permanent License Key Setenv Display localhostname0.0Displaying the License Key Expiration Date Locating the License Key On an Installed SystemMigration to Current Release for Oracle OLCmd keyStarting OpenLane Web and Database Services Stopping OpenLane Web and Database ServicesConfiguring Apache to Use a Different Port Installing OpenLane on Solaris January Installing OpenLane on Windows MHz Processor Web Client Software Requirements Cd \opt\OV\pdn\PerfWiz uninstalltoov \opt\apache \Program Files\Apache Group\Apache\opt\pdn\OpenLane Procedure Cd \opt\pdn\OpenLane Migration to Current Release for Oracle Starting OpenLane Web and Database Services Stopping OpenLane Web and Database Services Http//olserver.com8080/openlane Installing OpenLane on Windows January Configuring Distributed Components OpenLane Distributed ComponentsSetting Up Web Server Distribution OpenLane in /opt/pdn/OpenLaneSolaris Operational Notes Http//172.20.1.10/OpenLaneCd /opt/pdn/OpenLane OLControl stop Setting Up the Distributed Poller and ReaderDistributed Poller/Reader Management Server Setup Cd /opt/pdn/OpenLane/uhpoller mkdir pollerpoller1Cd /opt/pdn/OpenLane OLControl start OLCmd Dbconfig ‘-m 172.20.1.10’OLCmd Dbconfig ‘-m 172.20.1.101521’ OLCmd logsvcDOMAIN=default Distributed Poller/Reader Poller/Reader SetupREADERDOMAIN=default OLControl stop Apache User Access Authentication User Access AuthenticationCd /opt/apache Solaris cd \opt\apache Windows Configuring Http Challenge/ResponseChange to the /opt/apache/bin Solaris or c\opt\apache\bin OLCmd confauth on Removing a User’s Access\opt\pdn\OpenLane Windows OLCmd confauth offApache User Access Authentication January Accessing the OpenLane Web Applications Adding Devices and Customer ProfilesAdmin Adding a DeviceNew Device Field Names Field Description Adding a Customer Profile 7800-A2-GB32-00 January Adding Devices and Customer Profiles OpenLane Maintenance Task Importance Ideal FrequencyBacking Up OpenLane Files Oracle DatabaseRestoring OpenLane Under Solaris Gzip -d /backupdir/backup.tar.gz tar xvf backup.tarBacking Up OpenLane Under Solaris Opt/pdn/OpenLane/dataBacking Up OpenLane Under Windows Restoring OpenLane Under WindowsDeleting Older Records from the Database FrequencyAutomating the Generation of Scheduled Reports Using Cron Under Solaris to Automate ReportsGenerating Scheduled Reports Cd /opt/pdn/OpenLane OLCmd processreportsUsing AT under Windows to Automate Reports Cd \opt\pdn\OpenLane OLCmd processreportsRebuilding Oracle Database Indexes Apache Log Files Monitoring Log FilesSQL Database Log File Archiving and Deleting Log Files OLCmd clean logs .logLegacy Logger Log Files Uploading Configurations Click on Click here to schedule the tasksOpenLane Maintenance January Version=filename Building and Using a Firmware LibraryBuilding a Firmware Library 01.02.01=R010201.ocdModel=directory New Device Models Not Supported by OpenLane9880=fw9880 Dslaan Model=devicetypeDbm DslasnDownloading and Activating Firmware Building and Using a Firmware Library Building and Using a Firmware Library January OLCmd Reference Cd \opt\pdn\openlane olcmd confauth on OLCmd HelpsOlcmd viewlog -h OLCmd addcust OLCmd addcust -a realtime -c ExactCorporation Rent-a-Phone.com Rent-a-PhoneGmbH Rent-a-PhoneUSAOLCmd assigndev -c ExactCorporation -a OLCmd assigndevOLCmd assigndev -c ExactCorporation -l exactdevices.txt OLCmd chgrawfileext -o raw -e ftp OLCmd chgrawfileextOLCmd chgrawfileext -d dallas -o bad -e raw OLCmd clean OLCmd clean \opt\apache\logs .log 21 adminOLCmd confauth OLCmd confauth on offOLCmd dbage OLCmd dbconfig OLCmd dbconfig -d c o -a instance -l -hUrl OLCmd dbcopy OLCmd dbcopy d OracleStatsDBOLCmd dbip address OLCmd dbipOLCmd dbip Ipaddress OLCmd dbrollDatabaseinstance OLCmd dbroll -e 20010101000000 -rOLCmd delcust -ccustomer -lcustomer-list OLCmd delcustOLCmd delcust -l ex-customers.txt OLCmd deldev ipaddress OLCmd deldevOLCmd deldev OLCmd dumpldap OLCmd dumpldap hostOLCmd importldif -h host ldiffile OLCmd importldifLdiffile OLCmd key licensekey OLCmd keyOLCmd key WZBCK-AAM6E-U898Q-MX5HK OLCmd ldapmodify OLCmd ldapmodify -D c=US -w admin -a -c data/new.ldifOLCmd OLCmd ldapsearch -n-D bindDN -w password -h host -p port OLCmd ldapsearchDebuglevel OLCmd logsvc OLCmd logsvc ipaddressEnddate enddate OLCmd processreportsDate date OLCmd processreports -date 05/13/2001 -customer ExactCorpObjectid OLCmd snmpgetOLCmd snmpget communityname ipaddress objectid OLCmd snmpget 135.26.10.37OLCmd snmptest ipaddress communityname Ipaddress Is the address of the device to be accessedOLCmd snmptest OLCmd snmptest 135.26.10.37 nmswriteOLCmd sync OLCmd sync OLCmd uhread OLCmd uhread -ccommand -npoller-nameCommand Poller-nameOLCmd unassigndev -c ExactCorporation -a OLCmd unassigndevOLCmd unassigndev -c ExactCorporation -l exactdevices.txt OLCmd viewlog UHReader Database Reader Firmware/Configuration/Feature MaintenanceUHLister Poller Controller OLCmd viewlog -f fi -sd 05/07/2000 -ed 05/13/2000 UHReaderXmloutputfile OLCmd xmlreportXmlrequestfile XsltransformfileOLCmd Reference January Command Line Interface OLCmd xmlreport Using XML to Produce ReportsXML Reports Opt/pdn/OpenLane/OLServlets/pdn.webcgi.SlvXmlServlet Servlet Interface SlvXmlServletWriting an Interface to the Servlet Opt/pdn/OpenLane/samples/xml/reports/xmlentry.html. You canOpt/pdn/OpenLane/samples/xml/reports/DeviceReports/Requests XML and XSL ExamplesAdditional Resources Opt/pdn/OpenLane/samples/xml/reports/DeviceReports/ReportsUsing XML to Produce Reports January Index IN-1IN-2 IN-3 IN-4