Installation guide

4. NETSCAPE/IPLANET PLUGIN (SPARC/SOLARIS)
ServletExec 4.1 Installation Guide 29
4.1 Upgrading from a Previous Version
You can upgrade to ServletExec 4.1 from all previous versions except versions 3.0C or
3.0E. If you have either of these versions installed, you will need to completely uninstall
that version and do a clean installation of ServletExec 4.1.
To upgrade to a new version of ServletExec/NSAPI and maintain your old configuration
settings
1. Stop your web server. If you’ve installed ServletExec/NSAPI for multiple
NES/iWS server instances, stop each one that is running.
2. Make backup copies of the
ServletExecData, Servlets, classes (if
you’ve added an additional one), and
webapps (versions 3.1 and above only)
directories for all NES/iWS server instances for which you’ve installed
ServletExec/NSAPI.
 For ServletExec/NSAPI 2.2 and earlier, the default locations are within:
/usr/local/netscape/suitespot/plugins/ServletExecNSAPI/https-
<server-name>
 For ServletExec/NSAPI 3.0 and 3.1, the default locations are within:
/usr/local/NewAtlanta/ServletExecNSAPI/https-<server-name>
3. Close all open applications.
4. Uninstall the old version of ServletExec/NSAPI by running the installer for that
version. Choose to Remove ServletExec Completely when prompted.
5. Run the ServletExec/NSAPI 4.1 installer. You will need to re-run the installer for
each NES/iWS web server instance for which you want to install
ServletExec/NSAPI 4.1, installing into the same location as the previous
installation.
Note
The default installation directory for versions 2.2 and earlier is different.
Important
For a successful upgrade, you must install everything into the same directory as the
previous version.
6. Copy the ServletExecData, Servlets, classes (if you’ve added an
additional one), and webapps (versions 3.1 and above only) directories to the
ServletExecNSAPI/https-<server-name>.
7. The obj.conf file for each upgraded NES/iWS server instance must have the
path to the ServletExecNSAPI.so shared library in the Init directive updated
to include the
/bin subdirectory. That is, in ServletExec/NSAPI versions 2.2 and
earlier, the Init directive appears (partially) as:
Init fn=”load-modules” shlib="<path>/ServletExecNSAPI.so"
In ServletExec/NSAPI 3.x and 4.x, the Init directive appears (partially) as:
Init fn=”load-modules” shlib="<path>/bin/ServletExecNSAPI.so"