6.1 Installing WebSphere

You must install WebSphere Application Server for running AEM forms on JEE products. For use with AEM forms on JEE, WebSphere can be installed either as WebSphere Base or as WebSphere ND with one base profile. See the WebSphere documentation to determine which method is best for your system.

6.1.1 Installing a Fix Pack to WebSphere

After you install WebSphere 8.5, you must update to WebSphere 8.5.5 before you deploy AEM forms on JEE. After you install WebSphere 8.0, update the WebSphere to 8.0.0.2 (where x=2) before deploying AEM forms on JEE.

See the WebSphere support website for Fix Pack installation instructions and to access the WebSphere updates.

6.1.2 Installing WebSphere Feature Pack for JPA 2.0

After you install WebSphere 7.0, you must install WebSphere Feature Pack for JPA 2.0. See, WebSphere Support website and search Installing and uninstalling the feature pack to download and install Feature Pack.

6.1.3 JAVA_HOME and PATH environment variables

As part of your WebSphere installation, a Java SDK (JDK) was installed. The JAVA_HOME and PATH environment variables can point to the JDK where AEM forms on JEE will be deployed.

6.1.3.1 Set the JAVA_HOME environment variable (Windows)

  1. Select Start > Control Panel > System .

  2. Click the Advanced tab and click Environment Variables .

  3. In the System Variables area, click New .

  4. Type JAVA_HOME as the variable name and, as its value, specify the directory where the JDK bundled with WebSphere is installed. For example, type the following path:

    C:\Program Files\IBM\WebSphere\AppServer\java

6.1.3.2 Set the PATH environment variable (Windows)

  1. Select Start > Control Panel > System .

  2. Click the Advanced tab and click Environment Variables .

  3. In the System Variables area, select Path , click Edit , and then append the following text to the beginning of the variable value: 

        %JAVA_HOME%\bin;

6.1.3.3 Set the DISPLAY setting (AIX)

  • If you are using a Windows machine to access the AIX console, type the following text at the command prompt: 

            export DISPLAY= <IP Address of the Windows machine telnet, or cygwin to         Linux or Solaris machine>:0.0
    Note: If the DISPLAY setting is not set correctly, the following error occurs when you start Configuration Manager: "No JRE is found...".

6.1.3.4 Set the JAVA_HOME environment variable (AIX, Linux, and Solaris)

  • Set the JAVA_HOME variable for Borne and Bash shells as shown in the following example: 

            JAVA_HOME=/opt/IBM/WebSphere/AppServer/java 
        export JAVA_HOME
    Note: The specific path varies based on the installation directory you specified and the operating system you are installing on.

6.1.3.5 Set the PATH environment variable (AIX, Linux, and Solaris)

  • Set the PATH variable for Borne and Bash shells as shown in the following example: 

            PATH=$JAVA_HOME/bin:$PATH 
        export PATH

6.1.3.6 (Windows, AIX, Linux, or Solaris ) Verify JAVA_HOME environment variables

(Optional) Open a command prompt and run the following command: 

                java -version

You should receive a response that displays the Java version installed.

6.1.4 Starting WebSphere Base and accessing WebSphere Administrative Console

6.1.4.1 Start WebSphere Base

If the server is not already running, start the WebSphere Administrative Console, from [appserver root] /profiles/<profile_name>/bin, type the appropriate command, replacing server1 with the name of your server instance:

  • (Windows) startServer.bat server1

  • (AIX, Linux, and Solaris) ./startServer.sh server1

6.1.4.2 Access the WebSphere Administrative Console

  1. Start the WebSphere Application Server.

  2. In the address bar of a web browser, type the appropriate URL: 

http://[host name]:[port]/ibm/console

If you are logged into the server that you are currently using, you can replace [host name] with localhost . The port value depends on the application server and whether Administrative Security is enabled. The default port value for WebSphere is 9060. If Administrative Security is enabled, the default SSL port value is 9043.

  1. If WebSphere Administrative Security is enabled, type the WebSphere user ID and password in the boxes provided.

  2. Click Log In .

6.1.5 Starting WebSphere ND and accessing WebSphere Administrative Console

  1. Open a command prompt and navigate to [WebSphere ND root] /profiles/Dmgr01/bin.

  2. (Windows) Run startManager.bat .

    (AIX, Linux, and Solaris) Run startManager.sh .

  3. Navigate to [WebSphere ND root] /profiles/ [profile name] /bin and run startNode.bat .

  4. Once the services have started, connect to the server by typing the URL http://[host name]:[port]/ibm/console in the address bar of a web browser.

    If you are logged into the server that you are currently using, you can replace [host name] with localhost . The port value depends on the application server and whether Administrative Security is enabled. The default port value for WebSphere is 9060. If Administrative Security is enabled, the default SSL port value is 9043.

  5. If WebSphere Administrative Security is enabled, type the WebSphere user ID and password in the boxes provided and click Log In .

  6. In the navigation tree of the WebSphere Administrative Console, click Servers > Server Types > WebSphere application servers .

  7. Select the listed server and click Start . Notice that the server status changes as the server is started.

6.1.6 Directory permissions

The AEM forms on JEE application will extract files to the [appserver root] /installedApps directory. Therefore, it is important that writable permissions be given to that directory. If writable permissions cannot be given, the section below describes how to modify the location for the extracted files.

Note: It is recommended that you modify the location of the extracted files to [appserver root]/profiles/<profile_name>/installedApps.

6.1.6.1 Modify the location for the extracted files

  1. Log in to the WebSphere Administrative Console.

  2. Click Servers > Server Types > WebSphere Application servers and click your server name, such as server1 .

  3. Under Server Infrastructure, click Java and Process Management > Process Definition .

  4. Under Additional Properties, click Java Virtual Machine and then click Custom Properties .

  5. Click New and create a custom property named adobeidp.RootDirectory .

  6. Set the value of adobeidp.RootDirectory to the path where Adobe native files should be extracted, such as [appserver root] /profiles/ <profile_name> /installedApps.

  7. Click OK or Apply .

  8. In the Messages box, click Save directly to master configuration , and then restart the application server.

// Ethnio survey code removed