Upgrading NEOSYS

From NEOSYS Technical Support Wiki
Jump to navigationJump to search

Upgrading NEOSYS fully

Backing up prior to upgrading

THIS WHOLE BACKUP PROCEDURE IS MANDATORY

Make sure that all NEOSYS processes are closed before you do any folder copying.

Small Installations

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.

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

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.

Next run it.

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

Installing

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.

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.

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.

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