5 Working with the Oracle Light Weight Availability Collection Tool GUI

Download and Unpack the Software

1. Download the latest Xalan-c software from http://www.apache.org/dyn/closer.cgi/xml/xalan-c.

   This URL provides links to different mirror sites. The binaries are available under the Binaries folder on any of these mirror sites. It can be downloaded in the form of *.tar.gz according to system specification (32 or 64 bit).

   For these instructions assume that the download path is /export/lwact/installables/xalan and that you are going to download the Xalan binary Xalan-C_1_10_0-solaris_28_64-cc_62.tar.gz for a 64-bit Solaris system.

2. To verify download of the Xalan-c software file to /export/lwact/installables/xalan, type the following commands:

   bash-2.05# pwd
   /export/lwact/installables/xalan
   bash-2.05# ls
   Xalan-C_1_10_0-solaris_28_64-cc_62.tar.gz
   

3. Unpack the archive to install Xalan in the system; type the following commands:

   Note:

   The path for binary Xalan is /export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/bin and the path for Xalan library is /export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/lib.

   bash-2.05# gunzip Xalan-C_1_10_0-solaris_28_64-cc_62.tar.gz
   bash-2.05# ls
   Xalan-C_1_10_0-solaris_28_64-cc_62.tar
   bash-2.05# tar -xvf Xalan-C_1_10_0-solaris_28_64-cc_62.tar
   bash-2.05# ls
   Xalan-C_1_10_0-solaris_28_64-cc_62
   bash-2.05# cd Xalan-C_1_10_0-solaris_28_64-cc_62
   bash-2.05# ls
   KEYS LICENSE NOTICE bin/ include/ lib/ samples/
   bash-2.05# cd bin
   bash-2.05# ls
   CompileStylesheet SerializeNodeSet StreamTransform UseStylesheetParam
   DocumentBuilder SimpleTransform ThreadSafe Xalan
   ExternalFunction SimpleXPathAPI TraceListen XalanTransform
   ParsedSourceWrappers SimpleXPathCAPI TransformToXercesDOM XalanTransformerCallback
   bash-2.05# pwd
   /export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/bin
   bash-2.05# cd ../lib
   bash-2.05# pwd
   /export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/lib
   

4. Download the latest Xerces-c library file from http://www.apache.org/dyn/closer.cgi/xml/xerces-c.

   This URL provides links to different mirror sites. The binaries are available under the Binaries folder of any mirror site. It can be downloaded in the form of *.tar.gz according to system specification (32 or 64 bit).

   For these instructions, assume that the download path is /export/lwact/installables/xerces and that you are going to download the Xerces binary xerces-c_2_7_0-solaris_28-cc_62.tar.gz for a 64-bit Solaris system.

5. Type the following commands to download the Xerces-c library file to /export/lwact/installables/xerces

   bash-2.05# pwd
   /export/lwact/installables/xerces
   bash-2.05# ls
   xerces-c_2_7_0-solaris_28-cc_62.tar.gz
   

6. Unpack the archive to install Xerces-c in the system; type the following commands:

   Note:

   The path for xerces library is /export/lwact/installables/xerces/xerces-c-solaris_28-cc_62/lib.

   bash-2.05# gunzip xerces-c_2_7_0-solaris_28-cc_62.tar.gz
   bash-2.05# ls
   xerces-c_2_7_0-solaris_28-cc_62.tar
   bash-2.05# tar -xvf xerces-c_2_7_0-solaris_28-cc_62.tar
   bash-2.05# ls
   xerces-c-solaris_28_64-cc_62
   bash-2.05# cd xerces-c-solaris_28_64-cc_62
   bash-2.05# ls
   LICENSE Readme.html credits.txt etc lib samples version.incl
   NOTICE bin doc include msg scripts
   bash-2.05# cd lib
   bash-2.05# ls
   libxerces-c.so libxerces-c.so.27.0 libxerces-depdom.so.27
   libxerces-c.so.27 libxerces-depdom.so libxerces-depdom.so.27.0
   bash-2.05# pwd
   /export/lwact/installables/xerces/xerces-c-solaris_28-cc_62/lib
   

Provide 755 Access Permissions

1. To provide 755 access permissions to the /opt/SUNWlwact/xsl directory, type the following command:

   bash-2.05# chmod -R 755 /opt/SUNWlwact/xsl

2. Type the following command to copy the directory pacifico from /opt/SUNWlwact/misc/ to /var/apache/htdocs/

   bash-2.05# cp -rf /opt/SUNWlwact/misc/pacifico /var/apache/htdocs/

3. Type the following commands to provide 755 access permission to the cgi-bin directory:

   bash-2.05# chmod 755 /var/apache/cgi-bin

4. Type the following commands to provide 755 access permission to the pacifico directory:

   bash-2.05# chmod -R 755 var/apache/htdocs/pacifico

The web browser-based Availability report for a single host is created by the /opt/SUNWlwact/sdk/my_uptime.cgi script, which is part of Oracle Lightweight Availability Collection Tool package installation.

Complete the Installation

1. Copy the my_uptime.cgi file from the /opt/SUNWlwact/sdk/ directory to the /var/apache/cgi-bin/ directory:

   bash-2.05# cp /opt/SUNWlwact/sdk/my_uptime.cgi /var/apache/cgi-bin/

2. Type the following command to provide 755 access permission to the /var/apache/cgi-bin/my_uptime.cgi file:

   bash-2.05# chmod 755 /var/apache/cgi-bin/my_uptime.cgi

3. Modify the /var/apache/cgi-bin/my_uptime.cgi file to include correct path for Xalan, Xerces libraries, the XSL path and the Xalan binary path:

   bash-2.05# vi /var/apache/cgi-bin/my_uptime.cgi

