Upgrading ShipRush

This article applies to ShipRush UPS Basic. If using ShipRush UPS Pro, please refer to the appropriate page.

 

If you use a custom integration with ShipRush (aka ShipRush SDK), you are probably fine (integrations to v4/v5 typically work without changes with newer versions). However, be sure to contact your developer before upgrading ShipRush.

 

If your existing ShipRush system tenders errors please STOP. Contact Z-Firm Technical Support to get these issues resolved before upgrading.

 

ShipRush v4/v5 serial numbers work fine with newer versions of ShipRush. You do not need a new serial number from Z-Firm.

 

The upgrade will not move the ShipRush v4/v5 database. The existing database will be left in place, so that network mappings to it are not affected. This may mean that your database continues to reside in a directory like

    "C:\Documents and Settings\<YOUR USER NAME>\Application Data\z-firm llc\ShipRush v4\Database.v4\"

 

If ShipRush runs on only one PC

If you run ShipRush v4/v5 on a single PC, use this five-step process:

 

  1. Turn off anti-virus software

  2. Exit ShipRush completely.
    This includes clicking on the little ShipRush icon and selecting "Exit" from the menu. (Older versions of ShipRush require a Right Click on this icon.)

  3. Download and run the new ShipRush installer

  4. Complete the simple wizard

  5. Remove the ShipRush v4/v5 icons if still present

 

Done!

 

Final clean up: Delete the downloaded installer (so you do not accidentally run it again), and delete any icons in the Start menu for earlier versions of ShipRush.

ShipRush is on multiple PCs

For most businesses, ShipRush is an important production system. So it is prudent to prepare properly for the upgrade. Preparation has three goals:

 

  1. Ensure that the upgrade goes smoothly

  2. Prepare to roll back to v4/v5 in case something goes wrong with the upgrade

  3. Understand technically what is going on behind the scenes

 

Before Upgrading to v6:

 

Identify the PC that is the ShipRush v4/v5 'server' system. This is the PC that has the "Z-Firm ShipRush v4" (or 'v5') service present:

 

 

 

Remember to turn off all anti-virus software prior to running the ShipRush upgrade.

 

This server PC will be upgraded first. On this system, take these steps:

 

  1. Process any end of day reports (if that is part of your routine)

  2. Ensure that the ShipRush program has been closed on all workstations.

  3. Exit the ShipRush program on this system (the "server")

  4. Turn off anti virus software (until after the whole process is done)

  5. Identify the workstations that will need to be upgraded.

 

Now run the ShipRush installer (the file downloaded from www.zfirm.com). Select the upgrade option in the wizard.

 

After the upgrade there are these steps:

 

  1. Do a single shipment in the new ShipRush version to confirm proper operation

  2. Configure printers as needed in ShipRush

  3. Check ShipRush settings (some settings may not migrate and may need to be re set)

  4. Install the new ShipRush version on workstations. During the wizard, direct ShipRush to ShipRush 'server' PC (the first system that was upgraded -- the PC that has the Z-Firm ShipRush service)

  5. Remove the ShipRush v4/v5 icon wherever it appears (ShipRush v4/v5 will not function at this point, so remove the icon before users try it and get an error)

 

 

 

Technical Details of the ShipRush v4/v5 to v6 Migration (Optional Reading)

 

ShipRush v4/v5 has three main components:

 

 

ShipRush v6 Pro has the same list:

 

 

With ShipRush v6, network workstations can either access the database directly (as in v4/v5) or can connect to the database via the ShipRush 'server' PC name.