Upgrading a development edition on Windows

You can upgrade an existing installation of the development edition of IBM® Intelligent Operations Center on Windows to incorporate the latest updates.

1. Extract the contents of the installation file to a temporary directory, temp_directory.
   Note: The path to the temporary directory and the name of the temporary directory must not contain spaces.
2. Copy the contents of the temp_directory\workspaces\spf directory to C:\home\ibmadmin\workspaces\spf.
3. Switch to the db2_instance_user user to complete the database steps. For example, switch to the db2i1own user and complete the following steps:
   1. Open a command prompt with the Run as administrator option.
   2. Go to the C:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\db directory, which is where the database script batch files are located.
   3. Enter the following commands to create the IOCDB and IOCDATA databases, and to add the language translations:

      create_db.bat > trace.log
      create_datadb.bat > trace_data.log
      run_i18n.bat > trace_lang.log

4. Optional: If you want to use Integrated Crime Analytics, configure the database for Integrated Crime analytics:
   1. Go to the C:\home\ibmadmin\workspaces\spf\ioc_install\ioc\ica\db directory, which is where the Integrated Crime Analytics database batch script files are located.
   2. Enter the following command:

      updateIOCDB_db2 > traceica.log

5. Optional: If you are upgrading your WebSphere Application Server Liberty Profile as part of your IBM Intelligent Operations Center upgrade, complete the following steps. For example, if you are upgrading to WebSphere Application Server Liberty Profile V18.0.0.3:
   1. In Eclipse, delete the existing WebSphere Application Server Liberty Profile and then close Eclipse.
   2. Rename C:\home\ibmadmin\liberty to C:\home\ibmadmin\liberty_oldversion. For example, rename the directory to C:\home\ibmadmin\liberty_16.0.0.2.
   3. Copy the temp_directory\liberty directory to C:\home\ibmadmin.
   4. Complete the steps to configure WebSphere Application Server Liberty Profile in the procedure Configuring Eclipse and the WebSphere Application Server Liberty Profile server.
6. If you are upgrading to IBM Intelligent Operations Center V5.2.1, update the swid tags:
   1. Remove the swidtag files in the C:\home\ibmadmin\workspaces\spf\ioc_install\ioc\iso-swid directory.
   2. Copy all the files from the temp_directory\workspaces\spf\ioc_install\ioc\iso-swid directory to the C:\home\ibmadmin\workspaces\spf\ioc_install\ioc\iso-swid directory.
7. Prepare the setup.bat and server.xml files:
   • For IBM Intelligent Operations Center V5.2.1, in Eclipse edit the C:\home\ibmadmin\workspaces\spf\dev_ioc_install\ioc\config\liberty\setup.bat file to modify the variables to match your environment. Ensure that the DB2_HOSTNAME, DB2_PORT, and DB2_INSTANCE_USER variables match the values for your Db2® installation, and that the JAVA_DIR variable matches your installed Java.
   • For IBM Intelligent Operations Center V5.2.0, complete the following steps:
     1. Copy the C:\home\ibmadmin\workspaces\spf\ioc_install\ioc\config\liberty\setup.bat file to the temp_directory\workspaces\spf\ioc_install\ioc\config\liberty directory.
     2. Edit the temp_directory\workspaces\spf\ioc_install\ioc\config\liberty\setup.xml to replace the existing property entries with the following entries:

        <property name="server_dir" value="${server_dir}"/>
        <property name="liberty_instance_ssl_cert_pwd" value="${liberty_instance_ssl_cert_pwd}"/>
        <property name="ioc_sample_users_pwd" value="${ioc_sample_users_pwd}"/>
        
        <property name="ioc_install_root" value="${user.dir}/../../../../ioc_install/ioc"/>
        <property name="csv_dir" value="${csv_dir}" />
        <property name="properties_dir" value="${properties_dir}" />
        
        <property name="db2_hostname" value="${db2_hostname}"/>
        <property name="db2_port" value="${db2_port}"/>
        <property name="db2_instance_user" value="${db2_instance_user}"/>
        <property name="db2_instance_user_pwd" value="${db2_instance_user_pwd}"/>
        
        <property name="spss_batchbase_install_dir" value="${spss_batchbase_install_dir}"/>
        <property name="cplex_install_dir" value="${cplex_install_dir}"/>
        <property name="ldap_hostname" value="${ldap_hostname}"/>

8. To configure the server.xml file for WebSphere Application Server Liberty Profile, run the following commands:

   cd temp_directory\workspaces\spf\ioc_install\ioc\config\liberty
   setup.bat

   Note: Ensure that the setup.bat command has completed before you proceed to the next step.
9. In Eclipse, on the Servers tab in the bottom pane, expand WebSphere Application Server Liberty Profile at localhost.
10. To open the server.xml file, double-click Server Configuration [server.xml].
11. 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.
12. 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.
13. 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.
14. 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.
15. 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.
16. Create the SSL certificate:
    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.
17. On the Servers tab, right-click WebSphere Application Server Liberty Profile at localhost > Stop.
18. Refresh the project contents, then select Project > Clean and select the option to clean all projects.
19. On the Servers tab, right-click WebSphere Application Server Liberty Profile at localhost, and then select Clean server on next restart.
20. Click Publish.
21. On the Servers tab, right-click WebSphere Application Server Liberty Profile at localhost > Start.