How to change the port that a Windows SystemEDGE Agent runs on

Document ID : KB000023688
Last Modified Date : 14/02/2018
Show Technical Document Details

NOTE: This document only applies to older versions of SysEDGE. Please see TEC1859517 for instructions for the 5.x versions of SysEDGE.

 

 

Question: How to change the port that a Windows SystemEDGE Agent runs on 

Answer: There are a few ways that the port can be changed, as follows:

Option A: Set the port to be used during install

The install of 4.2 SystemEDGE Windows agents asks if the Microsoft Master SNMP agent should be disabled. If this is selected, SystemEDGE will use the port the Master SNMP agent normaly uses, port 161. If this option is not selected, the port that SystemEDGE should use can be set at this time. The agent will default to port 1691 unless otherwise specified.

 

Option B: Change the port after installation

In the SystemEDGE_HOME directory, there is a utility called "setup". From a command prompt run this "setup" utility with the -p flag and provide it the value of the new port that SystemEDGE should run on. The command will change the port, but only after the agent has been stopped and restarted.

After the "setup" utility has been run with the -p flag, followed by a stop/start of the agent, the SystemEDGE port will be changed. The only way to change it back is to again issue the command and stop/start the agent. The utility output will be similar to the following:

 

  C:\sysedge>setup -p 1691
  SystemEDGE Setup Utility 4.2 Patchlevel 1
  Copyright 2004 by CA, Inc
  Default port was 161.
  Default port is now 1691.
  Setup of the new port entry was successful.
  This will take effect only on the next startup of SystemEDGE.
  For example:
          net stop sysedge
          net start sysedge
  C:\sysedge>

 

Confirming the Port Change

 

Once the port change is made, there are a few ways to confirm what port is in use. One way is to review the registry key that contains the port that the agent is to use. Please do not set the SystemEDGE port by editing the registry keys as these keys are easy to corrupt via manual editing.  To check the registry settings, open the registry editor in Windows and go to the following registry key and confirm the value:


HKEY_LOCAL_MACHINE\SOFTWARE\Empire Technologies\Empire SystemEDGE\CurrentVersion\DefaultPort

Another way is to review the output of the diagsysedge command. To do this, go to the Start->ControlPanel menu and double click on the eHealth SystemEDGE icon to open the SystemEDGE Control Panel. Click on the diagsysedge button and review the top of the resulting file to confirm the port. It will look something like this:

diagsysedge.exe V1.02.0 - Copyright 2004 CA, Inc. All rights reserved.
Copyright 2004, CA Inc.


http://support.ca.com
https://support.ca.com
Fri Dec 17 13:04:50 2004
Target IP : 127.0.0.1
Platform : WIN32 diagsysedge V1.02.0
Community : public
Port Number: 1691
Timeout : 4

 

Lastly, the final option is to enable agent debug and review the output after a stop/start of the agent, as follows:

 

  1.  Go to Start->ControlPanel and double click on the eHealth SystemEDGE icon to open the SystemEDGE Control Panel
  2.  Select the sysedge.cf button and when the file is open, add the line 'sysedge_debug' to the top. Save the file.
  3.  In the SystemEDGE Control Panel use the buttons available to first stop the agent and th.en restart the agent.
  4.  After the agent has restarted, press the sysedge.log button in the SystemEDGE Control Panel and search the resulting debug output for the line:

<Date_Stamp> <Time_Stamp>: sysedge: using port 1691, config file c:\winnt\system32\sysedge.cf



(Legacy KB ID CNC TS17378 )