Page 1
DoorsNXT Remote Port Change
Reference Document
The DoorsNXT Server and Database use TCP Ports to communicate. It is possible that another application may be using
the same ports which will prevent the DoorsNXT Server from functioning properly. The following instructions explain
how how to change the TCP Ports used by Doors NXT for proper communication.
Section 1 - DoorsNXT Server and Client On The Same PC
Section 2 - DoorsNXT Server and Client On Different PCs
Section 3 - Contact Keri Systems
1.0 DoorsNXT Server and Client On The Same PC
1.1 Stop the DoorsNXTSvr and Firebird Server services
1. To stop the DoorsNXTSvr and Firebird Server services, click on Windows Start and select Control Panel.
2. Double-click on Administrative Tools.
3. Double-click on Services.
4. Locate and click on Firebird Server so that it is highlighted.
Figure 1: Services Window
5. Click on “Stop the service.” A window appears to confirm that the DoorsNXTSvr is to be stopped as well. Click on
the “Yes” button.
Page 1 of 10 P/N: 01509-001 Rev. A
Page 2
DoorsNXT Remote Port Change
Reference Document
1.2 Modify System Services
1. Using Windows Explorer, locate the Windows\system32\drivers\etc folder.
2. Right click on “services” and select open.
Figure 2: Windows Explorer Open Services File
3. A window appears asking what program to use to open the file. Choose the “Select the program from a list” option
and click on OK.
4. From the list select Notepad. Remove the check from the option to “Always use the selected program to open this
kind of file” and click on OK.
Figure 3: Select Program
5. In Notepad, click on Edit > Find. Enter “gds_db” and click on the “Find Next” button.
Page 2 of 10 P/N: 01509-001 Rev. A
Page 3
DoorsNXT Remote Port Change
Reference Document
Figure 4: Find “RemoteServicePort”
6. The following line should appear:
gds_db 3050/tcp #InterBase or Firebird server
NOTE: The wording of the #comment will vary depending on whether the entry was put there by InterBase or an old
version of Firebird. If that line is not listed, it must be added to the bottom of the list (in the #comment, remove the “or
Firebird” portion).
7. Next, add a new line with an entry for the Firebird service port exclusively, using a different port and service name
(the port number may be any valid port of your choosing):
fb_db 3051/tcp #IFirebird server
8. Click on File > Save to save the changes.
9. Reboot the PC for the changes to take effect.
Page 3 of 10 P/N: 01509-001 Rev. A
Page 4
DoorsNXT Remote Port Change
Reference Document
1.3 Change the Remote Service Name
1. Using Windows Explorer, locate the “...\DoorsNXT\OtherFiles\firebird.conf” file.
2. Right click on firebird.conf and select open.
Figure 5: Windows Explorer Open Firebird.conf File
3. A window appears asking what program to use to open the file. Choose the “Select the program from a list” option
and click on OK.
4. From the list select Notepad. Remove the check from the option to “Always use the selected program to open this
kind of file” and click on OK.
Figure 6: Select Program
Page 4 of 10 P/N: 01509-001 Rev. A
Page 5
DoorsNXT Remote Port Change
Reference Document
5. In Notepad, click on Edit > Find and enter “RemoteServiceName” (notice there are no spaces between the words).
Click on the “Find Next” button.
Figure 7: Find “RemoteServiceName”
6. The RemoteServiceName must be changed to match the changes made previously (gds_db needs to be replaced with
fb_db). Also, the line must be activated by removing the # symbol. The following lines:
#RemoteServiceName = gds_db
#RemoteServicePort = 3050
Should be changed so that they appear as:
RemoteServiceName = fb_db
#RemoteServicePort = 3050
7. Click on File > Save and close Notepad.
Page 5 of 10 P/N: 01509-001 Rev. A
Page 6
DoorsNXT Remote Port Change
Reference Document
1.4 Restart the DoorsNXTSvr and Firebird Server services
1. To restart the DoorsNXTSvr and Firebird Server services, click on Windows Start and select Control Panel.
2. Double-click on Administrative Tools.
3. Double-click on Services.
4. Locate and click on DoorsNXTSvr so that it is highlighted.
Figure 8: Restart DoorsNXTSvr and Firebird Services
5. Click on “Start the service.” When the DoorsNXTSvr is started, the Firebird Server is automatically started.
Page 6 of 10 P/N: 01509-001 Rev. A
Page 7
DoorsNXT Remote Port Change
Reference Document
2.0 DoorsNXT Server and Client On Different PCs
2.1 Stop the DoorsNXTSvr and Firebird Server services
1. To stop the DoorsNXTSvr and Firebird Server services, click on Windows Start and select Control Panel.
2. Double-click on Administrative Tools.
3. Double-click on Services.
4. Locate and click on Firebird Server so that it is highlighted.
Figure 9: Services...
5. Click on “Stop the service.” A window appears to confirm that the DoorsNXTSvr is to be stopped as well. Click on
the “Yes” button.
2.2 Change the Remote Service Port
1. Using Windows Explorer, locate the “...\DoorsNXT\OtherFiles\firebird.conf” file.
2. Right click on firebird.conf and select open.
Figure 10: Windows Explorer Open Firebird.conf File
Page 7 of 10 P/N: 01509-001 Rev. A
Page 8
DoorsNXT Remote Port Change
Reference Document
3. A window appears asking what program to use to open the file. Choose the “Select the program from a list” option
and click on OK.
4. From the list select Notepad. Remove the check from the option to “Always use the selected program to open this
kind of file” and click on OK.
Figure 11: Select Program
5. In Notepad, click on Edit > Find and enter “RemoteServicePort” (notice there are no spaces between the words).
Click on the “Find Next” button.
Figure 12: Find “RemoteServicePort”
Page 8 of 10 P/N: 01509-001 Rev. A
Page 9
DoorsNXT Remote Port Change
Reference Document
6. 5 lines below, enter “RemoteServicePort=3051” in a new line below the line “#RemoteServicePort=3050.”
NOTE: The new RemoteServicePort number may be any valid port that is not in use by any other programs on the PC.
Figure 13: Enter New Port
7. Click on File > Save and close Notepad.
8. Reboot the PC for the changes to take effect.
2.3 Restart the DoorsNXTSvr and Firebird Server services
1. To restart the DoorsNXTSvr and Firebird Server services, click on Windows Start and select Control Panel.
2. Double-click on Administrative Tools.
3. Double-click on Services.
4. Locate and click on DoorsNXTSvr so that it is highlighted.
Figure 14: Restart DoorsNXTSvr and Firebird Services
Page 9 of 10 P/N: 01509-001 Rev. A
Page 10
DoorsNXT Remote Port Change
Reference Document
5. Click on “Start the service.” When the DoorsNXTSvr is started, the Firebird Server is automatically started.
6. Open up each Client and select the Connection Settings tab. After entering the password, change the Server Name to
add the port number.
For example: If the servername was “DoorsNXTServer” it needs to be changed to read “DoorsNXTServer/3051” (or
whatever port number is used). This will tell the client to communicate to the firebird server using port 3051 instead
of the default port of 3050.
3.0 Contact Keri Systems
Keri USA Keri UK, Ireland, Europe
2305 Bering Drive
San Jose, CA 95131
Telephone: (800) 260-5265
(408) 435-8400
Fax: (408) 435-7163 Fax:+ 44 (0) 1763 274 106
Web: www.kerisys.com Web:www.kerisystems.co.uk
E-mail: sales@kerisys.com
techsupport@kerisys.com
Unit 17
Park Farm Industrial Estate
Ermine Street
Buntingford
Herts SG9 9AZ UK
Telephone: + 44 (0) 870 444 7234
E-mail:sales@kerisystems.co.uk
tech-support@kerisystems.co.uk
End of document.
Page 10 of 10 P/N: 01509-001 Rev. A
Loading...