Setting Up the Application Server

Set up the application server before installing the RepConnector.

1. Verify that there is enough disk space to create the RepConnector directory structure.
2. Install and start the application server.
   • For JBoss version 6, see the JBoss documentation at http://www.jboss.org/jbossas/docs/6-x.
   • For JBoss version 7, see the JBoss documentation at https://docs.jboss.org/author/display/AS71/Documentation
   • For Oracle WebLogic Server 12c (12.1.1), see the documentation at http://docs.oracle.com/cd/E24329_01/index.htm.
3. Verify that your application server is running and ready to accept connections.
   See your application server documentation for more information.
4. Make sure you have write permission on the application server installation directory.
5. (On UNIX) Verify that your PATH environment variable includes “.” at the end of the definition so that applications look for executable files from the current directory.
   If “.” is not included in the PATH environment variable, add this:
   • In sh environment:

     PATH=.:$PATH
     export PATH

   • In csh and tcsh environments:

     setenv PATH .:$PATH

6. If you are installing RepConnector on either:
   • JBoss application server 6 – the installer places the RepConnector.ear into the JBOSS_HOME/server/default/deploy directory and in JBOSS_HOME/repra/jboss6-ear. The installer modifies JBOSS_HOME/bin/run.conf to include the RepConnector runtime environment, or,
   • JBoss application server 7 – places the RepConnector.ear in the JBOSS_HOME/standalone/deployments directory and leaves JBOSS_HOME/repra/jboss7-ear. The installer also modifies JBOSS_HOME/bin/standalone.conf to include the RepConnector runtime environment.

   If you are running JBoss under a different configuration than "default" (JBoss 6) or "standalone-full" (JBoss 7), change the configuration files and deployment directories appropriately.

7. If you are installing RepConnector on a WebLogic application server, on an IBM AIX machine, edit the registry.xml file, which is in the $WL_HOME directory, to include:

   java-installation JavaHome=PATH_TO_JAVA_HOME/

   where PATH_TO_JAVA_HOME is the path to your Java 1.7 installation directory.

8. Restart your application server for these changes to take effect.