3 Running the Installer

This chapter describes how to run the Oracle DataLens Server installer on all operating systems.

You should observe the following before attempting this installation:

Ensure that any firewall installations are not blocking port 2229 or the port you setup for the Oracle DataLens Server. The installation will not work if firewall is blocking the port that has been chosen for Oracle DataLens Server.
A minimum of 1 GB of disk space and 2 GB of RAM for the installation. Additional space will be required for data service applications and data lenses.
On UNIX systems, only the WebLogic Application Server is supported.

Note:

You can ensure that the Tomcat Application Server is installed and configured during the installation (Linux or Windows only) using the information in "Setting the Tomcat Application Server to Be Installed".

Installing on Linux or UNIX

To install an Oracle DataLens Administration Server running Linux or UNIX:

Ensure that you have followed the instructions in "Choosing an Application Server".
Log in to the server as an administrator user. For more information, see "Establishing an Administrator User Account".
Go to the installation directory:

cd /opt/dls_install/install
Change the permissions of the .sh files in the directory so that they are executable:

chmod +x *.sh
Execute the Oracle DataLens Server install script from the install directory:

On Linux:

./dlsinstall.sh

On UNIX:

./dlsinstall_solaris.sh
Note:
If you are logged in as root, the following message is displayed:
```
You are installing as root. Do you want to continue? [Y/N] (Y):
```
Enter Y to continue or N to exit and log in as a different administrative user.
```
Welcome to the Oracle Enterprise Data Quality 5.6 Installation. Will this be a Tomcat Server based installation? [Y/N]: (Y)
```

If you want to install the Tomcat Application Server and your server is not running UNIX, enter Y. Otherwise, enter N and continue to the next step.

Please make sure that your existing Tomcat server is not running.
Enter Y to continue or N to exit and manually stop your Tomcat server [Y/N]: (Y)

If you have Tomcat installed and the server is running, enter N to exit and stop your server. Otherwise, enter Y to continue with the installation.
```
Please enter your DataLens Server Home directory (/opt/Oracle/Middleware/opdq/:
```
Press Enter to accept the default product home directory or enter a different home directory for your Oracle DataLens Server (for example, /opt/opdq) then press Enter.

If the directory does not exist, it is created.
```
Will this be an Admin or Transform server [A/T]: ()
```

Enter A and press Enter to install an Oracle DataLens Administration Server.

Please enter your DataLens Server Data directory (/opt/Oracle/Middleware/opdq/data):

Press Enter to use the default data directory, which is the home directory path you identified in Step 8.

If the directory does not exist, it is created. Messages similar to the following are displayed:
```
Copying the Server Files to /opt/Oracle/Middleware/opdq/...
Created directory /opt/Oracle/Middleware/opdq/data
Please enter the location for JDK installation (/opt/Java):
```
Press Enter to use the default Java directory or enter the directory path to your JDK installation then press Enter.

If you did not install Tomcat, then messages similar to the following are displayed:
```
Installing 64-bit JDK... This may take a few minutes...
Please enter DataLens Server port number (2229):
```
Otherwise, the installer begins to install Tomcat and messages similar to the following are displayed:
```
Installing 64-bit JDK... This may take a few minutes...
Installing Tomcat...
Please enter the Tomcat server port number:  (2229)
```
Press Enter to use the standard 2229 port or enter the port number you want your application server to run on.

Messages similar to the following are displayed:
```
Configuring the SvrPaths file... .
.
Copying the WAR file to /opt/Oracle/Middleware/opdq/datalens.war.
.
.
```
The JDK is installed, if set to do so, Tomcat is installed, the Oracle DataLens Administration Server and data repository are created.

If Tomcat was installed, the EDQP Web Archive (WAR) file has been automatically configured and deployed. The Tomcat service is running.

If WebLogic was installed, the EDQP WAR file is now ready for deployment to a WebLogic Application Server.
Set the EDQP home environment variable:

export OPDQ_HOME=home_directory

Where home_directory is the home directory path you identified in Step 8.

Configuring Run Levels for Tomcat Automatic Restart

