Knowledge base

Fixing Xcb connection errors that may occur after replacing a System/i


This article explains how to diagnose and fix connection issues that may result after a System/i server is replaced with another similarly configured system.


When an IBM System/i is replaced with another system, the internal database name will often change.  Until the Xcb configuration files are updated, Xcb will be unable to connect to the new system.


The Xcb database connection information must be updated to reference the new database name:

  1. Open the Xcb.database.config file located in %ProgramFiles%\Xtheta\Xcb\WebApp\Config
  2. Look for the line that starts with <property name="connection.connection_string">. The line should look similar to this one.
    <property name="connection.connection_string">Database=S282C37;UserID=myuser;;Password=mypassword;DefaultCollection=XCBPROD;</property>
  3. Look for the portion of line that says Database=....; and replace the portion of the line between the equals sign and the semi-colon with your new database name (it's often the serial number of the server).
  4. Save the file and restart the Xcb services or reboot the server.

Additional information

Before changing any configuration files, it is wise to make a backup.  Xtheta cannot be responsible for any issues that may result from incorrect or incomplete changes to the configuration files on the web servers.


  • Intermediate - Not too bad but grab a cup of coffee first!


Applies to

General information

  • Last updated: 4/6/2015

Any feedback is appreciated