DCE Installation, Configuration, and Management Guide

Migration Guide
HP NonStop DCE Installation, Configuration, and Management Guide—429552-005
A-3
Migrating From a TNS Version to a TNS/R Version
already exists, you are prompted to update that file with the new library. If you reply
with y, the new file replaces the old one.
Migrating From a TNS Version to a TNS/R
Version
The G06 product version of NonStop DCE 1.1 provides TNS/R native virtual hosts that
can interoperate with D48 product version TNS virtual hosts. To upgrade from a D31 or
earlier product version of NonStop DCE, you must first upgrade to the D48 product
version.
To create a new TNS/R virtual host, simply install the G06 product version of
NonStop DCE.
To upgrade an existing D48 product version TNS virtual host to a faster TNS/R virtual
hosts:
1. Copy the existing /usr/lib/libdce_scs.a archive file for the TNS ADE to a
backup directory location, in case it is needed later for TNS application
development. That file is overwritten during installation.
2. Install the G06 product version of NonStop DCE, preserving the Guardian TNS file
linked to /usr/lib/libdce.so or /usr/lib/libdcehostname.so if needed
for TNS application migration or fallback.
3. Recompile all TNS applications and relink them as TNS/R applications, as
described in the DCE Application Programming Guide.
When the G06 product version is installed, virtual hosts are updated on a case-by-case
basis. TNS virtual hosts can be retained unchanged, so you are not required to migrate
all TNS applications at the same time to the TNS/R environment.
It is not possible to fall back to the D31 product version from the G06 product version.
To fall back to the TNS D48 product version from the G06 product version, the D48
product version can be completely reinstalled and reconfigured, or the TNS ADE can
be reinstalled by itself.
TNS applications that are migrated to use the TNS/R ADE require changes in the
methods used to compile and link them. TNS/R applications cannot have more than
one private user library; see the DCE Application Programming Guide for more
information.