Configuring Eclipse and the WebSphere Application Server Liberty Profile server

After you deploy the IBM® Intelligent Operations Center installation files and install the database, configure Eclipse.

1. To start Eclipse, either open a command prompt and enter the following command, or create a desktop shortcut for the command:

   C:\home\ibmadmin\eclipse\eclipse.exe

2. At the prompt, select the following workspace: C:\home\ibmadmin\workspaces\spf
3. Configure the server:
   1. In Eclipse, in the Servers view, right-click in any open space and then click New > Server.
   2. Either enter or select the following values, and then click Next:
      • • If you installed IBM Intelligent Operations Center V5.2.1, for Server type select IBM > Liberty Server.
        • If you installed IBM Intelligent Operations Center V5.2.0, for Server type select IBM > WebSphere Application Server Liberty.
      • For Server's host name, enter localhost.
      • For Server name, enter WebSphere Application Server Liberty Profile.
   3. Either enter or select the following values, and then click Next:
      • For Runtime Environment Name, enter WebSphere Application Server Liberty Profile.
      • For How do you want to create the runtime environment, select Choose an existing installation.
      • For Path, enter C:\home\ibmadmin\liberty.
      • For JRE, select Use default JRE.
   4. For Liberty profile server, select defaultServer, and then click Finish.
4. Import the IBM Intelligent Operations Center development environment projects into the workspace:
   1. In Eclipse, click File > Import > General > Existing Projects into Workspace, and then click Next.
   2. Select Select root directory.
   3. Click Browse, and select C:\home\ibmadmin\workspaces\spf. The Projects list shows the available projects.
   4. Click Select All.
   5. Under Options and Working Sets, clear all the options.
   6. Click Finish.
5. Wait for Eclipse to refresh and build the workspace. This process can take up to 5 minutes.
6. Add the projects to the server:
   1. In Eclipse, in the Servers view, right-click WebSphere Application Server Liberty Profile > Add and Remove.
   2. Add the following projects to the server:
      • ica_solution_ear
      • ioc_solution_ear
      • ioc_theme_ear
   3. Optional: If you installed SPSS® Modeler Server, SPSS Modeler Batch, and SPSS Data Access Pack, add the ASK_ear project to the server.
7. Optional: If you added the ASK_ear project to the server, run the following commands from a command prompt:

   mkdir c:\opt\IBM\ioc\ASK
   xcopy c:\home\ibmadmin\workspaces\spf\ioc_install\ioc\ASK c:\opt\IBM\ioc\ASK /s /e

8. From Eclipse, edit the c:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\setup.properties file and modify all variables to match your environment. Ensure that you update the DB2_HOSTNAME, DB2_PORT, DB2_INSTANCE_USER, and JAVA_DIR variables to match the values that you selected when you installed the database.
   • If you installed IBM Intelligent Operations Center V5.2.1, from Eclipse, edit the c:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\setup.properties file and modify all variables to match your environment. Ensure that you update the DB2_HOSTNAME, DB2_PORT, DB2_INSTANCE_USER, and JAVA_DIR variables to match the values that you selected when you installed Db2®.

     SET DB2_HOSTNAME=localhost
     SET DB2_PORT=50000
     SET DB2_INSTANCE_USER=db2i1own
     SET DB2_INSTANCE_USER_PWD=db2_instance_user_pwd
     SET JAVA_DIR=C:\Program Files\IBM\Java80\jre\bin

   • If you installed IBM Intelligent Operations Center V5.2.0, from Eclipse, edit the c:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\liberty\setup.bat script and modify all variables to match your environment. Ensure that you update the DB2_HOSTNAME, DB2_PORT, DB2_INSTANCE_USER, and JAVA_DIR variables to match the values that you selected when you installed DB2®.

     SET DB2_HOSTNAME=localhost
     SET DB2_PORT=50002
     SET DB2_INSTANCE_USER=db2i1own
     SET DB2_INSTANCE_USER_PWD=db2_instance_user_pwd
     SET JAVA_DIR=C:\Program Files\IBM\Java70\jre\bin

     • The JAVA_DIR variable in the setup.bat script refers to a Java 7.0 installation location. If the installation uses Java 8.0, update this variable to refer to the Java 8.0 path.

       SET JAVA_DIR=C:\Program Files\IBM\Java80\jre\bin

9. To configure the server.xml file for WebSphere® Application Server Liberty Profile, run the following commands from a command prompt:

   cd C:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\liberty
   setup.bat

   Note: Ensure that the setup.bat command has completed before you proceed to the next step.
10. In Eclipse, on the Servers tab in the bottom pane, expand WebSphere Application Server Liberty Profile at localhost.
11. To open the server.xml file, double-click Server Configuration [server.xml].
12. Click the Design tab. The Design tab is at the bottom of the Server Configuration: defaultServer (server.xml) tab.
    Note: Do not edit the XML on the Source tab.
13. On the Design tab, expand Server Configuration > Data Source: jdbc/ioc, and then click DB2 JCC Properties. Scroll down through the list of properties to locate and update the following value with the value that you configured for your databases:
    • Password

      Next to the Password field, click Set. In the "Set Password" window, enter the password and accept the default encoding method.

      Note: Set the Password value and then confirm that the Port number, Server name, and User values are already set correctly.
14. On the Design tab, expand Server Configuration > Data Source: jdbc/iocdata, and then click DB2 JCC Properties. Scroll down through the list of properties to locate and update the following value with the value that you configured for your databases:
    • Password

      Next to the Password field, click Set. In the "Set Password" window, enter the password and accept the default encoding method.

      Note: Set the Password value and then confirm that the Port number, Server name, and User values are already set correctly.
15. On the Design tab, expand Server Configuration > Data Source: DefaultDataSource, and then click DB2 JCC Properties. Scroll down through the list of properties to locate and update the following values with the value that you configured for your databases:
    • Password

      Next to the Password field, click Set. In the "Set Password" window, enter the password and accept the default encoding method.

      Note: Set the Password value and then confirm that the Port number, Server name, and User values are already set correctly.
16. To save the server configuration, press CTRL-S. Alternatively, close the Server Configuration: defaultServer (server.xml) tab and save the server configuration at the prompt.
    Note: It might take several minutes for the configuration to be saved, during which time Eclipse appears to stop responding.
17. If you installed IBM Intelligent Operations Center V5.2.0, complete the following steps create the SSL certificate. These steps are not required for V5.2.1.
    1. In Eclipse, in the Servers view, right-click WebSphere Application Server Liberty Profile at localhost > Utilities > Create SSL Certificate..
    2. Either enter or select only the following values:
       • For Keystore password, enter a password that you will remember.
       • For Encoding, select xor (encode using XOR).
    3. Do not select any other options. Click Finish.
    4. At the prompt, select Yes to overwrite the key.jks file.
    5. Click OK to close the completion message.