Oracle Light Weight Availability Collection Tool User Guide

Xalan Installation

To install Xalan, decide whether you want to install the C based binary or the java based jar file, and complete the steps in the appropriate section:


Note –

The prerequisite (common for both C and Java based Xalan) is that the Oracle Lightweight Availability Collection Tool and an Apache web server must be installed in the system. The Apache web server can be downloaded from http://httpd.apache.org/download.cgi.


Installation and Configuration of the C Based Xalan Software

To configure the GUI for the Oracle Lightweight Availability Collection tool, you need to have Xalan and Xerces binaries installed in the host.

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 my_uptime.cgi file from /opt/SUNWlwact/sdk/ to /var/apache/cgi-bin/


    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 file /var/apache/cgi-bin/my_uptime.cgi:


    bash-2.05# chmod 755 /var/apache/cgi-bin/my_uptime.cgi
    
  3. Modify /var/apache/cgi-bin/my_uptime.cgi 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 /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

Installation and Configuration of the Java based Xalan

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


    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 the following: /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


    bash-2.05# chmod -R 755 /opt/SUNWlwact/xsl
    
  3. Provide 755 access permission to the directory /var/apache/htdocs/pacifico


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

Complete the Installation

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

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


    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 file /var/apache/cgi-bin/my_uptime.cgi:


    bash-2.05# chmod 755 /var/apache/cgi-bin/my_uptime.cgi
    
  3. Modify /var/apache/cgi-bin/my_uptime.cgi to include 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 /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 singleLWACT.xsl 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