====== Changing Connection Port Allocation ======

During an upgrade or migration of your TapeTrack Server you may choose to change which port the Framework communicates with the Desktop Client programs.

===== Changing Framework Server Port Allocation =====

==== Changing Port Using The Framework Server Helper ====

Changing Port using the Framework Server Helper is the easiest and most recommended method.

Open the Framework Server Helper which is installed in the directory TapeTrack\TapeTrack Framework Server, (default location C:\Program Files\TapeTrack\TapeTrack Framework Server) by double clicking on the executable ''TMSS10ServerHelper.exe''.

Change the port number in the field ''Port'' under the ''Options'' section to the required port number, in this example from port 5000 to 443.

Click ''Save Service Settings'' to update the data.

{{server_helper_port_number.gif}}

[[server:start_stop|Stop and then start the TapeTrack Service]] to allow the Framework Server to access the new port.

{{server_helper_start_stop.gif}}

==== Changing Port Using The Registry Editor ====

<note warning>Changes made to the Windows registry happen immediately, and no backup is automatically made. Do not edit the Windows registry unless you are qualified and confident about doing so. \\
 \\
Microsoft have issued the following warning with respect to the Registry Editor: \\
//"Using Registry Editor incorrectly can cause serious, system-wide problems that may require you to re-install Windows to correct them. Microsoft cannot guarantee that any problems resulting from the use of Registry Editor can be solved. Use this tool at your own risk."//</note>

Create a [[technote:registry_edit|Registry Backup]] before making any alterations.

In Regedit, navigate to ''Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\TMSS10SVC''.

Open ''ImagePath'' by either double clicking or right clicking and selecting ''Modify''.

{{regedit_open_imagepath.gif}}

The value of the ''Value Data'' will have the directory address of the Framework Server executable 

<code>
"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe"
</code>

An optional value of the port number may also be part of the data string if the Framework Server is currently set to an alternative port other than 5000.

<code>
"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -p 5001
</code>

Change the ''-p'' value to the port required (eg 443)

<code>
"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -p 443
</code>

{{regedit_set_port.gif}}

Click ''OK'' to update the configuration data.

Close the Registry editor.

[[server/start_stop|Stop and then Start the Framework Service]] to allow the Framework Server to access the new port.


==== Changing Port Number On Linux ====

<note tip>Instructions based on Fedora.  Adjust any commands for other Linux oerating systems as required</note>

[[server/start_stop|Stop]] the server 

Navigate to 
<code>/etc/rc.d/init.d</code>

Open the file **tapetrack** in vi or similar editor.

Add **-p 443** to the start function as shown.

<code>
start()
{
        echo "Starting TapeTrack"
        /usr/sbin/TMSS10 -R /var/run/tapetrack.pid -p 443 &
        RETVAL=0
}</code>

Save the file and reload systemd manager configuration using **systemctl daemon-reload** 

Some systems may need a reboot to finalise changes.

[[server/start_stop|Start the Framework Service]] to allow the Framework Server to access the new port.
===== Changing Connection Port For Desktop Software =====

To change the port on an existing entry in a Desktop Program, from the login window, click the ellipses button to the right of the drop down connection box to open the ''TapeTrack Options'' window.

{{login_open_connection.gif}}

Right click your connection and select ''Properties''

From the ''Server Information'' window edit the Server Port value to the required port number (eg 443).

{{login_port_update.gif}}

If required you can update the Server address as well at this point.

Click ''OK'' to save the data

{{tag> technote server port master lite checkpoint}}