Steps to Update Tungsten TotalAgility Hostname
This knowledge-base article explains the various steps involved in the event you need to update the host name of a Tungsten TotalAgility Web/App/Database Server.
NOTE: The procedure explained here should be used with extreme caution as these changes are irreversible and not supported by Tungsten Automation, formerly Kofax Technical Support.
Pre-Requisites (before changing the host name)
- Take VM Snapshot/Server Backup
- If KTA Users are created with local accounts for single-sign on, update the KTA User IDs to use the new host name
Configuration Steps (after changing the host name)
- If the KTA services are running with a local Administrator account, update services to run with the updated account.
- If SQL Server is installed on the same server (usually in test VMs or Development environments), grant sysadmin/db_owner rights to SQL Server for the new Administrator account.
- Update following files with the new hostname
- C:\Program Files\Tungsten\TotalAgility\Agility.Server.Web\web.config
- C:\Program Files\Tungsten\TotalAgility\Agility.Server.Web\bin\Agility.Installation.Server.Upgrade.exe.config
- C:\Program Files\Tungsten\TotalAgility\Agility.Server.Web\bin\Agility.Server.ExportConnector.exe.config
- C:\Program Files\Tungsten\TotalAgility\Agility.Server.Web\bin\Agility.Server.StreamingService.exe.config
- C:\Program Files\Tungsten\TotalAgility\Agility.Server.Web\bin\RegAscSc.exe.config
- C:\Program Files\Tungsten\TotalAgility\CoreWorkerService\Agility.Server.Core.Executor.exe.config
- C:\Program Files\Tungsten\TotalAgility\CoreWorkerService\Agility.Server.Core.ExportService.exe.config
- C:\Program Files\Tungsten\TotalAgility\CoreWorkerService\Agility.Server.Core.WorkerService.exe.config
- C:\Program Files\Tungsten\TotalAgility\CoreWorkerService\Agility.Server.StreamingService.exe.config
- C:\Program Files\Tungsten\TotalAgility\Transformation Server\Tungsten.CEBPM.CPUServer.ServiceHost.exe.config
- C:\Program Files (x86)\Tungsten\TotalAgility Repository Browser\Tungsten.TotalAgility.RepositoryBrowser.exe.config
- Update license server (if the current machine is the license server)
- Login to Designer and update the license server name to use the new host name
- Update SQL Server reference in TotalAgility database (if the database server host name was changed)
- Execute the below query on TotalAgility database after updating the: