Behavior:
After renaming the computer name where the DocuWare server modules are installed, the services won’t start.
**Note: Renaming a DocuWare system is not part of the standard support contract; therefore, if you want DocuWare Support to perform this task for you, it would be done as a Professional Services task for a fee.**
Solution:
The computer name is stored in the DocuWare server settings, which must be changed to adapt the settings to the changed name. In this article, you can find a detailed explanation on how to change the server name settings in the DocuWare system database and configuration files. For this demonstration, we assume that all server modules of DocuWare are installed on one machine. The DocuWare internal database (MySQL) is used for this example. If you use a different database, you have to change the identical settings, using your administration tools.
If you are unsure about the what the computer name is, right-click on My Computer and choose Properties then Computer Name. If a domain name is attached, please copy only the computer name without the domain.
Stop all DocuWare services, then open the Management Console (MySQL Query Browser) and choose database DWSystem, table DWServer. Change the field machine_name and the name in the fields: name, connection and settings.
The following MySQL script will change all these at once (if you are using Query Browser you will need to use New -> Script Tab):
MYSQL:
Set @NewMachineName = 'NewMachineName';
Set @OldMachineName = 'OldMachineName';
update DWServer set machine_name = @NewMachineName;
update DWServer set name = replace(name,@OldMachineName,(@NewMachineName collate utf8_general_ci));
update DWServer set settings = replace(settings,@OldMachineName,(@NewMachineName collate utf8_general_ci));
update DWServer set connection = replace(connection,@OldMachineName,(@NewMachineName collate utf8_general_ci));
For systems utilizing MSSQL database:
MSSQL:
declare @NewMachineName varchar(max) = 'NewMachineName';
declare @OldMachineName varchar(max) = 'OldMachineName';
update DWServer set machine_name = @NewMachineName;
update DWServer set settings = replace(convert(varchar(max),settings),@OldMachineName, @NewMachineName);
update DWServer set connection = replace(connection,@OldMachineName,@NewMachineName);
update DWServer set name = replace(name,@OldMachineName,@NewMachineName
***Note: Alter the 'NewMachineName' and 'OldMachineName' accordingly.***
Open the settings file of the Authentication Server, Workflow Server, and Notification Server (DWAuthenticationServer.exe.settings, DWWorkflowServer.exe.settings, DWNotificationServer.exe.settings). These files would be found in the program folders of the servers (e.g., C:\Program files(x86)\DocuWare\Authentication Server, C:\Program files(x86)\DocuWare\Workflow Server, C:\Program files(x86)\DocuWare\Notification Server). Change the computer name in the sections "ConnectionSettings" and "SwitchServerProviderChannels."
*Note: DocuWare version 7.4 & higher have done away with Notification Server. Changes will only need to be made to the Authentication and Workflow Servers.*
Please start the DocuWare services now. There may be errors during startup (just ignore them; this is not a problem at this time). Login to the DocuWare Administration tool and change the computer name at the following places:
DocuWare System > Database Connections > Authentication > Connection Parameters > Database Server Name > [Change]
DocuWare System > Database Connections > Workflow Engine> Connection Parameters > Database Server Name > [Change]
DocuWare System > Database Connections > Notification > Connection Parameters > Database Server Name > [Change]
DocuWare System > Web Connections > Machine, Internal Address, and HTTP root directory > URL > [Change]
Changes need to be made to the following settings files as well:
Please alter the Platform Web.config file, which would be located in C:\Program Files\DocuWare\Web\Platform:
The DocuWare.PlatformModel.settings file must also be altered, which is located in C:\ProgramData\DocuWare\ServerConfig:
Please restart all DocuWare services and try to login to DocuWare.
KBA applicable for On-premise Organizations ONLY.