Install the zRemote

The zRemote is an aggregation and data processing component that installs in the distributed environment. The zRemote offloads much of the OneAgent processing from the CICS/IMS code modules thereby reducing the MSU load incurred in instrumenting mainframe applications.

The sizing of the box where the zRemote runs depend on the anticipated load volume (i.e., transactions/second that should be processed by the zRemote). Please see the general guidelines below for planning the sizing.

  • For development environments, a small or medium-sized box should be fine
  • For production environments, we recommend at least a large or extra-large box
Hardware requirements Small (DEV) Medium (DEV) Large (PROD) X-Large (PROD)
Anticipated transactions/second 4,000 7,500 15,000 30,000
Required CPU cores (e.g., Xeon E5-2600 series) 2 4 8 16
Required memory 4GB 6GB 8GB 16GB
Required disk space 20GB 20GB 20GB 20GB

Installation and configuration

The zRemote is downloaded and installed automatically during the ActiveGate installation procedure. You only need to select the Route z/OS traffic to Dynatrace option during ActiveGate installation. No further configuration of the zRemote is required, as it obtains all necessary settings from the ActiveGate.

By default, the zRemote listens on port 8898 for connections from the zLocal, running as part of zDC in the mainframe. You can configure it to listen on a different port by using the zdclistenerport parameter in ruxitagent.conf. You should ensure that this port is not blocked by a firewall.

Note
  • The zRemote should only service one zDC and its zLocal. However, it is possible to run more than one zDC, zLocal pair per LPAR.
  • The zRemote isn't supported by Environment ActiveGates that are configured for multi-environment support.
  • The zRemote must route z/OS traffic to another ActiveGate, which in turn routes the traffic to Dynatrace.

Supported operating systems

  • Windows x64
  • Linux x64

Stop and restart the zRemote service

Under unusual circumstances, it may be necessary to stop or restart the zRemote service. You can use the following commands to stop/restart the zRemote service.

You need root privileges to execute these commands.

To query the current status of the zRemote service:

service zremote status

To stop, start, or restart the zRemote service:

service zremote stop|start|restart|forcestop

The difference between stop and forcestop is that the stop command instructs the process to execute its controlled shutdown routine, while forcestop forces the process shutdown.

Uninstall the zRemote

Although the zRemote is installed automatically during ActiveGate installation, it isn't removed when the ActiveGate is removed. You must uninstall the zRemote separately.

You need root priviliges to execute this command.

/bin/sh /opt/dynatrace/zremote/uninstall.sh