ORS - How to change the IP address of ORS server

This document describes how to change the IP address of one ORS server.

Verification of the IP address

This section describes the way how to find the IP address of current server.

1

Log in to server where the IP address has changed.
Open command prompt (e.g. Start => Run => services.msc)

 

2

Enter ipconfig command in the command prompt and press Enter.images/download/attachments/21955757/020.PNG

 

Configuring ORS to use the new IP address

This chapter describes steps for ORS IP address change

1

Verify the orsCacheRecovery attribute is enabled in the CML settings.

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

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/lightbulb_on.svg If you omit this step, all jobs stored on the ORS will be lost at the end of procedure.images/download/attachments/21955744/05.PNG

 

2

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

  • YSoft SafeQ Terminal Server

  • YSoft SafeQ ORS

  • YSoft SafeQ ORS Web Service

    images/download/attachments/21955743/orsServices.png

 

3

Change IP address of the ORS server in the operating system.

 

4

Edit <SafeQORS>\conf\modules\ors.conf file and enter the new IP address in parameter smartQ-server-ip:

smartQ-server-ip = %NEW_IP_ADDRESS%

 

5

Replace the IP address in TerminalServer.exe.config

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

networkAddress = %NEW_IP_ADDRESS%

6

Open web interface of YSoft SafeQ CML server (use the first node in case of CML cluster) and go to Devices => Printers.

7

 Edit ORS where the IP address has changed

images/download/attachments/21955743/01.PNG

8

Replace the Spooler IP address by the new one

 

images/download/attachments/21955743/02.PNG

 

9

Delete ORS cache by deleting folder <SafeQORS>\server\cache.

 

10

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

  • YSoft SafeQ Terminal Server

  • YSoft SafeQ ORS

  • YSoft SafeQ ORS Web Service

11

Verify the correct ORS functionality according to the article YSoft SafeQ ORS Health Check.

 

Other required reconfiguration

This section describes what additional steps must be performed for a proper functionality of the YSoft SafeQ once the IP address of ORS server has been changed.

1

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

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

 

2

Reconfigure HW terminals:

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

 

3

Reinstall all embedded Terminals:

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