Migrating from a Solaris or AIX Contenta Server

To migrate from a Contenta 4.2 or earlier Server on Solaris or AIX to Linux, migrate all of your customized adapter files, custom tools and custom triggers.

Procedure

  1. Use the delivered Contenta installation and upgrade documents to install Contenta 5.7 on your systems, including the Linux 5.7 Contenta Server.
  2. Copy and save (back up) the delivered encaps/ subdirectory of your Contenta home directory installed on the new 5.7 server.
  3. In the bin\ subdirectory of your Contenta home directory, examine the file pdm.cshrc for paths, system identifiers and/or any other customizations. You can find customizations more easily by comparing pdm.cshrc to the corresponding file on the Linux Server, pdm.cshrc. Copy any customizations you find from pdm.cshrc to pdm.cshrc.
  4. If you connect to an Oracle database, in the bin\ subdirectory of your Contenta home directory, examine the file pdm.cshrc.ora for paths, system identifiers and/or any other customizations. You can find customizations more easily by comparing pdm.cshrc.ora to the corresponding file on the Linux Server, pdm.cshrc.ora. Copy any customizations you find from pdm.cshrc.ora to pdm.cshrc.ora.
  5. If your Contenta Server contains custom tools and triggers (that is, files) under the encaps/ subdirectory of your Contenta home directory, migrate those files also. To find such files, check for files in your encaps/ directory that are not present in the corresponding Linux Server location.
  6. If your Contenta Server contains customized adapter files that need to be migrated to Linux, migrate them. To find and identify these files, do the following:
    1. Look for customized filenames. Typically, the names of such files will include your company's initials, name or identifier. For example, if your company is called Acme, you would see files such as CustomGetDocCatAcme.pm. These customized files are usually in the same directory with the delivered files, in Contenta_home/encaps/adapters/custom, but may be isolated in a separate directory—for example /work/apps/adaptersAcme/custom. The path can be identified and located in the paths assigned to the environment variable PERL5LIB in/pdm/bin/pdm.cshrc. Specifically, you are looking for customized versions of one or more of the following files:
      • CustomGetDocCat.pm
      • CustomGetDocCatClassic.pm
      • CustomGetDocCatTweak.pm
      • CustomGetDocCatView.pm
      • CustomGetDocCatViewClassic.pm
      • CustomGetDocDefClassic.pm
      • CustomGetDocDefault.pm
      • CustomGetDocFetch.pm
      • CustomGetDocFetchDefault.pm
    2. Check for such customized files in the encaps/adapters/custom subdirectory of your Contenta home directory. Or, failing that, in a separate directory, for example, /work/apps/adaptersAcme/custom. You can identify and located the path in the paths assigned to the PERL5LIB environment variable, which is located in /pdm/bin/pdm.cshrc.