To launch a server on the remote host using the daemon process

Note: If you plan to use the Micro Focus DevHub SSH Only connection type to connect to a remote host, you do not need to use the daemon process.

The most common approach to launching a remote host server required to allow you to create, build and debug a project on a remote host, is to use the daemon process.

This process listens to a particular port for any requests from the Eclipse IDE. When a request is made, the daemon launches a server and assigns the ID of the connecting user, so that any subsequent compiling and debugging processes are run as this user.

To start the daemon, you need a version of both Perl on your UNIX machine and a version of Java.

Starting the Daemon

Important: Before starting the daemon you must have the following on your UNIX machine:
  • A version of Perl.
  • A supported version of Java - current minimum support is Java 17.
  • The as (assembler) and ld (linking) programs on the path, as specified by the PATH environment variable.

The daemon can be run with or without parameters. If no parameters are specified, the process relies on the default values in $COBDIR/remotedev/rdo.cfg.

Important: If Visual COBOL Development Hub has been installed without superuser credentials (see Installing Without Superuser Credentials), you must ensure that the following commands are carried out using superuser credentials. This is because the Micro Focus Dev Hub RSE and Micro Focus Dev Hub using SAMBA, NFS, etc connection types require elevated privileges to authenticate upon connection to the server.

Use the following syntax to start the daemon on the remote host:

$COBDIR/remotedev/startrdodaemon [<port> <low port>-<high port>] 
where:
  • <port> is the port number that the daemon should use to listen for connections from Eclipse. If no value is given, it will default to the value specified in $COBDIR/remotedev/rdo.cfg; the default value on installation is 4075.

    Example: To start the daemon listening on port 4999:

    $COBDIR/remotedev/startrdodaemon 4999

    This command will override the default port in rdo.cfg.

  • <low port>-<high port> is the range of ports on which the servers (launched by the daemon) should use to communicate with Eclipse on the client machine. If no values are given, the range defaults to that specified in $COBDIR/remotedev/rdo.cfg; the default range on installation is 10000-10003.

    Example: To instruct the daemon (on port 4999) to instantiate servers using a range of ports 4090-4993:

    $COBDIR/remotedev/startrdodaemon 4999 4090-4993

    This command will also override the default ports in rdo.cfg.

If the server has an active firewall, it is important that these ports are open in the firewall settings. You can use the configrdo utility to set the default ports in rdo.cfg to ones already open in the firewall. If you are running on a supported Red Hat platform, you can also use the utility to open the required ports in the active firewall. See Configuring the firewall for more information.