# Appendix: Sample Transforms.xml file

Below is a sample of the Transforms.xml file used in the Document Generation Services installation.

Note: The example below cites specific machine names using the `Machine.example.NET` nomenclature.

    <Transforms>
     <!-- DGS CI-->
     <Transform FileName="Installs\DocGenServicesInstall-64bit_JHTest.msi" Category="JHTestInstall">
     <Property Id="SECURITYTOKENCACHEDB" Value="Server=LABW6408HVM562.WKMNLAB.NET;database=AppSecurityTokenCache;Integrated Security=True;" />
     <Property Id="SHORTTERMSQLSERVERHOSTNAME" Value="Data Source=LABW6408HVM562.WKMNLAB.NET;Initial Catalog=docgen;Integrated Security=true;"/>
     <Property Id="STSHOSTNAME" Value="LABW6408HVM562.WKMNLAB.NET"/>
     <Property Id="CONTENTREPOSITORY" Value="\\LABW6408HVM562.WKMNLAB.NET\ExpereRepository\DeployedContent"/>
     <Property Id="BUILDREPOSITORYPATH" Value="\\LABW6408HVM562.WKMNLAB.NET\ExpereRepository\BuildContent"/>
     <Property Id="ERLCONTENTREPOSITORY" Value="\\LABW6408HVM562.WKMNLAB.NET\ExpereRepository\DeployedERLContent"/>
     <Property Id="LIBRARYZIP" Value="\\LABW6408HVM562.WKMNLAB.NET\ExpereRepository\Uploads"/>
     <Property Id="LIBRARYTODEPLOY" Value="\\LABW6408HVM562.WKMNLAB.NET\ExpereRepository\temp"/>
     <Property Id="APPLICATIONURL" Value="LABW6408HVM112.wkmnlab.net"/>
     <Property Id="RabbitMQNetworkName" Value="WKFS_DocGenServicesDGSCI"/>
     <Property Id="RUNASSERVICEACCT" Value="1" />
     <Property Id="ACCOUNTDOMAIN" Value="NA"/>
     <Property Id="DOMAINACCOUNT" Value="DGS-CI-SRVC"/>
     <Property Id="DOMAINACCOUNTPASSWORD" Value="Welcome@586!"/>
     <Property Id="RABBITMQHOST" Value="rabbitmq://LABW6408HVM112.WKMNLAB.NET"/>
     <Property Id="DOCVIEWERURL" Value="https://labw6408hvm371.wkmnlab.net/DocViewerInterfaceHtml_Adam/SessionSvc.svc"/>
     <Property Id="NEWRELICAPPNAME" Value="DGS_CI.DocGenServicesHost"/>
     <Property Id="GENERATESCHEMA" Value="true"/>
     <Property Id="USE_EXPERE_NET" Value="false" />
     <Property Id="EXPERE_ENDPOINT_ADDRESS" Value="http://LABW6408HVM112.WKMNLAB.NET:8080/Common/WSEndpoint" />
     <Property Id="WAS_HOST_BIND" Value="LABW6408HVM112.WKMNLAB.NET" />
     <Property Id="WAS_PORT_BIND" Value="8080" />
     <Property Id="OPPSAHOSTNAME" Value="LABW6408HVM112.WKMNLAB.NET" />
     <Property Id="ENABLE_ORGANIZATION_CACHE" Value="true"/>
     </Transform>
    </Transforms>

## Additional considerations

Consider additional guidelines when using the following elements:

- RUNASSERVICEACCT – Set this value to "0" to install the services as NETWORK SERVICE. Set this value to "1" to use the account information in the properties below;
- ACCOUNTDOMAIN – The domain of the service account the services should be running as;
- DOMAINACCOUNT – The username name of the service account;
- DOMAINACCOUNTPASSWORD – The password of the service account;
- EXPERE_ENDPOINT_ADDRESS – This is the full URL for Expere’s web service, they will need to change the hostname to the name of the server that they have Expere installed on and the port if they changed that from the default when they installed it.
- WAS_HOST_BIND – Should also be set to the fully qualified hostname of the server where Expere is installed
- WAS_PORT_BIND – Used to build a URL in combination with WAS_HOST_BIND. This should be 8080 unless they changed the port when they installed Expere.
- OPPSAHOSTNAME – Needs to be set to the fully qualified hostname for the server that OPPSA is installed on. This property is used by DGS’ Tool Suite to retrieve any data set up in OPPSA that should be applied when the documents are generated (Org, policy, product data, etc).
- ENABLE_ORGANIZATION_CACHE - By default, this property is set to "true," which caches the OPPSA organization database. When Document Generation Services is installed with Expere, set this value to "false."

Note: The DOMAINACCOUNT and DOMAINACCOUNTPASSWORD values identified in the example above should be replaced with your unique values.