Revision as of 15:02, December 4, 2017 by Peter Chaplin (talk | contribs) (→‎Procedure)
Jump to: navigation, search

Migration from 8.5.1x to 9.0.x

Prerequisites

  • iWD 9.0 requires Java 1.8. Support for Java 1.6 and 1.7 is withdrawn in release 9.0.

Procedure

  1. Backup all databases.
  2. Upgrade iWD dependencies to supported versions (see Preparing for Installation.
  3. Stop all iWD 8.5 components.
    1. iWD Manager's Tomcat.
    2. iWD Runtime Node.
    3. iWD Web.
  4. Install all components.
    1. Upgrade GAX plugin to a new version (at least 9.0.002.07) by uninstalling the previous GAX and installing the new one.
    2. Install History Node.
      1. Install History Node using this procedure. Set up JMS and JDBC Database Access Points (DAPs).
      2. Perform iWD History Node migration from the Event Log.
      3. Create a connection from the iWD Manager Application to the History Node application by using GAX.
      4. Create a connection from Interaction Server to the JMS DAP.
    3. Data Mart
      1. Migration of data from iWD Data Mart 8.5 to iWD Data Mart 9.0 is not supported due to schema changes—see History Node Limitations.
      2. History Node should be installed already.
      3. Migration
        1. Create a new database for Data Mart.
        2. Complete a fresh installation of Data Mart as a separate application.
        3. Copy all necessary settings from the iWD Runtime Node 8.5 application.
        4. Copy all customized ETL scripts to the iWD Runtime Node 9.0 ETL directory (../iWD Runtime Node 9.0/etl)
        5. Add the History Node application to the connections.
        6. Add the Configuration Server application to the connections.
        7. Create a Configuration Server database JDBC DAP with configuration option [iWD]/role = cfgserver and add it to the Runtime Node connections (a link to the documentation created in IWD-7024).
        8. Add a jdbc section with options url and driver-class to all created DAPs listed in the connections (a link to the documentation created in IWD-7024).
        9. Change or set the Data Mart application to a new one for all necessary solutions using GAX / iWD / Datamart / <Solution>.
        10. Using GAX, change the ETL Scripts Directory to a new one for each solution.
        11. Check that your Data Mart Business Structure Solution has a timezone set.
        12. Check that in the Data Mart application the schedules/historical and schedules/intraday are set as valid Quartz cron expressions.
        13. [Optional] Disable the EventLog as it was replaced by History Node and JMS event logger.
    4. Stat Server Extensions
      1. No actions required. There is no new version of Stat Server Java Extenions (BUT we have updated 9.0 component?) .
    5. iWD Manager
      1. iWD GAX Plugin must be updated already.
      2. Make a fresh installation using the information and migration notes in Installing iWD Manager
      3. Make sure iWD Manager 8.5 is stopped. Disable its autostart.
      4. Import new the iWD Manager 9.0 application templates (App and Server) as described in Installing iWD Manager.
      5. Create new application and server configuration objects based on the imported templates.
      6. Install the iWD Manager 9.0 application itself to a separate folder.
      7. Create a connection from the iWD Manager application to the History Node application by using GAX.
      8. Copy the required settings from the old iWD Manager application.
        1. Check you've created connections from the iWD Manager Application to UCS (if needed) and Interaction Server.
        2. Add necessary permissions for the iWD access group (to make users able to login, to read filter list , and so on).
      9. Make sure that host and port of the primary and backup Configuration Servers are presented in the General -> Command Line Arguments of the iWD Manager 9.0 Server.
      10. Run the separate iWD Manager Configuration Database to Configuration Server migration procedure.
      11. Open GAX and make sure that the Scripts -> iWD Manager folder is created and permissions to that folder are granted for the EVERYONE group.
    6. iWD Web
      1. Install a new iWD Web application as described in this series of topics.
  5. Start all iWD 9.0 components

Post-installation—Configuring the Solution

Once you have installed iWD 9.0, for each configured Solution you must:

  1. Navigate to iWD GAX plugin -> Business Structure -> <Solution name>.
  2. Complete the Interaction Server JDBC URL and save the changes.

iWD Manager-Specific Migration Information

???

History Node Specific Migration Information

iWD Web Specific Migration

In a migration from iWD 8.5.1 to 9.0, you will need to manually move the following three configuration options from the [boot] section to the [security] section:

  • iwdweb.tls.keyStore
  • iwdweb.tls.keyStorePassword
  • iwdweb.tls.validateCert
Comments or questions about this documentation? Contact us for support!