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

If the remote UNIX machine you are connecting to uses LDAP authentication which is not supported by the DevHub daemon, the only way to launch a server on the remote host is to use a Secure Shell daemon process to do this.

This type of connection also has the following benefits:

• It does not require you to run the DevHub daemon process with root privileges.
• It provides more flexibility in setting environment variables needed for building or debugging on the remote server.

To configure and establish a connection to a remote host using an SSH daemon process:

1. In Eclipse, click File > New > Remote COBOL Project.
2. In the New Remote Project dialog box, specify a name for your project.
3. Click Next twice.
4. On the row for Connection name, click New Connection.

   This starts the New Connection wizard.

5. Click Micro Focus DevHub using SSH, and click Next.
6. Specify a Host name and a Connection name, and click Next.

   This opens the Processes page.

7. In the Available Services pane, click Launcher Properties.
8. Take a look at the Properties pane that shows the details of the launcher and the Server launch command.
9. In the Server launch command dialog, supply configuration data specific to your requirements. You can provide these in a script or as a list of values.

   The default command, provided that Java is on your PATH variable, is:

   sh -c "/opt/microfocus/VisualCOBOL/remotedev/startdoserver 0"

   The full command that takes into account the case when Java is not on your PATH variable and Visual COBOL is not installed in the default location is:

   sh -c "PATH=java install directory/bin:$PATH; export PATH; COBOL install directory/remotedev/startdoserver [<port> | <low port>-<high port>] "

   Where:

   • <port> is the port number the server should use to listen for connections from Eclipse on the client machine. If no value is given, it will be assigned a default value of 4033.

     For example,

     $COBDIR/remotedev/startdoserver 4999

     This command will start a server listening on port 4999.

     $COBDIR/remotedev/startdoserver 0

     A value of 0 for <port> indicates the command will start a server listening on a random port.

   • <low port>-<high port> is the range of ports on which the server should use to communicate with Eclipse on the client machine if a port of 0 is specified.

     For example,

     $COBDIR/remotedev/startdoserver 4090-4999

     This command will start a server listening on an available port in the range 4090 to 4999.

10. Complete the Processes and Shells dialogs with the same configuration data, as appropriate.
11. Click Finish.