Upgrading NEOSYS: Difference between revisions

From NEOSYS Technical Support Wiki
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
== Upgrading NEOSYS fully ==
== Upgrading NEOSYS fully ==
NEOSYS can be upgraded in two ways either in the night before the daily backup or during the day.
NEOSYS can be upgraded in two ways either in the night before the daily backup or during the day.


Line 61: Line 60:


=== Downloading ===
=== Downloading ===
Get the latest version of NEOSYS
Get the latest version of NEOSYS


Line 69: Line 67:


=== Downloading previous versions of NEOSYS ===
=== Downloading previous versions of NEOSYS ===
The 9 previous versions of neosys are stored at:
The 9 previous versions of neosys are stored at:


Line 92: Line 89:


=== Backing up prior to upgrading ===
=== Backing up prior to upgrading ===
THIS WHOLE BACKUP PROCEDURE IS MANDATORY
THIS WHOLE BACKUP PROCEDURE IS MANDATORY


Line 98: Line 94:


==== Small Installations ====
==== Small Installations ====
#Take a normal proper backup using the NEOSYS Support Menu - for all live databases if there is more than one.
#Take a normal proper backup using the NEOSYS Support Menu - for all live databases if there is more than one.
#If a USB change was made by the client's IT person prior to doing this manual backup, ensure that after the upgrade is done, the backup file for that manual backup is moved to another location (preferably in a new folder on the D drive)so that the clients backup cycle is not affected by the existence of a days backup in the USB before the cycle actually begins the following morning.  
#If a USB change was made by the client's IT person prior to doing this manual backup, ensure that after the upgrade is done, the backup file for that manual backup is moved to another location (preferably in a new folder on the D drive)so that the clients backup cycle is not affected by the existence of a days backup in the USB before the cycle actually begins the following morning.  
Line 104: Line 99:


==== Large Installations ====
==== Large Installations ====
Copying the whole of the D:\NEOSYS folder can take so much time as to be virtually impossible. In this case do the upgrade EARLY IN THE MORNING since all the data will have been backed up the previous night. The NEOSYS nightly backup only backs up data, so you MUST manually take copies of the following folders which contain the current version of the programs that are going to be upgraded.
Copying the whole of the D:\NEOSYS folder can take so much time as to be virtually impossible. In this case do the upgrade EARLY IN THE MORNING since all the data will have been backed up the previous night. The NEOSYS nightly backup only backs up data, so you MUST manually take copies of the following folders which contain the current version of the programs that are going to be upgraded.


Line 110: Line 104:
#D:\NEOSYS\NEOSYS.NET
#D:\NEOSYS\NEOSYS.NET
#D:\NEOSYS\NEOSYS.MAC or  D:\NEOSYS\NEOSYS.W3C
#D:\NEOSYS\NEOSYS.MAC or  D:\NEOSYS\NEOSYS.W3C


=== Installing ===
=== Installing ===
Line 126: Line 119:


=== Post installation steps ===
=== Post installation steps ===
New versions of the software sometimes perform quick or long database conversions.
New versions of the software sometimes perform quick or long database conversions.


Line 135: Line 127:


==== Sample Email to be sent to the Clients AFTER an upgrade or patch ====
==== Sample Email to be sent to the Clients AFTER an upgrade or patch ====
<pre>
<pre>
  We have upgraded your version of NEOSYS. Please forward this email to all staff using NEOSYS.
  We have upgraded your version of NEOSYS. Please forward this email to all staff using NEOSYS.
Line 148: Line 139:


=== Troubleshooting ===
=== Troubleshooting ===
If you choose to abort the installation for any reason then the GLOBAL.END file will have to be deleted manually since its presence prevents any processes from starting up.
If you choose to abort the installation for any reason then the GLOBAL.END file will have to be deleted manually since its presence prevents any processes from starting up.


