Document Generation Services Core: configuring Transforms.xml and creating/installing the component

This procedure explains the process for installing the Document Generation Services (DGS) Core component.

Before installing, verify the following:

  • Document Generation Services has been previously installed.
  • Version 2.1.5 or greater of .NET Core Runtime and .NET Windows Hosting has been installed (recommended: Version 3.1.11 of .NET Core Runtime and .NET Windows Hosting).
  • The user should be in administration on the server where DGS components will be installed.
Note: DGS Core and DGS Core DocViewer should be installed on the same server as Document Generation Services.
  1. On one of DGS servers, open Powershell and navigate to ReleaseFiles\DocGenServicesCore\DBInstallerScripts\bin folder. This process populates tables in the DGS database.
  2. From a command line, run the following command: DocGenServicesCore.DBInstall.exe and -server {server} -database DocGen.
  3. From ReleaseFiles\DocGenServices\DGSCore\InstallTransformKit folder, access the Transforms.xml file, change all server names to the desired server name or URL. See Appendix: Documentation Generation Services Core Component Sample Transforms.xml file for more information.
  4. Run run.bat to create the Document Generation Services Core installation file (for example: DGSCoreInstaller.msi; this name matches the FileName property in the Transforms.xml file) in the Installs folder.
  5. Uninstall the current version of DocGenServices Core using Control Panel > Add or Remove Programs.
  6. Run the .msi installation file.
  7. Click through the checkboxes:
  8. Accept all defaults and click Install.
  9. Check the event logs to troubleshoot any database errors. See Appendix: Using Log Files.
    Note: You may receive a message stating that an issue exists with the Windows Installer package. Click OK and note that your installation was successful.