Migrating from a Solaris Contenta Web Server

To migrate from a Contenta 4.2 or earlier Web server on Solaris to Linux, migrate all of your customized Dynamic Import files, customized Web files, user interface customizations, registry entries, custom tools, custom triggers and any other customizations.

Procedure

  1. Use the delivered Contenta installation and upgrade documents to install Contenta 5.12 on your systems, including the Linux 5.12 Contenta Web Server.
  2. Copy and save (back up) the delivered encaps/ subdirectory of your Contenta home directory installed on the new 5.12 server.
  3. Copy customized Dynamic Import files, located in the encaps\di\ subdirectory of your Contenta home directory, from the current Contenta Web Server to the new Contenta Web Server:
    • custom\*
    • MapFiles\*.map
    • MapFiles\*.dist
    • entities\omnilib
    • digui.cfg
    • PCMObjects
  4. Check for directory paths in the following files, located in the encaps\di\ subdirectory of your Contenta home directory, and modify them for Linux:
    • MapFiles\*.map
    • MapFiles\*.dim
    • entities\omnilib
    • digui.cfg
    • entities\*.ent
  5. Compare customized Web files to files with the same name delivered in this software released, and incorporate any changes you find in your customized files. Then copy the customized files from the web\ subdirectory of the Contenta home directory of your current Contenta Web Server to the corresponding location in your new Contenta Web Server:
    • cw\custom\*
    • cw_common\custom\*
    • tools\cw_ci\custom\*
    • tools\cw_co\custom\*
    • tools\cw_di\custom\*
    • tools\cw_xml_ci\custom\*
    • tools\cw_xml_co\custom\*
  6. In the bin\ subdirectory of the Contenta home directory, check the file cw.cshrc for paths, system identifier and/or any other customizations beyond what is required as part of the installation. Modify the corresponding cw.cshrc file on the Linux Web Server if need be.
  7. Copy any customized Contenta Web interface files, as well as any customized cascade style sheet files, to the new Linux Contenta Web Server. Refer to the Contenta Web Programmers Guide for information about the files that may have been customized.
  8. On your Contenta client workstations, check the registry for keys called webserver or webport in the following location, and change them to indicate the new server name and port number: My Computer > HKEY_LOCAL_MACHINE > SOFTWARE > XyEnterprise > Content@ > Settings > Web.
  9. 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.
  10. From the web\custom subdirectory of your Contenta home directory on your Contenta Server or Contenta Web Server, copy any custom files to your new Contenta Web Server.
  11. 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 may be 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. Specifically, you are looking for customized versions of one or more of the following files:
      • CustomBindDefault.pm
      • CustomBindEpicCat.pm
      • CustomBindEpicClassic.pm
      • CustomBindFrameCat.pm
      • CustomBindXmetalCat.pm
      • CustomBustDefault.pm
      • CustomBustEpicCat.pm
      • CustomBustEpicClassic.pm
      • CustomBustFrameCat.pm
      • CustomBustXmetalCat.pm
      • CustomGetDocCat.pm
      • CustomGetDocCatClassic.pm
      • CustomGetDocCatDefault.pm
      • CustomGetDocCatTweak.pm
      • CustomGetDocCatView.pm
      • CustomGetDocCatViewClassic.pm
      • CustomGetDocDefClassic.pm
      • CustomGetDocDefault.pm
      • CustomGetDocEpic.pm
      • CustomGetDocEpicCat.pm
      • CustomGetDocEpicClassic.pm
      • CustomGetDocFetch.pm
      • CustomGetDocFetchDefault.pm
      • CustomGetDocFrameCat.pm
      • CustomGetDocXMetaL.pm
      • CustomGetDocXmetalCat.pm
      • CustomGetFrameBook.pm
      • CustomPutDocCatClassic.pm
      • CustomPutDocCatDefault.pm
      • CustomPutDocDefClassic.pm
      • CustomPutDocDefault.pm
    2. Check for such customized files in the encaps/adapters/custom subdirectory of your Contenta home directory.