== Upgrading NEOSYS with patch files ==
== Upgrading NEOSYS with patch files ==
Patch files can be used to update a very recent installation of neosys without doing a full install and without getting people out of NEOSYS.
Patch files can be used to update a very recent installation of neosys without doing a full install and without getting people out of NEOSYS.


Line 161: Line 150:
#INSTALL ADAGENCY
#INSTALL ADAGENCY
#Follow instructions
#Follow instructions
== Quick Upgrade ==
In certain cases, we may have to perform an upgrade during client's working hours without causing much delay to client.
Procedure:
#Backup the NEOSYS folder.
#*Go to the folder where NEOSYS is installed and do select all, copy & paste i.e. ctrl+a , ctrl+c & ctrl+v
#Download the latest version of NEOSYS from http://www.neosys.com/support/neosys2.exe in NEOSYS\downloads folder and rename it to neosys2-(DATE).exe
#Run the exe file
#Restart NEOSYS processes on the server immediately after the installation has completed!

Revision as of 13:41, 22 April 2012

Upgrading NEOSYS fully

NEOSYS can be upgraded in two ways either in the night before the daily backup or during the day.

Procedure to upgrade NEOSYS during the day.

  1. Email the management and staff the standard email on upgrade for agreement of time.
  2. Confirm the date and time and inform the staff about the update.
  3. During upgrade make sure all users are logged off and follow the installation procedures.
  4. Once the upgrade is over mail the management and staff the steps they should perform before using NEOSYS.

NEOSYS can also be upgraded with smaller patches by the programmer and this can be done at any time while the users are working

Sample Emails to be sent PRIOR to Upgrading NEOSYS

Any decision or instructions related to upgrading neosys must be in support@neosys.com i.e. please ensure that all emails are sent to clients while mentioning support@neosys.com in cc.

Informing the client of the intention to upgrade

SAMPLE EMAIL - VERSION 1: For Clients with more than 10 users

Dear Team,

NEOSYS needs to be updated to its latest version.
 
We will upgrade between 9 am – 10am on (the selected date).
 
The upgrades should be done first thing in the morning after the daily backup, as the upgrade can be completed in a short time . 

* Please inform all users that they should be logged off during the upgrade. 

Please contact NEOSYS support immediately if you have any concerns about the upgrade.

SAMPLE EMAIL - VERSION 2: For Clients with 5 to 10 users

Dear Team,

NEOSYS system will be down for maintenance/upgrade and not available without further notice at the following time.

        Today/23rd February, 1:00pm to 2:00pm (time zone) 

* Please inform all users that they should be logged off during the upgrade. 

The upgrades should be done first thing in the morning after the daily backup, as the upgrade can be completed in a short time. Contact NEOSYS support immediately if you have any concerns about the upgrade.

We will notify you immediately once the work is complete.

SAMPLE EMAIL - VERSION 3: For Clients with less than 5 users

Dear Team,

NEOSYS system will be down for maintenance/upgrade and not available without further notice at the following time.

        Tomorrow/23rd February, 9:00am to 10:00am (time zone) 

* Please inform all users that they should be logged off during the upgrade. 

We will notify you immediately once the work is complete.

Downloading

Get the latest version of NEOSYS

Download http://www.neosys.com/support/neosys2.exe in NEOSYS\downloads folder and rename it to neosys2-(DATE).exe (eg neosys2-10th November 2009.exe) - this is to keep track of the various downloads we do for the client and also allows to install a previous version if needed.

*** IMPORTANT: DO NOT RUN/EXECUTE THE NEOSYS EXE FILE NOW ***

Downloading previous versions of NEOSYS

The 9 previous versions of neosys are stored at:

http://www.neosys.com/support/neosys21.exe

http://www.neosys.com/support/neosys22.exe

http://www.neosys.com/support/neosys23.exe

http://www.neosys.com/support/neosys24.exe

http://www.neosys.com/support/neosys25.exe

http://www.neosys.com/support/neosys26.exe

http://www.neosys.com/support/neosys27.exe

http://www.neosys.com/support/neosys28.exe

http://www.neosys.com/support/neosys29.exe


