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 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

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 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\.

(Optional) Configur DB2 as the database repository

  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.