Deploying

  1. To install the GSI-Enabled OpenSSH Server on most systems, you must be a privileged user, such as root.

    sh$ /bin/su - root 

    Note: If your system functions like this and you attempt to run these commands as a user other than root, these commands should fail.

  2. (optional) Start a copy of your system's currently running SSH server on an alternate port by running, eg.

    sh# /usr/sbin/sshd -p 2000 &
    

    You may then choose to log in to this server and continue the rest of these steps from that shell. We recommend doing this since some sshd shutdown scripts do particularly nasty things like killing all of the running SSH servers on a system, not just the parent server that may be listening on port 22. Roughly translated, this step is about guaranteeing that an alternate method of access is available should the main SSH server be shutdown and your connection via that server be terminated.

  3. Locate your server's startup/shutdown script directory. On some systems this directory may be located at /etc/rc.d/init.d, but since this location is not constant across operating systems, for the purposes of this document we will refer to this directory as INITDIR. Consult your operating system's documentation for your system's location.

  4. Run the following command.

    sh# mv $INITDIR/sshd $INITDIR/sshd.bak
    

  5. Either copy or olink the new sshd script to your system's startup/shutdown script directory.

    sh# cp $GLOBUS_LOCATION/sbin/SXXsshd $INITDIR/sshd
    

  6. Shutdown the currently running main SSH server.

    sh# $INITDIR/sshd.bak stop
    

  7. Provided you still have a connection to the machine, start the new SSH server.

    sh# $INITDIR/sshd start
    

  8. Test the new server by connecting to the standard SSH port (22) and authenticating via multiple methods. Especially test that GSI authentication works correctly.

  9. If you are performing a new install, or if the old server was not configured to be started at run-time and shutdown automatically at system halt or reboot, either use a system utility such as RedHat's chkconfig to configure the system for the correct run-levels, or manually olink up the correct run-levels.

    sh# /sbin/chkconfig sshd reset
    

    The recommended run-levels are listed in a set of comments within the SXXsshd startup script. For example, on standard Unix systems we recommend running the GSI-Enabled OpenSSH server in run-levels two, three, four, and five.

  10. Finally, if, as a precautionary measure, you started a SSH server on an alternate port in order to complete the install process, you can now safely stop all instances of that server.