Differences

This shows you the differences between two versions of the page.

--- technote:changing_port [2021/09/09 00:16] – [Changing Framework Server Port Allocation] Scott Cunliffe
+++ technote:changing_port [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Changing Connection Port ======
+====== 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 Port Allocation =====
+===== 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''.
@@ Line 17: / Line 21: @@
 {{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}}