Instructions to Change the Node Host Name

In the design of the automatic configuration scripts, it has been assumed that computer name can be used as identity information, so there are quite complex steps that needs to be done if the computer name changes.

❗️
It is highly recommended to retain the same name and avoid renaming the computer once ABB Ability™ History is installed.

Steps to be followed

📘
All commands should be executed with elevated privileges.

👍
In this instruction, the old name of the computer is assumed to be "oldname" and the new name is assumed to be "newname".

🚧
Stop RTDB before changing the name, and set RTDB main service to 'Disabled' from 'Automatic' in windows service manager.

In the computer with the changed name, edit the setup answers file with following command on an Admin command prompt.
```
notepad "%app_root%\setup\setup_answers.bat"
```
change the row SET "ANS_P_DSN=oldname-RTDB" to SET "ANS_P_DSN=newname-RTDB" and save the file.
If the node where the name is changed is a Main node of a Hierarchical system then following step needs to be done on all the data collector nodes reporting to this Main node, else this step can be skipped.
```
 notepad "%app_root%\setup\setup_answers.bat"
```
change the row SET "ANS_P_MAINSERVERNAME=oldname" to SET "ANS_P_MAINSERVERNAME=newname"and save the file.
In the computer with the changed name, remove the existing APP_DSN which has the old name in it
```
"%app_root%\config\application\INSTALL_ODBC_DSNS.BAT" /remove
```
This command removes all the ODBC DSNs created with oldname during installation.
Perform the following step to Pass the new name to APP_DSN
```
notepad "%app_root%\config\application\app_defenvironment.bat"
```
change the rows that define the different data source names to use the new name. (starting from RTDB 5.0 there are four different environment names) save & execute the file.
```
 "%app_root%\config\application\app_defenvironment.bat"
```
Close all command window.
Launch a new admin command window and execute below command to create the DSNs with new computer name.
```
%app_root%\config\application\INSTALL_ODBC_DSNS.BAT"
```

In MAIN and in all DCN computers, rename the name and computername in DatabaseNodes table with command

praotstx "%app_dsn%" -sql "update databasenodes set computername='newname', name='newname' where computername='oldname'"

Rename the setup answers file
```
ren "%userprofile%\abb oy\Parameters\Setup_Answers_oldname-RTDB.bat" "Setup_Answers_newname-RTDB.bat"
```
If the computer is Main node, rename also the DCN -specific parameter files in the userprofile directory of the admin user (the user under which RTDB-Scheduler runs)
```
ren app_query_configuration_oldname-RTDB_getparameter_DC_DCN1_DBADMINPASSWORD.bat app_query_configuration_newname-RTDB_getparameter_DC_DCN1_DBADMINPASSWORD.bat
//where,
//  DCN1 is the name of the DCN node.
//  
//  Do this for all the DCN entries
```
E.g

The command for above entry in the screen shot is as follows,

ren app_query_configurationHAAUTO1-RTDB_getparameter_DC_IN-V-CPMT029_DBADMINPASSWORD.bat app_query_configuration_HAAUTO2-RTDB_getparameter_DC_IN-V-CPMT029_DBADMINPASSWORD.bat

Here, Old Name is HAAUTO1 and New Name is HAAUTO2, This needs to be performed for all the entries
Reinstall services on the node where the name is changed, so that the new URI name is written to Vtrin Netserver config etc.
```
"%app_root%\config\application\APP_Install_Services" /remove all
"%app_root%\config\application\APP_Install_Services" /install all
```
🚧
Set the startup type of RTDB Main service back to 'Automatic' from 'disabled'

Re-create RTDB control panel

"%app_root%\Config\Application\APP_CreateControlPanel.bat"

Update the certificate. If self signed certificates are used, follow the steps in Instructions for re-creating the self signed certificate
Start the RTDB service from RTDB Control Panel

It is highly recommended to retain the same name and avoid renaming the computer once ABB Ability™ History is installed.

Steps to be followed

All commands should be executed with elevated privileges.

In this instruction, the old name of the computer is assumed to be "oldname" and the new name is assumed to be "newname".

Stop RTDB before changing the name, and set RTDB main service to 'Disabled' from 'Automatic' in windows service manager.

Set the startup type of RTDB Main service back to 'Automatic' from 'disabled'