Documentation Center

Configuring Contenta Client

Complete the configuration tasks before you execute the newly installed Contenta Explorer software.

About this task

After you install SDL Contenta, you must complete the installation by either modifying your site’s existing files, or moving or renaming the upgrade-delivered files to the appropriate folders.

Procedure

  1. Compare Contenta_home\encaps\di\custom\utils.pm to the upgrade-delivered file Contenta_home\encaps\di\utils.pm.
  2. Edit the Contenta_home\encaps\di\custom\utils.pm file, if necessary, to include changes delivered by the upgrade.
  3. Delete or rename Contenta_home\encaps\di\utils.pm.
  4. Compare the Contenta_home\encaps\di\custom\CustomCallbacks.pm file to the upgrade-delivered file Contenta_home\encaps\di\CustomCallbacks.pm.
  5. Edit the Contenta_home\encaps\di\custom\CustomCallbacks.pm file if necessary to include changes delivered by the upgrade.
  6. Delete or rename Contenta_home\encaps\di\CustomCallbacks.pm.
  7. If upgrading from pre-Contenta 5.3 and you will be using the EnableDefaultUserName AppData setting to prevent the default username from being displayed in the Contenta Explorer (and Contenta Web) login screen. Remove two keys from the Windows registry:

    HKEY_CURRENT_USER/Software/XyEnterprise/Content@/Settings/Startup/Username

    HKEY_LOCAL_MACHINE/Software/XyEnterprise/Content@/Settings/Startup/Username

    For information on how to implement this optional security feature, see the Application preferences in AppData topic in the Installing or Upgrading SDL Contenta Web for Windows and UNIX Systems section of this documentation.

  8. If your site uses Microsoft SQL Server, set the MSSQL_HOME system environment variable on the client machine to the full path to the MS SQL Server installation, such as C:\Program Files (x86)\Microsoft SQL Server\Client SDK\ODBC4.
  9. Core SDL Contenta only (sites not using SDL Contenta S1000D).
    1. Rename the Contenta_home\encaps\di\digui.cfg file to save any customization or changes made before generating the file in the next step.
    2. In the Contenta Explorer application, execute Dynamic Import to generate a new digui.cfg file.
    3. Compare the newly generated Contenta_home\encaps\di\digui.cfg file to your site’s previous (custom) digui.cfg file—this is the one that you renamed (above).

      If necessary, edit your site’s custom file to include any updates included in the delivered Contenta_home\encaps\di\digui.cfg file and rename it to digui.cfg.

    4. Verify that paths and applications for viewxml and viewsgml tools are correct for your site and configuration.
  10. After you install and configure Contenta Client, see the SDL Contenta Editor tools user section of the Contenta documentation for additional information about configuring and using the editor software.