Host On-Demand Version 6.0 Help
Total Page:16
File Type:pdf, Size:1020Kb
Welcome to IBM Host On-Demand Version 6 Help Click any help topic in the Table of Contents to the left. Click Basic Steps for Getting Started for basic steps to configuring and starting Host On-Demand. When you see this icon in The associated information: the help: Applies only to the Host On-Demand server. Supplements important points in the main text. Provides hints to help apply the techniques and procedures described in the main text. Specifically relates to Lightweight Directory Access Protocol (LDAP) directory service. Basic configuration steps After installing Host On-Demand, you'll need to configure Host On-Demand sessions for your users. To do this, you need to create HTML files that define how users access session configuration information. You can use the Deployment Wizard to do this. Host On-Demand Deployment Wizard The Host On-Demand Deployment Wizard guides you through the necessary steps to create an HTML page that can be used to launch Host On-Demand host sessions. Using the Deployment Wizard, you can choose from three different configuration models to specify how session configuration information and users preferences (e.g., changes users make to session size and location, colors, etc.) are defined and managed: ● HTML-based model ● Configuration server-based model ● Combined model If you choose the HTML-based model, all session information is contained in the HTML file itself, and nothing more is needed to define host sessions. After the HTML file is downloaded by clients initially, the session configuration information and user preferences are stored locally on the user's machine. If you are using the configuration server-based model or the combined model, you must define the sessions in the configuration server. (It may be useful to configure the sessions on the configuration server before creating the HTML file with the Deployment wizard). The configuration server is a part of Host On-Demand that centrally stores session configuration information and user preferences by user and group IDs. Users then access session information and user preferences by contacting the configuration server. The configuration server is managed through the Administration Utility. In addition to defining how sessions and user preferences are defined and managed, with the Deployment Wizard, you can configure a number of client-side options, such as: ● whether the Host On-Demand files should be cached for quicker startup ● what components should be included in the initial download (thus determining the size of the initial download) ● what session functions are available to users ● whether to automatically log users on to Host On-Demand ● run-time options, such as session size and placement, colors, toolbar customization, macros, etc. ● display options ● locale options (for example, what language to display in) Host On-Demand includes a number of pre-defined HTML files that can be used by users to access sessions. Refer to the Getting Started Guide for these pre-defined HTML files. They all use the configuration server-based model, and therefore all require you to define sessions on the configuration server. Starting the Deployment Wizard The Deployment Wizard runs on Windows Operating Systems only. When you install Host On-Demand Server on Windows, the wizard is also installed and can be started from the Start menu. Or, you can run the wizard from the CD. The recommended way is to run the wizard from an installation, not the CD, since more options are available that way. However, if the Host On-Demand server is not on Windows, you can run the wizard from the CD. To run the wizard from the CD, insert the CD into a Windows machine, and choose Run Deployment Wizard on the main install screen. When running from the CD, the Wizard will generate a zip file in the directory that you choose. The zip file will contain all files needed in the publish directory of your Web server. You will need extract the files into your webserver's publish directory. Using the Deployment Wizard To use the Deployment Wizard, follow the instructions and prompts in the Wizard. To get help on a particular panel, press the Help button in the Wizard. The wizard will create an HTML file, as well as several supporting files. For example, if you create a file called session.html, this file will be created in the Host On-Demand publish directory (unless you specify a different directory), along with an autosession.html that is used for bookmarking this file. Additionally, several other supporting files are created in a new directory which is located in the /HODData directory and is named after the HTML file name (e.g., /HODData/session/). Note that these files are used by Host On-Demand and should not be edited manually. To use these client HTML files on another operating system, move the created HTML files and the directory created in /HODData/, including all the files, to the publish directory of another installation. Directories are case sensitive and must be maintained. Transfer files in binary when transferring to the host system. For MVS and UNIX operating systems, set file permissions for those files to 666. For example, chmod 666 newgroup.html. File extensions for HTML files transferred to an MVS host system must be changed to html.ascii. File extensions for text files located in the HODData subdirectory must be changed to txt.ascii. If you specify a cached client page, HTML pages for the Java2 browser will also be created. (These files should also be copied to the server.) Therefore, for cached client pages, four HTML files are created. For download clients, only two HTML files are created. Configuring the Host On-Demand Configuration Server If you are using the configuration server-based model or the combined model, you must configure sessions on the configuration server. The configuration server is configured through the Administration Utility. Complete the following steps to define sessions in the configuration server: 1. Open the Administrator Utility. On Windows NT, click Start > Programs > IBM Host On-Demand > Administration > Administration Utility (or click the link above). On other platforms, open HODAdmin.html in the HOD directory. You can open the Administrator window from any computer that has access to the Host On-Demand server. 2. Logon. The default user ID is admin and the password is password. 3. Change your administrator password. For security reasons, you should change the default administrator password. 1. Click the Users/Groups. 2. Right-click admin from the User List, and click Properties. 3. Type the new password in the New Password box, and Confirm Password fields. 4. Click OK. At this point, you may want to enable Host On-Demand to use Lightweight Directory Access Protocol (LDAP), which allows for information sharing between Host On-Demand servers. For instructions on how to setup and use this optional feature, click here. 4. Add groups. Host sessions can be defined for groups. Using groups can significantly reduce administration effort as all sessions defined for the group are available to all user IDs in the group. 1. Click New Group. 2. Type the Group ID. The first character must be a letter and you can use only A-Z, a-z, 0-9, . (period), and - (hyphen). Group IDs are converted to uppercase characters. Group IDs are not converted to uppercase when you are using LDAP. 3. Optionally, type a description of the group. Any character is allowed except | (vertical bar) or # (number or pound sign). 4. Optionally, select the users who are to be members of the group from the Not a member of list. If you are using LDAP, select the parent group from the Subgroup of list. 5. Click Add. If you are using LDAP, skip this step. 6. Click Apply. Repeat steps 3 - 7 if you want to create another group. 7. Click Close when you finish. 5. Add users. This step is only necessary if you are using the configuration server-based model. Each user must have an ID to log on to Host On-Demand. This step describes how to create a user ID for each user. Optionally, if your users log on to a Windows domain, you can have the configuration server automatically create IDs for them based on their Windows usernames. This option is available through the Deployment Wizard, and does not require that you follow these steps to create user IDs. 1. Click New User. 2. Type the User ID. You can use only A-Z, a-z, 0-9, . (period), and - (hyphen). User IDs are converted to lowercase characters. IDs must be unique. You cannot have a user ID and a group ID that are the same, even if one is in lower case and the other is in upper. User IDs are not converted to lowercase when you are using LDAP. 3. Optionally, type a description of the user. Any character is allowed except | (vertical bar) and # (number or pound sign). 4. Optionally, type a password and confirm it. Any character is allowed. 5. Select one or more groups for the new user from the Member of list. A user must be a member of at least one group. If you are using LDAP, a user can be a member of only one group. 6. If you do not want the user to change the password, click User cannot change password. 7. Click Apply. Repeat steps 2 - 7 if you want to create another user account. 8. Click Close when you finish. To allow users to create accounts for themselves or for other users, check Allow users to create accounts on the Users/Groups window. 6. Configure host sessions for users and groups.