Backing up prior to upgrading

THIS WHOLE BACKUP PROCEDURE IS MANDATORY

Make sure that all NEOSYS users are logged off and the processes are closed before you do any folder copying.

Small Installations

  1. Take a normal proper backup using the NEOSYS Support Menu - for all live databases if there is more than one.
  2. If a USB change was made by the client's IT person prior to doing this manual backup, ensure that after the upgrade is done, the backup file for that manual backup is moved to another location (preferably in a new folder on the D drive)so that the clients backup cycle is not affected by the existence of a days backup in the USB before the cycle actually begins the following morning.
  3. Take a copy of the whole of the D:\NEOSYS folder (or where-ever NEOSYS is installed) into another folder. You can omit the D:\NEOSYS\IMAGES and D:\NEOSYS\LOGS folders from the copy to save time. Preferably place the copy on another disk or partition so that it is not included in any whole disk backup that might be running in parallel to NEOSYS backup.

Large Installations

Copying the whole of the D:\NEOSYS folder can take so much time as to be virtually impossible. In this case do the upgrade EARLY IN THE MORNING since all the data will have been backed up the previous night. The NEOSYS nightly backup only backs up data, so you MUST manually take copies of the following folders which contain the current version of the programs that are going to be upgraded.

  1. D:\NEOSYS\NEOSYS
  2. D:\NEOSYS\NEOSYS.NET
  3. D:\NEOSYS\NEOSYS.MAC or D:\NEOSYS\NEOSYS.W3C

Installing

Run / Execute the .EXE file that you downloaded into the NEOSYS\downloads folder and Install to the D:\NEOSYS\ folder.

Closing NEOSYS processes should happen automatically during upgrade but you can also do it manually as follows:

Closing NEOSYS services

The installation procedure first creates a GLOBAL.END file in the NEOSYS programs folder causing all serving processes to terminate. Maintenance processes must be terminated manually.

Next, the installation procedure attempts to update the WAITING.EXE file and, if the processes haven’t terminated quickly enough, this will fail asking for retry or abort. Retry immediately or once all the processes have terminated.

The last step of the installation procedure is to delete the GLOBAL.END file to allow processes to start normally.

Post installation steps

New versions of the software sometimes perform quick or long database conversions.

Starting NEOSYS in maintenance mode immediately after upgrading leaves you more in control if anything goes wrong.

It not necessary to use the maintenance mode to start-up once after upgrading and before starting an automatic neosys process.


Sample Email to be sent to the Clients AFTER an upgrade or patch

 We have upgraded your version of NEOSYS. Please forward this email to all staff using NEOSYS.

 Please follow these instructions to clear your temporary internet files BEFORE you login to NEOSYS.

 http://userwiki.neosys.com/index.php/Cache
 
 This is required because your Internet Explorer may have saved old versions of the software
 and they must be cleared to avoid any possible errors.

Troubleshooting

If you choose to abort the installation for any reason then the GLOBAL.END file will have to be deleted manually since its presence prevents any processes from starting up.

Upgrading NEOSYS with patch files

Patch files can be used to update a very recent installation of neosys without doing a full install and without getting people out of NEOSYS.

If in doubt do a full install.

  1. Copy the file which is probably something like ADAGENCY.1 or ACCOUNTS.1 to the neosys\neosys folder
  2. F5
  3. INSTALL ADAGENCY
  4. Follow instructions

Quick Upgrade

In certain cases, we may have to perform an upgrade during client's working hours without causing much delay to client.

Procedure:

  1. Backup the NEOSYS folder.
    • Go to the folder where NEOSYS is installed and do select all, copy & paste i.e. ctrl+a , ctrl+c & ctrl+v
  2. Download the latest version of NEOSYS from http://www.neosys.com/support/neosys2.exe in NEOSYS\downloads folder and rename it to neosys2-(DATE).exe
  3. Run the exe file
  4. Restart NEOSYS processes on the server immediately after the installation has completed!