Setting Up the MKS Toolkit on Windows

Set up the MKS Toolkit on the DAS host and on all hosts where instances in your cluster will reside.

The following topics are addressed here:

• To Install the MKS Toolkit

• To Set the Path for Windows and for the MKS Toolkit Shell

• To Set the Home Directory for the MKS Toolkit SSH User

• To Configure and Start the MKS Toolkit SSH Server Daemon sshd

To Install the MKS Toolkit

For centralized GlassFish Server administration, the default installation of the MKS Toolkit is sufficient.

• Follow the instructions in the MKS Toolkit product documentation to install OpenSSH from the MKS Toolkit with default installation options.

See Also

For detailed information about installing MKS Toolkit, seeInstalling MKS Toolkit in MKS Toolkit v9.4 Release Notes.

To Set the Path for Windows and for the MKS Toolkit Shell

To enable GlassFish Server tools to find commands for SSH, each user's path for Windows and for the MKS Toolkit shell must contain the following directories:

• The MKS Toolkit bin directory, for example C:\Program Files\MKS Toolkit\mksnt

• The bin directory of the JDK software

The MKS Toolkit installer automatically adds the MKS Toolkit bin directory to the path. However, you must add the bin directory of the JDK software to the path yourself.

1. Log in as a user with Administrator privileges.

   Logging in as a user with Administrator privileges ensures that the change applies to all users.

2. In the System Information control panel, click Advanced->Environment Variables.
3. Add the bin directory of the JDK software to the Path environment variable.

To Set the Home Directory for the MKS Toolkit SSH User

The SSH Server Daemon sshd locates a user's home directory from the configuration in the user database, not from environment variables such as HOME. To ensure that all GlassFish Server commands can run without errors, each SSH user must be configured to have a home directory.

Each user on a Windows host where SSH is set up potentially has two home directories:

• Windows home directory. GlassFish Server commands, which are run in a Windows command window, use the Windows home directory.

• SSH home directory. SSH commands, which are run in a shell such as bash or ksh, use the SSH home directory.

If these home directories are different, GlassFish Server and SSH each locate a user's .ssh directory in different directories. To simplify the set up of SSH, configure each user's home directory for SSH and Windows to be the same directory. A disadvantage of this approach is that the SSH home directory has spaces in its path name. Spaces in path names are cumbersome in the UNIX environment.

1. Compare the pairs of settings for Windows and the MKS Toolkit that are listed in the following table.
   

   Windows Environment Variable MKS Toolkit Field HOMEPATH Home Directory HOMEDRIVE Home Directory Drive

   1. In a Windows command window, determine the values of the following environment variables:

      • HOMEPATH

      • HOMEDRIVE

   2. In an MKS Toolkit shell, determine the current settings of the following fields for the user:

      • Home Directory

      • Home Directory Drive

      $ userinfo user-name

      user-name

      The user name for the user whose home directory you are setting, for example Administrator.

2. If the settings do not match, update setting of each MKS Toolkit field to match its corresponding Windows environment variable.

   If the settings match, no further action is required.

   To update the settings, run the following command in an MKS Toolkit shell:

   $ userinfo -u -fHomeDirDrive:"drive" -fHomeDir:"path" user-name

   drive

   The drive identifier of the disk drive on which the user's Windows home directory resides, for example, C:.

   path

   The path to the user's Windows home directory, for example, \Documents and Settings\Administrator.

   user-name

   The user name for the user whose home directory you are setting, for example Administrator.

   ---

   Note - Do not set the HOME environment variable explicitly. If Home Directory and Home Directory Drive are set correctly, the HOME environment variable specifies the correct path by default.

   ---

3. In an MKS Toolkit shell, confirm that the settings were updated.

   $ userinfo user-name

   user-name

   The user name for the user whose home directory you are setting, for example Administrator.

4. Log out of the host and log in to the host again.
5. Confirm that the home directories are the same as explained in Step 1.

Example 2-1 Setting the Home Directory for the MKS Toolkit User

This example sets the home directory for the MKS Toolkit user Administrator to C:\Documents and Settings\Administrator.

$ userinfo -u -fHomeDirDrive:"C:" 
-fHomeDir:"\Documents and Settings\Administrator" Administrator

To Configure and Start the MKS Toolkit SSH Server Daemon sshd

1. From the Programs menu, choose MKS Toolkit->Configuration->Configuration Information.
2. Enable password authentication and strict modes.
   1. Click the Secure Shell Service tab.
   2. Select the Password Authentication option.
   3. Click Advanced settings.
   4. Click the Login tab.
   5. Deselect the Strict Modes option.
3. If you are using SSH key-file authentication, enable MKSAUTH password authentication.
   1. Click the Authentication tab.
   2. Under Enable/Disable Password using MKSAUTH, type the user's password and click the Enable.
4. Start the SSH server daemon sshd.
5. Confirm that the SSH server daemon sshd is running.

   $ service query MKSSecureSH
   Name:           MKS Secure Shell Service
   Service Type:   WIN32_OWN_PROCESS
   Current State:  RUNNING
   Controls Accepted:      ACCEPT_STOP
   Check Point:    0
   Wait Hint:      0
   Start Type:     AUTO_START
   Error Control:  IGNORE
   Path:           "C:\Program Files\MKS Toolkit\bin\secshd.exe"
   Dependency:     NuTCRACKERService
   Dependency:     tcpip
   Service Start Name:     LocalSystem

Next Steps

After you have completed the setup of SSH on a host, test the setup on the host as explained in Testing the SSH Setup on a Host.