Aperi/Hand Download External Dependencies

Introduction

Although the Aperi installed can download all but the jh.jar (Java Help Jar) automatically if you plan to install behind a firewall you will need to download and install the external dependencies by hand.

Download BIRT Runtime 2.1.2

              1. Go to http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-2_1_2-200702271000/birt-runtime-2.1.2.zip.
              2. Save the download to disk.
              3. Unzip the contents of birt-runtime-2.1.2.zip to a local directory. Within that local directory the zip file automatically creates a directory called /birt-runtime-2_1_2 that contains all the BIRT runtime files and subdirectories. For example: c:\bin\downloads\birt-runtime-2_1_2\.
              4. Perform the following tasks on the files you unzipped in the previous step:

                     o Start a command prompt session.
                     o Type the following command that corresponds to the operating system of the machine where you are installing Aperi:
                           + Windows: copy [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml c:\temp
                             For example: copy c:\Aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml c:\temp
                           + Linux: cp /[aperi_install_directory]/plugins/org.eclipse.aperi.reporting_5.0.0/web/birt-viewer/WEB-INF/web.xml .
                             For example: cp /opt/aperi/plugins/org.eclipse.aperi.reporting_5.0.0/web/birt-viewer/WEB-INF/web.xml .
                       Note: You can substitute a directory other than c:\temp if needed.
                     o Press Enter. This will copy Aperi's existing web.xml to a temporary directory (for example, Windows: c:\temp or Linux: . where "." represents the working directory where the command is issued) to enure that it is not overwritten during the next step.
                     o Type the following command that corresponds to the operating system of the machine where you are installing Aperi:
                           + Windows: xcopy /s /e /i /y [birt-runtime-2_1_2_unzip_directory]\WebViewerExample c:\[aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer
                             For example: xcopy /s /e /i /y c:\birt-runtime-2_1_2\WebViewerExample C:\Aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer
                           + Linux: cp -r -f [birt-runtime-2_1_2_unzip_directory]/WebViewerExample/* /opt/[aperi_install_directory]/plugins/org.eclipse.aperi.reporting_5.0.0/web/birt-viewer/
                             For example: cp -r -f birt-runtime-2_1_2/WebViewerExample/*
                             /opt/aperi/plugins/org.eclipse.aperi.reporting_5.0.0/web/birt-viewer/
                     o Press Enter. The subdirectores under [birt-runtime-2_1_2_unzip_directory]\WebViewerExample are copied to [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\.

                       After copying these directories, the resulting Aperi directory structure will appear as follows:

                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\logs
                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\report
                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\scriptlib
                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\webcontent
                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\lib
                           + [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\platform

                     o Type the following command that corresponds to the operating system of the machine where you are installing Aperi:
                           + Windows: copy c:\temp\web.xml [aperi_install_directory]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml
                             For example: copy c:\temp\web.xml C:\Aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml
                             Note: If you used a directory other than c:\temp make sure to use that directory in the copy command.
                           + Linux: cp web.xml [aperi_install_directory]/plugins/org.eclipse.aperi.reporting_5.0.0 /web/birt-viewer/WEB-INF/web.xml

                             For example: cp web.xml [aperi_install_directory]/plugins/org.eclipse.aperi.reporting_5.0.0/web/birt-viewer/WEB-INF/web.xml
                     o Press Enter.
                     o Type Yes and press Enter if you are prompted to overwrite web.xml. The web.xml file that you copied to a temporary directory (for example, the Windows c:\temp directory or the current working directory under Linux) is copied back in to [aperi_install_directory]\Aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\.

         * Download JavaHelp 1.1.3.
              1. Go to http://java.sun.com/products/javahelp/download_binary.html.
              2. Click the Download button under the JavaHelp 1.1.3 (Zip) section.
              3. Click Accept License Agreement.
              4. Click the down arrow to download the javahelp-1_1_3.zip file.
              5. Unzip the contents of javahelp-1_1_3.zip.
              6. Locate the \jh1.1.3\javahelp\lib\jh.jar file in the directory where you unzipped javahelp-1_1_3.zip.
              7. Copy jh.jar to [aperi_install_dir]\plugins\javax.help_1.0.0
              8. Copy jh.jar to [aperi_install_dir]\rcpgui\plugins\javax.help_1.0.0

  5. Download additional third-party files. Depending on your environment, you can download these additional required files manually or use Aperi's Installer script to perform the download automatically. To determine what works best for your environment, consider the following:

         * Automatic download: Use the Aperi Installer script (in regular or easy mode) to automatically download these additional third-party files. 

         * Manual download: Download these additional third-party files manually if any of the following is true:
               o The install process cannot access the Internet (firewall, policy, no connectivity, etc).
           Download the following files if you do not plan to use the Installer to perform the automatic downloads:

         * Download Geronimo 1.1.
              1. Go to http://www.apache.org/dist/geronimo/1.1/geronimo-tomcat-j2ee-1.1.zip.
              2. Save the download (geronimo-tomcat-j2ee-1.1.zip) to a local directory (such as /geronimo-1.1).
              3. Unzip the contents of geronimo-tomcat-j2ee-1.1.zip.
              4. Copy geronimo-j2ee_1.4_spec-1.1.jar to [aperi_install_dir]\plugins\javax.j2ee_1.0.0.
              5. Copy geronimo-j2ee_1.4_spec-1.1.jar to [aperi_install_dir]\rcpgui\plugins\javax.j2ee_1.0.0.

                 geronimo-j2ee_1.4_spec-1.1.jar is located in the following subdirectory where you unzipped geronimo-tomcat-j2ee-1.1.zip: /[location where you unzipped geronimo-tomcat-j2ee-1.1.zip]/repository/org/apache/geronimo/specs/geronimo-j2ee_1.4_spec/1.1.

         * Download iText 1.3.
              1. Go to http://downloads.sourceforge.net/itext/itext-1.3.jar?modtime=1112806930&big_mirror=0.
              2. Save the download (itext-1.3.jar) to a local directory.
              3. Copy itext-1.3.jar to [aperi_install_dir]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\lib

         * Download org.mortbay.jaas 5.1.10.
              1. Go to http://repo1.maven.org/maven2/jetty/org.mortbay.jaas/5.1.10/org.mortbay.jaas-5.1.10.jar.
                 Note: If this link does not work in your web browser, go to http://repo1.maven.org/maven2/jetty/org.mortbay.jaas/5.1.10/, right-click org.mortbay.jaas-5.1.10.jar, select Save Target As..., save it to your local disk, and skip to step 3.
              2. Save the download (org.mortbay.jaas-5.1.10.jar) to disk.
              3. Rename the jar from org.mortbay.jaas-5.1.10.jar to org.mortbay.jaas.jar.
              4. Copy org.mortbay.jaas.jar to [aperi_install_dir]\plugins\org.eclipse.aperi.reporting.jaas_1.0.0.

         * Download javax.servlet.jsp_2.0.0.v200612120446.jar.
              1. Go to http://www.eclipse.org/downloads/download.php?file=/eclipse/equinox/drops/S-3.3M6-200703231616/javax.servlet.jsp_2.0.0.v200612120446.jar.
              2. Click the mirror link closest to you and save the file locally.
              3. Copy javax.servlet.jsp_2.0.0.v200612120446.jar to [aperi_install_dir]\plugins\.

         * Download org.apache.commons.el_1.0.0.v200704241052.jar.
              1. Go to http://www.eclipse.org/downloads/download.php?file=/eclipse/equinox/drops/S-3.3M7-200705031400/org.apache.commons.el_1.0.0.v200704241052.jar.
              2. Click the mirror link closest to you and save the file locally.
              3. Copy org.apache.commons.el_1.0.0.v200704241052.jar to [aperi_install_dir]\plugins\.

         * Download org.apache.jasper_5.5.17.v200701082340.jar.
              1. Go to http://europa-mirror1.eclipse.org/tools/orbit/downloads/drops/R200706192011/bundles/org.apache.jasper_5.5.17.v200706111724.jar.
              2. Save the file locally.
              3. If the file has a .zip extension, rename it to .jar
              4. Copy org.apache.jasper_5.5.17.v200701082340.jar to [aperi_install_dir]\plugins\.

  6. If you plan to use DB2 as the database repository, continue to the next step. If you plan to use Apache Derby as the database repository, continue to step 8.
  7. Copy the DB2 JDBC driver into the directory where you unzipped the Aperi Storage Manager files. To do this perform the following steps:
        1. Locate the DB2 JDBC driver that was installed during the DB2 installation. On Windows, check C:\Program Files\IBM\SQLLIB\Java. The filenames are db2jcc.jar and db2jcc_license_cu.jar.
        2. Copy the driver files to the following Aperi directories:
               * /plugins/org.eclipse.aperi.db_1.0.0
               * /rcpgui/plugins
        3. Go to /plugins/org.eclipse.aperi.db_1.0.0/MANIFEST.
        4. Delete MANIFEST.MF.
        5. Rename DB2-MANIFEST.MF to MANIFEST.MF.
  8. (optional) Complete this step if you intend to use the Aperi report viewer from behind a firewall or from a location that does not have an internet connection. Otherwise, continue to the Configure Aperi Storage Manager section for information about how to set up the components you want to run on the machine where you unzipped the Aperi files.

     A web-based report viewer is available as a perspective within the RCP framework or as a standalone application viewed through a web browser. The report viewer is based on BIRT, an open source Eclipse-based reporting system that provides you with the ability to generate a number of reports based on storage data collected by Aperi.

     If you intend to use the report viewer from behind a firewall or from a location with no access to the internet, you must modify the DTD (Document Type Definition) in the web.xml files of the two web applications that comprise the report server. Each web.xml file contains the following XML DOCTYPE declaration after the Aperi copyright statement:

     <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">

     Perform the following steps to modify the DTDs in the web.xml files:

        1. Create a copy of the original web.xml files as distributed with Aperi. The web.xml files are located in the following directories:
               * [aperi_install_dir]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml
               * [aperi_install_dir]\plugins\org.eclipse.aperi.reporting_5.0.0\web\aperi-reports\WEB-INF\web.xml
           For example, create a copy of these files under different names in the same directories such as:
               * c:\aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml.orig
               * c:\aperi\plugins\org.eclipse.aperi.reporting_5.0.0\web\aperi-reports\WEB-INF\web.xml.orig
           This ensures that you have a copy of the original files for backup purposes.
        2. Start a web browser and go to http://java.sun.com/dtd/web-app_2_3.dtd.
        3. Save the source of this page to: [aperi_install_dir]\reporting\web-app_2_3.dtd. Make sure the name of the file you save locally is web-app_2_3.dtd.
           Note: You can also right-click the link http://java.sun.com/dtd/web-app_2_3.dtd and select the "save target as" option to save the file locally.
        4. Open the following web.xml files in a text editor:
               * [aperi_install_dir]\plugins\org.eclipse.aperi.reporting_5.0.0\web\birt-viewer\WEB-INF\web.xml
               * [aperi_install_dir]\plugins\org.eclipse.aperi.reporting_5.0.0\web\aperi-report\WEB-INF\web.xml
        5. Edit the DTDs in each web.xml file to point to the local web-app_2_3.dtd file that you saved previously as follows:

           Change the text "http://java.sun.com/dtd/web-app_2_3.dtd" that appears in each file's DTD to: "file:///[aperi_install_dir]/reporting/web-app_2_3.dtd"

           For example, the modified DTD for the web.xml files might appear as follows:

           <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "file:///C:/Aperi/reporting/web-app_2_3.dtd">
        6. Save both web.xml files with the updated DTD.
        7. Continue to the Configure Aperi Storage Manager section for information about how to set up the components you want to run on the machine where you unzipped the Aperi files.