Upgrading from Emerlad 4.0-4.2 to Emerald 4.5
       -----------------------------------------------


Pre-install Checks
------------------

If you have replication enabled on your primary Emerald DB then you MUST
remove all replication and publications associated to the Emerald database
and all objects within the Emerald database before running the upgrade.  
If you do not remove all publications, the database updates for Emerald 
4.5 will fail and your Emerald 4.5 installation will not work correctly.

Once you have upgraded to 4.5, you need to re-create any previous
replication from scratch.  Since old publications will not include
any new tables or columns, the old publication will not be complete
and Emerald 4.5 will not work against the old publications.

If you have created or customized ANY reports, you MUST backup those
reports.  Many reports (including estatement.rpt) have been updated
and will most likely overwrite the reports you have changed or
customized.  Once you have finished installing Emerald 4.5, you can
copy your reports back.


Installing Emerald 4.5
----------------------

It is recommended (but not required) that you remove your previous
4.0-4.x installations and install a clean version of Emerald 4.5.

1) Use the Control Panel, Services option to stop all Emerald 
   services.  This includes Emerald Web Server, Emerald LDAP server,
   Emerald Network Collector, Emerald Task Scheduler, RadiusNT Admin, 
   and RadiusNT (for non-Windows platforms use ps and kill to stop 
   the background daemons).

2) It is highly recommended to backup your entire old Emerald directory.
   The easiest way to do this is to use explorer to make a copy of the
   directory to a safe place.

   If you choose to remove your previous Emerald, use Control Panel,
   add/remove programs to remove the previous installations of 
   Emerald.  You may also want to completely remove your Emerald
   directory (there may be some log files and such in there). 

3) Run the Emerald 4.5 setup program and install Emerald 4.5.  If
   you previously had Emerald installed, install it to the same
   directory as before.


Post Install Checks
-------------------

After you install Emerald 4.5 on an existing Emerald 4.x
system, it is highly recommended that you initially run the
web server in debug mode to verify the database upgrade completes
w/out an error.  To do this, open a command prompt and change
to your Emerald directory.  Then run the following command:

   emerwebsrv -debug

For non-Windows installations, change to your Emerald directory
and run the following command:

   ./emerwebsrv -debug

You should see many lines scroll by (the db update working).  When
it finishes scrolling you should see the last line containing

  ... Emerald Database Upgrade completed sucessfully.

If you do not see that as your last line (ie, you received an
error, please copy the last screen and paste it in an email to
support@iea-software.com.  

Once the upgrade is complete, press control-c to stop the debug 
mode and use control panel, services to restart all the services.

If you backed up any reports, make sure you copy those reports
back into your reports directory as well.