|
|
Toll Free: (866) 407-5279 Direct: (651) 407-5279 |
|
|
|
Toll Free: (866) 407-5279 Direct: (651) 407-5279 |
|
In UpdateEXPERT Premium 7.x, a port number change for already installed Master-Agents can be performed by changing the user's console port number, and changing the Master-Agent port number. This is done by:
Editing the User Console Port in "File > Agent > Connect/Configure", or related registry key (Note: this may need to be done for more than one user).
Editing the Master-Agent Port in the Agent registry.
Performing the above can be affected by the chosen port number. To summarize:
If specifying a port within the 1025 to 65535 range, change User Console Port with the GUI, exit Console, stop ueagent, edit Master-Agent Port via registry editor, start ueagent, launch console to test.
If specifying a port below 1025 (only if you must), exit the Console, stop ueagent, edit both registry key values via registry editor, start ueagent, launch console to test.
Details are as follows …
Note that additional Master-Agents and Leaf-Agents deployed with Agent-Installer can be assigned a non-default port number as part of the agent deployment dialogue. For an explanation of reserved/non-reserved application ports, plus related Leaf-Agent information, see:
Can I configure Leafs to use port assignments below 1025?
Master-Agents and Leaf-Agents install using port 9968 by default. This falls within the allowed port range of 1025 to 65535 as enforced by the UpdateEXPERT Agent-Installer GUI, and Master-Agent Configuration screen. Below is an example of a port change enforcement in the Master Agent Configuration (the attempt is to use port 22). This same error is displayed in the Agent Installer GUI when attempting to deploy an agent outside the allowed range.
If you must configure a port below 1025, you may do so by editing the user console registry key directly (getting around the GUI enforcement), as well as the Master-Agent registry value. Also, note that the command-line Agent-Installer does not enforce the recommended port range of 1025 to 65535. This allows Master-Agent and Leaf-Agent installations using a port below the recommended 1025 threshold. See:
How do I use the command line agent installer?
To change the user console port number, go to File > Agent > Connect/Configure, select a Master-Agent (1), click Modify (2), change the highlighted port (3), click Update (4), and click OK (or Apply). Re-enter Connect/Configure to verify the new port assignment is displayed.
The GUI change above modifies the following registry key for the console user.
HKEY_CURRENT_USER\Software\St. Bernard Software\UpdateEXPERT\7.0\Settings\MasterAgentAddressConfig
If you need to change the value directly (perhaps for additional console users after the Master-Agent has changed, or using a port assignment below 1025), double-click the machine name (highlighted below) to edit the tab-delimited string. Make sure to only replace the 9968 with the new port number, and leave the rest of the string as is, including tabs.
WARNING: Do not change the port number of a Master-Agent that has existing Leaf-Agent machines. Communication between the Master and Leafs will be lost. You will end up having to reset the Master-Agent port back to the original value, or re-installing Leaf-Agents.
Do the following:
Stop the UEAgent service … i.e., net stop UEAgent
Navigate to the following registry key on the Master-Agent machine. Double-click on Info to edit the port.
HKLM\SOFTWARE\St. Bernard Software\UpdateEXPERT\7.0\UEAgent\Settings\AgentMap\Agents\0\Data
Start the UEAgent service … i.e., net start UEAgent
Launch the Console and verify the port change in Connect/Configure
