Log in to server where the IP address has changed.
Open command prompt (Start menu=> cmd)

Enter ipconfig command in the command prompt and press Enter.

Perform this step on all the CML nodes in cluster:

Open the Services window (e.g. Start => Run => services.msc) and stop all YSoft SafeQ services (stop whole CML cluster!):

• YSoft SafeQ CML

• YSoft SafeQ CML DBS
  

• YSoft SafeQ Terminal Server
  

• YSoft SafeQ LDAP Replicator Service

• YSoft SafeQ Web Interface

Perform following step on the node where the IP address has changed:

2a. Change the IP address

Set the new IP address in the operating system

2b. Replace the IP address in startup.conf

Edit <SAFEQ_DIR>\conf\startup.conf and set your new IP address in the parameter:

• smartq-server-ip = %NEW_IP_ADDRESS%

2c. Replace the IP address in TerminalServer.exe.config

Edit <SAFEQ_DIR>\terminalserver\TerminalServer.exe.config and set your new IP address in the parameter:

• networkAddress = %NEW_IP_ADDRESS%

2d. Replace the IP address in server.xml

Edit <SAFEQ_DIR>\tomcat\conf\server.xml and set your new IP address in the parameter:

• address="%NEW_IP_ADDRESS%"

• This parameter is present multiple times.

Perform these steps on all the CML nodes in cluster:

The update of IP address can be also performed using the SQL query:

• SQL query : update cluster_server set ip_address = '<newIP>' where ip_address = '<oldIP>'

• example of usage: update cluster_server set ip_address = '10.0.11.80' where ip_address = '10.0.11.19' 

3a. Connect to the SQDB5 database

The connection shall be made using the management application equal to the type of SQL server that was selected during the installation of YSoft SafeQ (pgAdmin III for PostgreSQL or MS SQL server management studio for MS SQL server). We are describing mainly the procedure for pgAdmin III application, steps for MS SQL server management studio are very similar.

• Launch the application by going to Start menu => All Programs => PostgreSQL 9.2 (or by going to Start menu => Y Soft Corporation in case of embedded postgreSQL installation ).

• Double-click SafeQ PostgreSQL server connection (in the tree under Servers).

• Enter the password you have selected in CML installation (for postgres user).

  

3b. Edit table cluster_server

• In pgAdmin III go to SQDB5 => Schemas => public => Tables => right-click table cluster_server => View Data => View All Rows

3c. Edit ip_address field and enter a new IP address for the server where the address has changed

In our example the IP address of 2^nd node was changed from 10.0.11.20 to 10.0.11.80.

• Go to File -> Save once the IP address has been replaced

3d. Verify the new IP address in table smartq_servers

• Verify that the new IP address has been automatically changed also in the table smartq_servers in column ip. If the change has not been done automatically, update IP address also in this table.

3e.  Repeat above mentioned action on all nodes of YSoft SafeQ CML cluster (Except the one with the new IP address)!

Perform this step on all the CML nodes in cluster:

Open the Services window (e.g. Start => Run => services.msc) and start all YSoft SafeQ services:

• YSoft SafeQ CML

• YSoft SafeQ CML DBS
  

• YSoft SafeQ Terminal Server
  

• YSoft SafeQ LDAP Replicator Service

• YSoft SafeQ Web Interface

Verify that synchronization in the cluster is functional:

• Log in to the web interface (YSoft SafeQ Web interface => System => System information)

  • Verify that new IP address is visible in Cluster server info table

  • Verify that all servers are showing status ONLINE (the node you are connected to may show status LOCAL)

  • Verify that synchronization between the nodes in the cluster is functional. See table DBsync database & system pools (non-local servers only). Values in column Database pool priority must not be growing constantly. They shall be changing and they shall be often around 0.

Be sure that orsCacheRecovery attribute is enabled.

Open YSoft SafeQ Web Interface => System => System settings => In the Expert View set orsCacheRecovery to enabled

If you omit this step, all jobs stored on the ORS will be lost at the end of procedure.

Open the Services window (e.g. Start => Run => services.msc) and stop all ORS services:

• YSoft SafeQ Terminal Server
  

• YSoft SafeQ ORS

• YSoft SafeQ ORS Web Service

  

Edit file <SAFEQ_ORS_DIR>\conf\modules\ors.conf and set your new IP address of the CML server in parameter:

• serverIP%NODE_ID%= %NEW_CML_IP_ADDRESS%

Delete ORS cache

Delete folder <SAFEQORS_DIR>\server\cache

Open the Services window (e.g. Start => Run => services.msc) and start all ORS services:

• YSoft SafeQ Terminal Server
  

• YSoft SafeQ ORS

• YSoft SafeQ ORS Web Service

If YSoft Payment System is on the same server as CML:

• In SafeQ Web Interface open the System tab and go to the System Settings.

• In the Ysoft Payment System category, find the YSoft Payment System API URL option (internal name is paymentSystemApiUrl).

• Verify the correct IP for the YPS installation is entered.

Edit configuration of the YSoft Payment System in <YSoft Payment System>\payment-conf\environment-configuration.properties and set your new IP address of CML in the parameter:

• safeq.authentication.address =

Restart the Ysoft Payment System Services.

Edit configuration in <YSoft Mobile Print Server>\Service\conf\mps.config and set your new IP address of CML

Change the following parameter in both sections <printServers> and <folderSources>:

• hostIP=

Restart the Ysoft Payment System Services.

Reconfigure all print drivers (or YSoft SafeQ clients) to connect to the new IP address

All print drivers that were connected to the CML with old IP address must be re-connected to the new IP address.

Reconfigure HW terminals:

If you are using hardware terminals, make sure that they are pointing to the new IP address. 

Reinstall all embedded Terminals:

Reinstall all embedded terminals that shall be connecting to the server with the new IP address.

Reconfigure CRS server (IP address of CML has to be changed):

If you are using a CRS server, the new IP address of the CML server has to be updated also on the CRS side. The modification has to be done in the following places:

1. database yBoxDB

   • table smartq_servers, column ip

2. database yBoxDBCDC   

   • table smartq_servers, column ip

3. database yBoxDBREP

   • no changes are required