5.1 Changing ZENworks API Gateway Port

The ZENworks API Gateway by default uses the 443 port. The following actions should be performed in the same order.

  1. Upgrade the port number on the agent machine:

    1. Stop the agent service.

    2. Update the initial-web-service file on the managed device with the correct port number. The initial-web-service file can be accessed from the following location:

      • Linux Managed Devices: /etc/opt/novell/zenworks/initial-webservice

      • Windows Managed Devices: %ZENWORKS_HOME%/conf/initial-web-service

    3. Remove the cache folder.

  2. Update the port number on the server. The application.properties file can be accessed from the following location:

    • Windows: %ZENSERVER_HOME%\conf\zen-api-gateway\application.properties

    • Linux: /etc/opt/microfocus/zenworks/zen-api-gateway/application.properties

    1. Stop the ZENworks services by using the microfocus-zenworks-configure -c Start command.

    2. Open the application.properties file in a text editor and update the Service.port to https port that you want to configure.

      NOTE:On Linux, at the end, ensure that the permissions of application.properties are intact. Permissions should be -rw-r--r--, and ownership should be zenworks:zenworks. If you are unsure, it is recommended to run permissions.sh at the command prompt.

    3. Open an SQL console to execute the following SQL queries:

      • For MSSQL run the following queries:

        • update zzenserver set SSLPort = <NEW_HTTPS_PORT> where zuid = 0x<SERVER_GUID>

      • For Oracle run the following queries:

        • update zzenserver set SSLPort = <NEW_HTTPS_PORT> where zuid = HEXTORAW('<SERVER_GUID>)

      • For PostgreSQL run the following queries:

        • update zzenserver set SSLPort = <NEW_HTTPS_PORT> where zuid = '\x<SERVER_GUID>'

    4. Update the initial-web-service, file on the server with the latest https port number:

      • Windows: %ZENSERVER_HOME%/conf/initial-web-service

      • Linux: /etc/opt/microfocus/zenworks/initial-web-service

    5. If you have a firewall enabled, update it with the new port numbers.

    6. Run microfocus-zenworks-configure -c ZenProbeConfigureAction to configure probe.

    7. Restart the ZENworks services using the microfocus-zenworks-configure -c Start command (select the option next to Restart).

    8. Execute the zman lrr -f command to re-calculate the closest server rules.

    9. Re-build deployment packages using the microfocus-zenworks-configure -c CreateExtractorPacks -Z command.

  3. Start the agent service. Use either the /etc/init.d/novell-zenworks-xplatzmd start --clean command or the systemctl start novell-zenworks-xplatzmd.service command for Linux devices.

  4. Update the port numbers on the registered Inventory Only Agents.

    • For already registered Windows Inventory-Only Agent (IOA) devices, update the ZENServer’s new secure port in the entries SecurePort and Port respectively in the below registry key.

      For 64-bit Agent: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell\ZCM\UMIA]

      For 32-bit Agent: [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\UMIA]

      Restart the service “Micro Focus ZENworks Adaptive Agent Service”.

    • For already registered Linux and Mac Inventory-Only Agent (IOA) devices, update the uiaconfig.xml file with the new port number.

      The file uiaconfig.xml is available in the /var/opt/microfocus/zenworks/ location.