4. At the beginning of the Variable Initialization section, type the following statement to include the libraries for Xalan and Xerces:

   $ENV{'LD_LIBRARY_PATH'} = 
   "/export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/lib:
   /export/lwact/installables/xerces/xerces-c-solaris_28-cc_62/lib:
   $ENV{'LD_LIBRARY_PATH'}";
   

5. Make sure that the input file is included properly by verifying value of $input:$input="/var/log/$hostId.lwact.xml";

   If you manually modify the path for the log file (LOGDIR in the /etc/default/lwact file), the value of $input must be modified accordingly. The value set to the $xalan variable must be modified to point to Xalan in the system:

   $xalan="/export/lwact/installables/xalan/Xalan-C_1_10_0-solaris_28-cc_62/bin/Xalan";

6. Make sure that the variable $xslt points to singleLWACT.xsl in /opt/SUNWlwact/xsl: $xslt="/opt/SUNWlwact/xsl/singleLWACT.xsl";

7. Replace avoidance.central with the Fully Qualified Domain Name (FQDN) of the your host in the subroutine display_results():

   print "<meta http-equiv=\"Refresh\" content=60; URL=http://avoidance.central/cgi-bin/my_uptime.cgi\">\n";

8. To view the GUI-based Oracle Lightweight Availability Collection Tool availability report, type the following URL in the address field of your web browser: http://<FQDN>/cgi-bin/my_uptime.cgi

Download and Unpack the Software

1. Download the Xalan jar from http://www.apache.org/dyn/closer.cgi/xml/xalan-j

   This URL provides links to different mirror sites and the Xalan jar can be downloaded in the form of *.tar.gz.

   For these instructions assume that the download path is /export/lwact/installables/xalanand that you are going to download the Xalan xalan-j_2_7_1-bin-2jars.tar.gz.

2. Type the following commands to verify download of the Xalan jar to the /export/lwact/installables/xalan file:

   bash-2.05# pwd
   /export/lwact/installables/xalan
   bash-2.05# ls
   xalan-j_2_7_1-bin-2jars.tar.gz
   

3. To unpack the archive and install Xalan in the system, type the following command:

   bash-2.05# gunzip xalan-j_2_7_1-bin-2jars.tar.gz
    
   bash-2.05# ls
   xalan-j_2_7_1-bin-2jars.tar
   bash-2.05# tar -xvf xalan-j_2_7_1-bin-2jars.tar
   bash-2.05# ls
   xalan-j_2_7_1
   bash-2.05# cd xalan-j_2_7_1
   bash-2.05# ls
   docs NOTICE.txt samples xalan.jar xml-apis.jar
   LICENSE.txt readme.html serializer.jar xercesImpl.jar xsltc.jar
   bash-2.05# pwd
   /export/lwact/installables/xalan/xalan-j_2_7_1
   

   Note:

   The path for xalan.jar is: /export/lwact/installables/xalan/ xalan-j_2_7_1

Provide 755 Access Permissions

1. Copy the directory pacifico from /opt/SUNWlwact/misc/ to /var/apache/htdocs/

   bash-2.05# cp -rf /opt/SUNWlwact/misc/pacifico /var/apache/htdocs/

2. Provide 755 access permission to the /opt/SUNWlwact/xsl directory:

   bash-2.05# chmod -R 755 /opt/SUNWlwact/xsl

3. Provide 755 access permission to the /var/apache/htdocs/pacifico directory:

   bash-2.05# chmod -R 755 /var/apache/htdocs/pacifico

Complete the Installation

The browser-based Availability report for single host is created by the /opt/SUNWlwact/sdk/my_uptime.cgi script which is part of the Oracle Lightweight Availability Collection Tool package installation.

1. Copy the my_uptime.cgi file from the /opt/SUNWlwact/sdk/ directory to the /var/apache/cgi-bin/ directory:

   bash-2.05# cp /opt/SUNWlwact/sdk/my_uptime.cgi /var/apache/cgi-bin/

2. Type the following command to provide 755 access permission to the /var/apache/cgi-bin/my_uptime.cgi file:

   bash-2.05# chmod 755 /var/apache/cgi-bin/my_uptime.cgi

3. Modify the /var/apache/cgi-bin/my_uptime.cgi file to include the correct path for Xalan, the XSL path, and the Xalan binary path:

   bash-2.05# vi /var/apache/cgi-bin/my_uptime.cgi

4. Set the value of the $xalan variable to point to the path where the xalan.jar exists in the system:

   $xalan="/export/lwact/installables/xalan/xalan-j_2_7_1;

5. Set the value of the $syscmd variable:

   $syscmd="/usr/bin/java -jar $xalan/xalan.jar -in $input -xsl $xslt -out $output";

   If you manually modify the path for the log file (LOGDIR in the /etc/default/lwact file), the value of $input must be modified accordingly: $input="/var/log/$hostId.lwact.xml";

6. Ensure that the $xslt variable points to the singleLWACT.xsl file in /opt/SUNWlwact/xsl/: $xslt="/opt/SUNWlwact/xsl/singleLWACT.xsl";

7. Replace avoidance.central with the Fully Qualified Domain Name (FQDN) of your host in the subroutine display_results():

   print "<meta http-equiv=\"Refresh\" content=60; URL=http://avoidance.central/cgi-bin/my_uptime.cgi\">\n";

8. To view the GUI-based Oracle Lightweight Availability Collection Tool availability report, type the following URL in the address field of your web browser: http://<FQDN>/cgi-bin/my_uptime.cgi