How to reconfigure X3 solution after changing the computer name/domain
Changing the computer name for your X3 server(s), as in when you migrate your current Sage ERP X3 solution onto a new server(s), will lead to the X3 solution hosted on the server no longer working. If you are a Sage ERP X3 customer experiencing this, you will need reconfigure the X3 solution after changing the computer name/domain.
Searching on the Sage Knowledge base database, I was not able to find any documentation that details this migration process. I did some investigation and experimenting on a demo server and was able to re-configure the X3 solution for the new server. The following are detailed steps required to re-configure the X3 solution after changing the server name.
1. Unpublish any Print folders and Web folders
Before changing the server name, on the source server, launch the X3 console and choose the Web Servers from the drawer. Select the Publications button on the menu bar. Uncheck all the folders to unpublish them. Do the same procedure to the Printer Servers tab. Select the Print Servers from the drawer, select Publications button, and uncheck all publications to all the folders.
Make sure all the folder have been unpublished before changing the server name.
2. Stop all X3 Services
Launch Services management console from the Windows Control Panel. Manually stop all X3 services. Leave Services management console opened. We will need this to restart the services later.
3. Update the X3 Solution Configuration Files
Navigate to your X3 solution directory. Make a backup of the solution.xml file. Open the solution.xml with a text editor program, such as Notepad, TextPad or Notepad++ etc. Use the Search and Replace function to find all instances of the old server name and replace it with the new server name. Save changes after all instances have been replaced.
4. Update the X3 Console configuration file
All the X3 Console configuration files are stored under the user folder directory, C:\Users\(user-name)\AppData\Roaming\Sage\Console.
Navigate to the X3 Console configuration directory. Make a backup of the Console directory. Open the all the console configuration xml file with a text editor program, such as Notepad, TextPad or Notepad++ etc. Use the Search and Replace function to find all instances of the old server name and replace it with the new server name. Save changes after all instances have been replaced.
5. Restart X3 Services
Restart the X3 services you disabled in Step 1.
6. Delete Old X3 solution
Start up X3 Management Console. Click on the Solutions drawer, select the old solution and hit the delete icon to remove the old solution.
7. Re-import Solution using new server name
After the old solution has been deleted, click on the Import a Solution button on the menu bar. Select the new server name from the drop-down menu.
Then follow the same procedure as described in the installation instructions to complete the X3 solution configuration. After you save the solution configuration, X3 console will validate the configuration settings. Update the configuration settings as suggested by the X3 console. Save the changes.
Congratulations! You have successfully updated your X3 solution for the new server.