ZeUS on agents use port 80 when Primary Servers are configured for non standard port

  • 7018699
  • 09-Mar-2017
  • 13-Nov-2017

Environment

Novell ZENworks Configuration Management 11.4
Novell ZENworks Configuration Management 2017

Situation

The ZENworks System Update Service (ZeUS) uses port 80 to communicate with primary server.  If the primary has been installed to use non-standard ports, the request for update information will fail.

ERROR (from zeus-messages.log):

[TaskNotifier] [] [Pinging URI http://primary.zenworks.com:80/zenworks-ping/workToDoServlet] [] [] [] [ZeUSService]
[TaskNotifier] [] [***************** Exception Dump ***********************] [] [] [] [ZeUSService]
[TaskNotifier] [] [Connection refused: connect] [] [] [] [ZeUSService]
[TaskNotifier] [] [------------------------------------------------------------------------------------] [] [] [] [ZeUSService]
[TaskNotifier] [] [Message: Connection refused: connect] [] [] [] [ZeUSService]
[TaskNotifier] [] [Exception Type: class java.net.ConnectException] [] [] [] [ZeUSService]
[ZeUSAgent] [29] [] [TaskNotifier] [] [Stack: java.net.DualStackPlainSocketImpl.waitForConnect(Native Method)] [] [] [] [ZeUSService]
[ZeUSAgent] [29] [] [TaskNotifier] [] [------------------------------------------------------------------------------------] [] [] [] [ZeUSService]
[ZeUSAgent] [29] [] [TaskNotifier] [] [***************** End Exception Dump ***********************] [] [] [] [ZeUSService]

Resolution

This is fixed in ZENworks Configuration Management 2017 update 1 (when both primary and agents are fully updated).

Prior to 2017 update 1, workaround:

For agent:

  1. Make a backup and modify %ZENWORKS_HOME%\zeus\conf\zeus.conf file.
  2. Uncomment and modify this section to change the port:
    #task-notifier-port=80
    Example:
    task-notifier-port=88
  3. Restart the ZENworksUpdaterService or reboot

For primary server:

Note:  This is required only for ZENworks versions 11.4.x but prior to 2017 Update 1.  In 2017 Update 1 the server service will automatically set correctly.

  1. Make a backup outside of ZENworks folder of this file:
    /opt/novell/zenworks/share/tomcat/webapps/zenworks-ping/WEB-INF/web.xml
  2. Modify the original web.xml file to uncomment and set the port to match the zeus.conf file setting:
    <!-- init-param>
    <param-name>com.novell.zenworks.zeus.worktodo.nioport</param-name>
     <param-value>80</param-value>
    </init-param-->


    example:
    <init-param>
    <param-name>com.novell.zenworks.zeus.worktodo.nioport</param-name>
    <param-value>88</param-value>
    </init-param>
  3. Restart the ZENworks services



Additional Information

Limitation:  The nio port change will affect ZeUS workToDo requests to all primaries.  In a zone where different primaries have different ports, set to the most commonly used port.  A request has been made to allow more flexibility in future releases of the product.