A runlevel script is available to automatically start the Tomcat application server and your Oracle DataLens Server (dls-tomcat) after a system reboot. The basic steps required to setup the dls-tomcat runlevels after a successful Oracle DataLens Server installation are as follows:

Note:

These steps require root or administrative permissions to complete. Contact your system administrator for assistance.

Create a symbolic link to the Oracle DataLens Server start script as follows:

ln -s /opdq_home_directory/tomcat/bin/dls-tomcat.sh /etc/init.d/dls-tomcat

Where opdq_home_directory is the home directory of your Oracle Datalens Server.
Run chkconfig to add dls-tomcat to the list of services to be started with the specified runlevels. If a different runlevel scheme is required then the dls-tomcat.sh script will have to be adjusted accordingly.

chkconfig --add dls-tomcat

Installing on Windows

To install an Oracle DataLens Administration Server running Windows:

Ensure that you have followed the instructions in "Choosing an Application Server".
Log on to the server as an administrator user.
Locate the MS-DOS Command Prompt (cmd.exe), right-click on it, and then select Run as administrator.
Change directories to c:\dls_install\install\.

Run the command:

dlsinstall.bat

Welcome to the Oracle Enterprise Data Quality 5.6 Installation.Will this be a Tomcat Server based installation? [Y/N]: (Y)

If you want to install the Tomcat Application Server, enter Y. Otherwise, enter N and continue to the next step.
```
Please make sure that your existing Tomcat server is not running.
Enter Y to continue or N to exit and manually stop your Tomcat server [Y/N]: (Y)
```
If you have Tomcat installed and the server is running, enter N to exit and stop your server. Otherwise, enter Y to continue with the installation.
```
Please enter your DLS Server Home directory: (C:\Oracle\Middleware\opdq)
```
Press Enter to accept the default product home directory or enter a different home directory for your Oracle DataLens Server (for example, C:\opdq) then press Enter.

If the directory does not exist, it is created.
```
Will this be an Admin or Transform server [A/T]:  (A) 
```

Enter A to install an Oracle DataLens Administration Server.

Please enter your DLS Server Data directory: (C:\Oracle\Middleware\opdq\data)

Press Enter to use the default data directory, which is the home directory path you identified in Step 7.

If the directory does not exist, it is created.

If you did not install Tomcat, then the installation completes and messages similar to the following are displayed:
```
Copying the Server Files to C:\Oracle\Middleware\opdq...
.
.
.
Please enter the DataLens Server port number:  (2229)
```
Otherwise, the installer begins to install Tomcat and the following prompt is displayed:
```
Copying the Server Files to C:\Oracle\Middleware\opdq...
Installing Tomcat...
.
.
.
Please enter the Tomcat server port number:  (2229)
```
Press Enter to use the standard 2229 port or enter the port number you want your application server to run on.

Messages similar to the following are displayed:
```
Configuring the SvrPaths file...
.
.
.
Copying the WAR file to C:\Oracle\Middleware\opdq\datalens.war
Starting the Tomcat6opdq service...
.
.
.
Finished the Oracle Enterprise Data Quality 5.6 Installation. (Return to Exit)
```
The JDK is installed, the Oracle DataLens Administration Server and data repository are created.

If Tomcat was installed, the EDQP Web Archive (WAR) file has been automatically configured and deployed, and the Tomcat service is started.

If WebLogic was installed, the EDQP WAR file is now ready for deployment to your WebLogic Application Server.
Press Enter to exit the installation script.
Set the EDQP home environment variable:
1. Right-click Computer, and then select Properties.
2. Click Advanced system settings.
3. Click Environment Variables.
4. From the System variables section, click New.
5. Enter OPDQ_HOME as the Variable name.
6. Enter is the home directory path you identified in Step 7 as the Variable value.
7. Click OK to close all dialogs.

Next Step

The next task in the installation process is to either configure your WebLogic application server or to verify the installation of a Tomcat application server. Continue to the appropriate chapter, Chapter 4, "Configuring a WebLogic Server" or Chapter 5, "Verifying the Server Installation."