Upgrading Document Generation Services

This section explains how to upgrade Document Generation Services (DGS).

Before you begin

Note: If you are either performing an initial installation or uninstalling/reinstalling DGS, this section does not apply to you.
  • If changing or moving the rabbitmq.config file, you must remove and install the service again. For best results, use the RABBITMQ_BASE environment variable on all servers.
  • To remove and install the service, run the following from the sbin folder:
    • rabbitmq-service.bat remove
    • rabbitmq-service.bat install
Note: Confirm that you can visit the RabbitMQManagement web site; if not, you may need to reinstall the RabbitMQ Management tool. See Installing RabbitMQ manually for more information.
  1. Manually uninstall the existing version of DGS.
    Note: You may need to physically remove the DocGenServices installation folder, as any files in the folder could interfere with subsequent installation.
    • Uninstall the existing version of DGS before running the new installer. Note that uninstalling DGS does not remove IIS or Application Pools; consider manually removing them before installing DGS.
    • Consider cleaning up log files/older program files folder before installing DGS here:
      • C:\ProgramData\WKFS\DGS
      • C:\Program Files\WKFS\DocGenServices
  2. Refer to Creating and installing the Document Generation Services components.
    Note: Consider the following:
    • You should be able to reuse your previous transform file. You do need to add a new DGS.STSv3SigningCertThumbprint Property that has the same value as the existing STSv3SigningCertThumbprint Property 
      <Property Id="DGS.STSv3SigningCertThumbprint" Value="2779B33709C859B45EEDDB3342DD30B9F40E82FE" />
    • You should not have to perform steps #2 and 3 as they should have been completed during the initial installation.
Proceed to either the Management or Tool Suite environments to verify the installation was successful.