Before You Install iFolder

iFolder requires that you install Linux as a server. You must also install the Apache 2 Web server, Java, and SSL. You must complete all of the procedures in this section in order for these products to be configured correctly for iFolder.

If you are installing Solaris, skip the next two tasks (Installing Linux 7.2 and Installing Java) and compelete the rest of the tasks in this section, beginning with Creating Keys and Certificates.

Installing Linux 7.2

Install Linux 7.2 with the following settings:

• Install Options: Select Server System and uncheck Configure Using DHCP check box
• Disk Partitioning: Automatically partition and remove data
• Network Configuration: Uncheck the Configure Using DHCP check box and enter the IP address, Netmask, Gateway, and Primary DNS name for your Linux server.
• Firewall Configuration: Select security level "No Firewall"
• Select Package Groups: Select Web Server (scroll down to see the option)

Continue with the next section, "Installing Java ."

Installing Java

1. If you don't have Java installed on your Linux server, go to the Java Web site and download the Red Hat Linux RPM shell script for J2SE version 1.3 or later.

2. After the shell script is downloaded, self extract the .rpm file from the .bin file by entering

   sh filenamerpm.bin

   HINT:  The X's in this example will be replaced by the version numbers of the actual filename.

3. Accept the licensing agreement and run the package manager by entering

   rpm -iv filename.rpm

4. Do one of the following:

   • For a temporary instance of Java, add the following parameter to the shell path:

     PATH="$PATH:/usr/java/jrex.x.x_xx/bin"

     HINT:  Replace the X's with the appropriate version numbers from the Java file you downloaded.

   • For permanent instance of Java, add this parameter to the profile file in the etc directory before the export PATH USER parameter:

     PATH="$PATH:/usr/java/jrex.x.x_xx/bin"

Continue with the next section, Creating Keys and Certificates.

Creating Keys and Certificates

Installing OpenSSL is not required, but it is recommended in order to make the certificate and keys required for HTTPS access to the iFolder Management Console.

If you have a previous installation of Apache on your server, it is likely that you already have the required server.crt and server.key files. These files are usually located in the /etc/httpd/conf/ssl.crt/ and /etc/httpd/conf/ssl.key/ directories.

If you already have a certificate file (server.crt) and a key file (server.key), skip this procedure and continue with the next section, Installing Apache 2.

If you do not have these files, follow these instructions to download and install the OpenSSL engine.

1. Go to the OpenSSL Web site.

2. Download the openssl-engine-0.9.xx.tar.gz file and then extract the following files:

   gzip -d openssl-engine-0.9.xx.tar.gz

   tar xvf openssl-engine-0.9.xx.tar

   HINT:  The XX should be replaced with the appropriate file version.

3. Configure OpenSSL by entering the following at the server console:

   cd openssl-engine-0.9.xx

   sh config \

   no-idea \

   no-threads \

   -fPIC

4. Compile OpenSSL by entering the following at the server console:

   make

5. Make sure that OpenSSL is configured and compiled by entering the following at the server console:

   make test

6. Install OpenSSL by entering the following at the server console:

   make install

7. Run the OpenSSL engine to create the server.key and server.crt files.

   For more information on creating the server.key and obtaining the server.crt file certificate for your key by creating and using your own Certificate Authority, see the instructions at the Apache Web site.

Continue with the next section, Installing Apache 2.

Installing Apache 2

1. If it does not already exist, create a directory named /export

2. Download the httpd-2.0.39-i686-pc-linux-gnu.tar.gz or the httpd-2.0.39-sparc-sun-solaris2.8.tar.gz file that shipped with the iFolder software into the /export directory.

3. Extract the .gz and .tar files to the /export directory.

   NOTE:  This version of Apache is a UNIX Binary Distribution that has been built with the following two switches: --with-mpm=worker and --enable-ssl.

   • For Linux, extract the following files:

     gzip -d httpd-2.0.39-i686-pc-linux-gnu.tar.gz

     tar xvf httpd-2.0.39-i686-pc-linux-gnu.tar

   • For Solaris, extract the following files:

     gzip -d httpd-2.0.39-sparc-sun-solaris2.8.tar.gz

     tar xvf httpd-2.0.39-sparc-sun-solaris2.8.tar

4. Run the installation script by entering the following at the server console:

   cd httpd-2.0.39

   sh ./install-bindist.sh

Continue with the next section, "Copying SSL Keys and Certificates."

Copying SSL Keys and Certificates

In order for iFolder to use the server.key and server.crt files, you must copy them to the appropriate directory on your server.

1. On your server, copy your server.crt file into this directory:

   /export/httpd-2.0.39/bindist/conf/ssl.crt/

2. On your server, copy your server.key into this directory:

   /export/httpd-2.0.39/bindist/conf/ssl.key/

You are now finished with the iFolder preconfiguration. Continue with the next section, Things You Should Know during the Installation.