View source for Upgrade

Upgrading Instructions for eoStar, the workstations, and Mobile Devices are found below. Upgrades are available when new releases are made public. To upgrade eoStar, follow the instructions below.

For a list of items no longer supported by Rutherford and Associates, see [[Discontinued Support]].

== Backups ==
===To Create a backup (in SQL Management Studio)===
# Right-click the database and select '''Tasks->Backup'''
# In the '''General''' pane, click '''Add''' in the lower portion of the window.  Be sure to remove any entries with the '''Remove''' feature if applicable.
# Specify a backup name and destination (usually cannot be directly into the C:folder, must include .bak in the file name).
# Click '''OK'''

=== To Restore From a Backup (in SQL Management Studio) ===
# Right-click the database folder under the server and select '''Tasks->Restore->Database'''.
# Specify database name that eoStar will look for under the '''To Database''' field (what the DB was named on the old server).
# Select '''From Device''' and specify the .bak file to be restored from.
# Once the .bak file is specified, switch to the '''Options''' pane in the top-left of the window.  Ensure that all files listed in the grid have a different filename ending (usually it's _1 through _4, with one file being numberless.
# Click '''OK''' (from the General pane of the Restore window).

== Download / Install files from Sharepoint Site ==
The package will have several files contained within it. Most notably, the '''eonetservice.zip file''', the '''Setup.msi file''', '''eoMobileCFCAB''', and '''eoTabletSetup''':
*If your company uses '''WMS''' or '''VoCollect''' you will need to upgrade those servers as well with the appropriate eonetservice and Scheduler files. 

===eonetservices.zip===
# Open IIS on the server that controls communication with the handhelds and expand the tree to see '''eonetservice''' as shown below.
#:[[File:Eonet1.png|500px]]
# Right-click '''eonetservice''' and choose '''Deploy''' and then '''Delete Application and Content'''.
#:[[File:Eonet2.png|500px]]
# Click '''OK'''.
#:[[File:Eonet3.png|500px]]
# Right-click '''Default Web Site''' and choose '''Deploy''' and then '''Import Application'''.
#:[[File:Eonet4.png|500px]]
# Browse for the '''eonetservice''' zip file.
#:[[File:Eonet5.png|500px]]
#:[[File:Eonet6.png|500px]]
# Click '''Next''' and then pick the defaults to install '''eonetservice'''.
#:[[File:Eonet7.png|500px]]
# Click '''Finish'''.

===Setup.msi - To be installed on the server first===
# If applicable, uninstall the last version of eoStar.
#:[[File:Eo1.png|500px]]
# Either go to <nowiki>'''https://eosupport.ruthsx.com/sites/CustomerSupport/###YourCompanyName###/default.aspx'''</nowiki> or download from the FTP site. To setup an FTP connection to Rutherford, see [[Connecting to the Rutherford FTP]].
# Install the new eoStar package from the supplied folder. Save a copy to your network to make upgrading your workstations easier.
#:[[File:Eo2.png|500px]]
# Select '''Run''' and follow the setup prompts, choosing the default options.
# Once the server has been upgraded, log into the database to upgrade it.  This can be performed on the 'test' or 'live' databases at your discretion.  <span style="background:yellow">As of July 2016, Rutherford will be performing a check to determine whether a database is a live or not. If the database is identified as live, then an upgrade code will be required to upgrade the database. All customers who are upgrading must have a valid upgrade code for the day they are upgrading. Without the code, they will be unable to proceed</span>. 
#:[[File:Eo3.png|500px]]
# Click '''Upgrade schema now'''.
#:[[File:Eo4.png|500px]]
# Click '''Done'''.
#:[[File:Eo5.png|500px]]
# Log in to eoStar.
# Go to File > Database Administration > Cache Folder. This will open the Cache Folder.
# Close eoStar.
# In the Cache Folder, delete '''Plusoption.Cache''' and '''RecordInfo.Cache'''. Close the folder.
# Open and log in to eoStar.
# Go to Records > Product > Records and search for a product to rebuild the cache. 
# Repeat Steps 8-13 after you upgrade eonetservice, eoStar, and Scheduler for ''every'' server that you have.

===For Coke Customers Only===
After completing the steps in Setp.msi, do the following in eoStar:
# Go to File > Database Administration > Configure > Coke panel.
#:[[Image:Upgrade_Coke2.png]]
# Enter your unique '''ISSCOM code'''. If you do not know your ISSCOM code, contact your account manager at Rutherford and Associates.
# Click '''Post'''.

===eoMobileCFCAB and eoTabletSetup===
Handhelds and tablets will also have to be upgraded to the new version using the following instructions:
* After a version is assigned, it becomes available on the handheld through an [[Handheld - Upgrading|Upgrade]]. For a tutorial video on this subject, see [[Mobile Device Manager Tutorial Video - Assigning Handheld Versions|Mobile Device Manager Tutorial Video - Assigning Handheld Versions]].
* Additionally, due to a new version of printer drivers, some mobile printers must be setup once again when upgrading eoMobile.

# Go to Records > Handheld > Mobile Device Manager.
#:[[File:Handheldup1.png|500px]]
# Click '''Get Latest Version Information''' to obtain the latest version published by Rutherford.
#:[[File:Handheldup2.png|500px]]
# Select the handheld records and click '''Assign Version'''.
#:[[File:Handheldup3.png|500px]]
# Highlight and select the version off the version options list.  You can then select the day it will push to the mobile device.  Click '''Assign Selected Version'''.
#:[[File:Handheldup4.png|500px]]
# Click "Post New Assignments" when finished.
# When the user of the mobile device full syncs, they will see a link on their display that they will touch to upgrade to the new version.
#* Note: After the Q2 upgrade has been completed, the user will need to reconfigure the printer settings on the handheld, choosing a specific printer rather than a general manufacturer.

===VoCollect eonetservices.zip and Scheduler===
* After you've completed the update for your core system, please be sure that you updated any servers set up specifically for VoCollect or WMS devices. You'll need to deploy eonetservice the same as you did for your handheld devices and make sure that the new scheduler is installed.
* Note: After the scheduler is installed, please make sure that you have a working config file in the folder, then proceed to windows services and make sure that the VoCollect service is running and set to automatic start. '''As of January 2016: Scheduler, Vocollect, and other services are set to manual by default when you install scheduler, you will likely want to change the desired services to be automatic.'''

===Upgrading Workstations===
Each individual workstation will need to be upgraded to the newest version of eoStar as well. 
# In the computer's control panel Add or Remove Programs functionality, find eoStar and uninstall it.
# Install eoStar from where you saved it on your network. 
# Open eoStar.

== eoTouch ==
# If the eoTouch app is open on the device (iPad, iPhone) that you would like to upgrade, close the app by double tapping the home button and swiping the eoTouch app up.
# Uninstall eoTouch on the Device by pressing and holding the eoTouch app icon until it starts to wiggle. Once it begins to wiggle, tap the '''X''' in the upper left corner. You will receive a pop up confirming that you would like to delete the app. Tap '''Delete'''.
# You will receive a link for the eoTouch upgrade via email. Open the email on the device that you would like to upgrade.
# Tap the link.
# Install the app.


[[Category:Database Administration]]
[[Category:Upgrade]]
[[Category:Installation]]
[[Category:Overview]]