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 the Team Developer perspective, click File > New > Other.

   This opens the New dialog box.

2. Click Micro Focus COBOL > Remote COBOL Project, and then click Next.
3. In the New Remote COBOL Project dialog box, specify a name for your project.
4. Click Next twice.
5. On the row for Connection name, click New Connection.

   This opens the New Connection dialog box.

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

   This opens the Processes page.

8. In the Available Services pane, click DStore Connector Service > Remote Server Launcher > Launcher Properties.
9. Take a look at the Properties pane that shows the details of the launcher and the Server launch command.
10. 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 ${port}" &

    The ${port} is replaced with the port (or port range) you specify in the Server port, replaces ${port} in command field.

    Note: If the Server port, replaces ${port} in command field is set to 0 the DevHub server allocates an available port.

    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 an allocated 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.

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