The epcEdit upgrade utility
The upgrade utility does not work for an upgrade from epcEdit
1.0x or epcEdit 1.1 to epcEdit 1.2!
epcEdit uses an HTTP-based upgrade utility for applying patches to an existing epcEdit installation. These patches are stored on the epcEdit web
server and can be retrieved and installed by the upgrade utility.
The upgrade utility performs incremental upgrades of an existing epcEdit installation. The upgrade utility examines the current version of the
epcEdit installation and will transfer and install only the files that are needed to upgrade the current installation to the highest available patchlevel. The upgrade utility can be invoked at any time
to check the epc web server for new patches. If no new patches are available, no files will be transferred and no changes will be made to an existing epcEdit installation.
We recommend to run the upgrade utility on a regular basis (e.g. once a month) to keep your installation of epcEdit up to date. Using the upgrade
utility on a regular basis will ensure that your epcEdit version contains all bug fixes and improvements that have been released for epcEdit.
Installation instructions for Linux and Solaris
The upgrade utility is a Tcl script that
has been installed in the epcEdit library directory. In order to use the upgrade script, you must have write access to this directory. Using the upgrade script is straight forward unless you are using a proxy server to access the Internet. Please refer to the section labeled "Using a proxy server" for detailed instructions.
To start the upgrade process, just enter the command
epcedit -upgrade
After the upgrade script has been launched, it will download and install all available patches as described in the section The upgrade process
below.
Installation instructions for Windows
The installation program has created an entry labeled Upgrade Utility
in the epcEdit sub-menu of the windows start menu. Click on this entry to start the upgrade utility. Using the upgrade script is straight forward unless you are using a proxy server to access the Internet. Please refer to the section labeled "Using a proxy server" for detailed instructions.
Using a proxy server
If you are using a proxy server to access the Internet, you will need to make two simple changes to the upgrade script. Please follow the
instructions below to configure the upgrade script for using a proxy server.
- Open the file upgrade.tcl with your favorite text editor.
- Locate the lines
#set proxyhost 192.168.231.100
#set proxyport 3128
near the top of the script (lines 36 and 37).
- Delete the leading comment character
- # from these two lines and replace the IP address
- 192.168.231.100 with the name or the IP address of the proxy server.
- Normally, you will not need to change the port number
- 3128 of the proxy server . However, if you are accessing a different port on the proxy server, you will need to supply a different port number.
- Save the script.
You may now start the upgrade script as described above.
The upgrade process
The upgrade utility performs the upgrade process in several steps. While performing these steps, it keeps you informed about its current
activities, asks for your permission to perform the next step in the upgrade process, and gives you the opportunity to abort the upgrade without performing the remaining steps in the upgrade process. The
following sections provide an outline of each of the steps in the upgrade process.
1. Checking for available upgrades
At the beginning of the upgrade process, the utility contacts the epc web server to gather information about the available upgrades and patches.
2. Determining the current patchlevel
The upgrade utility then compares the highest available upgrade version with the current patchlevel of the epcEdit installation. If no new
upgrades are available, the scripts exits after displaying an information messages.
3. Checking permissions
Next, the upgrade script checks if all files that need to be replaced can be overwritten and that all required directories can be created.
4. Downloading the required files
After asking for your permission to do so, the script downloads the required files and stores them in a temporary directory.
5. Creating backup copies
The upgrade utility then asks if you want to create backup copies of all files that will be replaced during the upgrade process. If you answer
"yes" to this question, backup copies of all affected files will be created. The upgrade utility will create a directory for the backup copies and display the name of the directory in an
information dialog.
6. Copying the files
The files from the temporary directory are copied to their final destinations. Backup copies of the original files are created in the backup
directory and the temporary files are removed.
7. Cleaning up
After installing all required files, the upgrade utility records the new patchlevel and exists after displaying a final information message.
|
