Renaming Aspen Unified server post-configuration

Download as pdf : 
Products:  
Last Updated: 16-Apr-2021
Versions: 
Article ID: 000098352
Primary Subject: 
Problem Statement
After changing the original name of the Aspen Unified server some post-configuration steps must be done. These changes are required to enable Aspen Unified to work correctly after renaming the server.

For this example, the machine is in WORKGROUP and not in any domain.

Solution
After renaming server of name, please follow below steps to enable Aspen Unified.
  1. Open a file explorer and go to the next path C:\ProgramData\AspenTech\AspenUnified, then edit the AspenUnified.config file with a text editor program such as Notepad or Notepad++ to update the new server name on the value of key MasterDatabaseServer. For this example, the server has been renamed to GDOT.
  1. Delete MasterConfigCache.json and MeshSettingsCache.json under C:\ProgramData\AspenTech\AspenUnified, these files will be re-created after restarting the Aspen Unified Agent Supervisor Service.
  2. Open Microsoft SQL Server Management Studio and be sure to connect to the corresponding database of the renamed server.
  1. Open the Security folder and then Logins, make sure that NT AUTHORITY\Authenticated Users and NT AUTHORITY\NETWORK SERVICE logins exist.
  1. Make sure that both logins have the sysadmin role box checked right-clicking on the user and click on Properties and then going to Server Roles. If the box is not checked, check it.
  1. Open Databases and locate AUMaster to update values in master database.
  1. Open the database and open the Tables folder. To edit a table, right-click on it and select the Edit Top 200 Rows option. Make sure not to put extra spaces at the end.
  1. Edit the aumaster.GlobalRoleMembers with the AccountId of the new domain.
  1. Edit the aumaster.GlobalSettings with the SettingId of servers and the Value with the direction.
  1. Edit the aumaster.RegisteredDatabases to update the DatabaseServer and the ConnectionString columns of the new domain.
 
  1. On the Services window, stop the Aspen Unified Agent Supervisor Service and IIS Admin Service. Then, start the IIS Admin Service and the Aspen Unified Agent Supervisor Service in that order.

Keywords
Aspen Unified, GDOT, renaming server