Upgrading Sterling Warehouse Management System

Procedure

  1. To upgrade the factory defaults for the 9.3 Add-in, run the following commands from the <INSTALL_DIR>/WMS/Migration/WMS_Add-in/9.1 folder:
    • When migrating from Releases 2.5, 8.0, 8.5, or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=upgrade-transaction-tables migrate -l <logfile>

    • When migrating from Releases 2.5.1, 7.3, 7.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=upgrade-transaction-tables migrate -l <logfile>

  2. To update the SI_VERSION table for the 9.3 Add-in, run the following commands from the <INSTALL_DIR>/WMS/Migration/WMS_Add-in/9.1 folder:
    • When migrating from Releases 2.5, 8.0, 8.5, or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=update-application-version migrate -l <logfile>

    • When migrating from Releases 2.5.1, 7.3, 7.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=update-application-version migrate -l <logfile>

    These commands perform the following tasks:
    1. Execute the changes in the factory setup XML.
    2. Execute the following tasks:
      • apply-fc-setup
      • pre-transaction-migration
      • migrate-transaction-data
      • post-transaction-migration
      • update-application-version
    3. After the tasks are completed, search for all the *.restart files under the following directories:
      • 9.1/database/FactorySetup/XMLS/ynw
      • 8.5/database/FactorySetup/XMLS/ynw
      • 8.0/database/FactorySetup/XMLS/ynw
      • 7.5/database/FactorySetup/XMLS/ynw
      • 7.3/database/FactorySetup/XMLS/ynw
      • 2.5.1/database/FactorySetup/XMLS/ynw
      • 2.5/database/FactorySetup/XMLS/ynw
    4. Ensure that Completed="Y" for all the tasks.

      If Completed="Y", it means that the upgrade tasks are successfully completed. If Completed="N" for any task, contact the Selling and Fulfillment Foundation Technical Support with all the restart files and log files. Do not proceed with the upgrade.

    5. Creates the following *.done files in the 9.1/status folder:
      • transaction_ant_migration.xml.done
      • transaction_ant_postmigration.xml.done
      • transaction_ant_premigration.xml.done
      • transaction_ant_upgradepreparation.xml.done
      • transaction_ant_validation.xml.done
      • transaction_ant_ynwapplyfcsetup.xml.done
      • transaction_ant_applicationversion.xml.done

      If you are upgrading from previous release to 9.3, the same *.done files will be created in the status folder of each release upto 9.1.

      For example, if you are upgrading from 2.5, the *.done files will be available in the status folder of Releases 2.5, 2.5.1, 7.3, 7.5, 8.0 and 9.1.

  3. To clean up all the *.restart and *.done files before restarting the upgrade, execute the following commands:
    • When migrating from Releases 2.5 or 8.0 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=clean-up-for-rerun migrate

    • When migrating from Releases 2.5.1, 7.3,7.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=clean-up-for-rerun migrate

  4. To upgrade the factory defaults for , Release 9.3, run the following commands from the <INSTALL_DIR>/WMS/Migration/WMS/9.1 folder:
    • When migrating from Releases 1.0, 2.0, 2.5, 8.0,8.5, 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=upgrade-transaction-tables migrate -l <logfile>

    • When migrating from Releases 2.5.1, 7.3, 7.5, 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=upgrade-transaction-tables migrate -l <logfile>

  5. To update the SI_VERSION table for the , Release 9.3, run the following commands from the <INSTALL_DIR>/WMS/Migration/WMS/9.1 folder:
    • When migrating from Releases 1.0, 2.0, 2.5, 8.0, 8.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=update-application-version migrate -l <logfile>

    • When migrating from Releases 2.5.1, 7.3, 7.5, 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=update-application-version migrate -l <logfile>

    These commands perform the following tasks:
    1. Execute the changes in the factory setup XMLs.
      Note: The factory setup upgrade is not executed in the activator mode. Therefore, the event handlers and pipeline conditions are not overridden.
    2. Execute the following tasks:
      • apply-fc-setup
      • pre-transaction-migration
      • migrate-transaction-data
      • post-transaction-migration
      • update-application-version
    3. After the tasks are completed, search for all the *.restart files under the following directories:
      • 9.1/database/FactorySetup/XMLS/ynw
      • 8.5/database/FactorySetup/XMLS/ynw
      • 8.0/database/FactorySetup/XMLS/ynw
      • 7.5/database/FactorySetup/XMLS/ynw
      • 7.3/database/FactorySetup/ynw
      • 2.5.1/database/FactorySetup/ynw
      • 2.5/database/FactorySetup/ynw
      • 2.0/database/FactorySetup/XMLS/ynw
      • 1.0/database/FactorySetup/XMLS/ynw
    4. Ensure that Completed="Y" for all the tasks.

      If Completed="Y", the upgrade tasks are successfully completed. If Completed="N" for any task, contact Selling and Fulfillment Foundation Technical Support with all the restart files and log files. Do not proceed with the upgrade.

    5. Create the following *.done files in the 9.1/status folder:
      • transaction_ant_migration.xml.done
      • transaction_ant_postmigration.xml.done
      • transaction_ant_premigration.xml.done
      • transaction_ant_upgradepreparation.xml.done
      • transaction_ant_validation.xml.done
      • transaction_ant_ynwapplyfcsetup.xml.done
      • transaction_ant_applicationversion.xml.done

      If you are upgrading from previous release to 9.3, the same *.done files will be created in the status folder of each release up to 9.1.

      For example, if you are upgrading from 2.5, the *.done files will be available in the status folder of Releases 2.5, 2.5.1, 7.3, 7.5, 8.5 and 9.1.

  6. To clean up all the *.restart and *.done files before restarting the upgrade, run the following commands:
    • When migrating from Releases 1.0, 2.0, 2.5, 8.0, 8.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -Dtarget=clean-up-for-rerun migrate

    • When migrating from Releases 2.5.1, 7.3,7.5 or 9.1 to 9.3, run:

      ${ANT_HOME}/bin/ant -f ynwmigration.xml -Druntime.old=<YFS_HOME_OLD> -Druntime=<INSTALL_DIR> -DYANTRA_HOME.OLD=<YANTRA_HOME_OLD> -Dtarget=clean-up-for-rerun migrate