How to upgrade to Amethyst Version 1.4 for Windows

[Belinda Frick]

Please note this document is untested.
Please ensure that you have a backup of everything


The steps that follow here have to be completed in this order
and not at random.

All this will be done on the server

Do not attempt this if you are not on Amethyst 1.3

Close all Amethyst programs.
Make sure you have a backup before attempting anything
Make sure that you have the same amount of free space
available that your database is currently using, plus 20 % for
extras. eg. If Database is 100GB then you need 120GB free;
If there is not enough space on the local machine, you will
have to get another machine to move the database on and from
there back to the local machine.

Run Amethyst.Upgrade.Database.1.4.exe
This will extract the files you need for the upgrade:
AMT_Exclusive.exe
amt.sql
amtrsmove.exe
amtrsmove.ini
AMTUPGRD.exe
DBCreate.exe
AMTArc.exe
fbclient.dll
midas.dll
msvcp60.dll
qtintf70.dll

You can only proceed if you are running version 1.3
If not upgrade to 1.3 by running AMTUPGRD.exe.
Remember that your archived databasis is a different version,
therefore unless you also update them, you cannot do
searched on these databases.

Remember to always run a purge (AMTARC.exe) on the database for the whole
time period.

Uninstall Interbase.
Install Firebird. If you are using two machines,
install Firebird on both.

Run AMTExclusive.
If you are using one machine.
Make the location of the destination database
"C:\Program Files\Datatex\Amethyst\ExclusiveDBDir\"
The blob locations depend on the setup of the box. You can
not have a blob location on the same drive as which the
operating system and amethyst is installed.
e.g. 1=D:\Exclusive\ Make sure that the new amt.sql is used
to create the destination database.
If you are using two machine.
Create a shared directory on the destination machine called
DestExclusive. Run AMTExclusive on the local machine, make
the blob path \\HostNameOfMachine2\DestExclusive\ and the
source database location to the live database. The location
of the destination database must be
"C:\Program Files\Datatex\Amethyst\ExclusiveDBDir\".
Make sure that the new amt.sql is used to create the
destination database.
The database will now be exclusive. Make a backup of all
the files in the Amethyst directory.

On the client machines also make a backup of the amtsuper
directory before you upgrade to 1.4.

Install all the Amethyst 1.4 upgrades. This includes the
server,
sweeper,
supervisor,
USBClient,
SLVR,
amt.sql
and all the .dll's.
Change the servers ini to the new database location.
eg.PATH=GEM:C:\Program Files\Datatex\Amethyst\ExclusiveDBDir\amt.fdb
Open the server, but NOT THE SWEEPER!.

Open the new 1.4 supervisor and do some searches on the
database to make sure everything works. Remember to play the
recordings and look for screen shots.

In the sweepers ini file you have to enter the blob paths.

[PATHS]
1=D:\exclusive\

Multiple files can also be entered. e.g. 2=E:\exclusive, etc.

Also change the database location to the new location.

DATABASENAME=gem:C:\Program FILES\Datatex\Amethyst\ExclusiveDBDir\amt.fdb

Open the sweeper and make sure that the files processed
do not have any error messages. If there are no error messages,
do some more searches on the supervisor and look for the new
data.

Amethyst 1.4 is now installed, you can now delete your
old database if ALL the Amethyst programs started up without
any errors and the searches were flawless.

If you are using two machines you can move the blob files
back to the local machine with amtrsmove.
To use amtrsmove close all Amethyst programs.
Example of Amtrsmove's ini file :
[DATES]
START=
STOP=
[PATHS]
BASEPATH =
DATABASE=C:\Program Files\Datatex\Amethyst\ExclusiveDBDir\amt.fdb
[DESTINATION]
1=D:\exclusive\
2=E:\exclusive\
3=F:\exclusive\

ALSO SEE: How to use amtrsmove.exe

Move the new destination database to
"C:\Program Files\Datatex\Amethyst\Data\amt.fdb".
Change the server and sweepers ini files to point to
"C:\Program Files\Datatex\Amethyst\Data\amt.fdb".