Installation guide

60 iPlanet Web Server, Enterprise Edition Installation and Migration Guide • May 2001
If you choose to use your old document root, the search collections you migrated work
automatically. If you choose to use a new document root instead of your old one, you may
need to recreate some of your collections before they will work.
Migrating Search Pattern Files
You have the option of migrating the search pattern files. You should only do this if you
have customized the default pattern files.
Migrating Applications
After migrating your server settings and data, you may also need to make changes to your
applications so that they run on iPlanet Web Server 6.0.
Migrating NSAPI Applications
Most NSAPI programs you used with iPlanet Web Server 4.x will work in iPlanet Web
Server 6.0 without being recompiled. Some undocumented data structures have been moved
out of
nsapi.h and are no longer public. Going forward, if your plugins use any of these
data structures, you should re-write them to use accessor functions. The data structures that
are now private are defined in
nsapi_pvt.h, which is shipped with the build for
informational purposes only.
Custom NSAPI plug-ins are not automatically copied to the new server directory. If you
have custom plug-ins, make sure you copy your plug-ins to the upgraded path as shown in
the magnus.conf of the new server.
For more information on these data structures and the new accessor functions, see the
NSAPI Programmer’s Guide to iPlanet Web Server 6.0.
Migrating Java Servlets
After you’ve migrated your server, Java servlets that ran in iPlanet Web Server 4.x should
run in 6.0 without being recompiled. The migration leaves 4.x servlets in their original
directory. The migrated servlets run in compatibility mode, which may make them a little
slower than other 6.0 servlets.
Also, if your 4.x servlet referenced any additional files, you need to add the path to these
files to your JVM classpath. To update the classpath, use the Configure JVM Attributes
page, which you can find in the Server Manager on the Servlets tab.
Although 4.x servlets and JavaServer Pages run properly without modification on iPlanet
Web Server 6.0, application developers should rewrite these as web applications to take
advantage of new features.