Citrix WinView Application Note IBM's Classroom LAN Administration System V 1.41 This application note is for informational use only, and Citrix makes no representations or warranties with respect to the contents or use of this document or of any third-party products discussed within. May 4, 1994 Citrix Systems 210 University Drive Suite 700 Coral Springs, FL 33071 (305)755-0559 FAX: (305)341-6880 Overview -------- This application note discusses the use of the IBM Classroom LAN Administration System V 1.41 (referred to as ICLAS) with the Citrix WinView Application Server (referred to as WinView) product. ICLAS is a DOS-based educational software application that runs on a network. It is designed to manage educational software in a school setting. Using ICLAS on a WinView application server rather than on a DOS station provides all the benefits of application servers to ICLAS users: high-speed remote access, enhanced WAN access, and access for underpowered LAN stations. The intended audience for this document is a engineer who has had hands-on experience with WinView, NetWare, and the ICLAS products. The scenarios described in this document have been thoroughly tested by Citrix and Citrix believes that you should be able to get ICLAS to work with WinView without any problems if you follow carefully the information and steps in this document. Other variations to the scenarios described in this document may work but have not specifically been tested by Citrix. In order to maximize your chance for success, you should use the specified revision levels of all software products described in this document and stay within the bounds of the features and functions described in this document. Please note that this application note document is a living document and will be modified as new information and new versions of the software described herein become available. Make sure you obtain the latest version of this document before you begin. The latest version of this document is always available in the Citrix Forum on CompuServe. Requirements ------------ To use ICLAS on a WinView application server you will need the following: Software Requirements - Citrix WinView 2.20 or greater - IBM Classroom LAN Administration System V 1.41 - Novell NetWare 3.11 NOTE: Although ICLAS also supports NetWare 2.X, Citrix has only tested ICLAS on NetWare 3.11. The steps discussed in this document may not be applicable to other versions of NetWare. Hardware Requirements - NetWare file server - WinView server > 486DX-25 CPU or larger > 12 meg memory or more > NetWare supported network adapter Configuration Notes ------------------- The maximum number of concurrent ICLAS users supported on a single WinView server is determined by the hardware specifications of that WinView server. Memory is the most critical resource for the WinView server in determining the number of users. Use the following rule of thumb: 8 MB (megabytes) base memory plus 1 MB for each ICLAS session. Thus, a 16 MB system will support 8 concurrent ICLAS sessions. To go beyond 16 MB, you will need either a EISA system or a 32-bit MCA system. Also, you should increase the CPU size as the user count goes up. The Network Interface Card (NIC) can also make a difference. For large user count systems, you should use a high performance bus master NIC in your WinView server. The following table shows recommended hardware configurations for your WinView server according to user count: USERS MEMORY CPU/mhz BUS NIC ------------------------------------------------------- 2 10 MB 486-25 ISA low performance 4 12 MB 486-25 ISA low performance 6 14 MB 486-33 EISA med performance 8 16 MB 486-33 EISA med performance 10 18 MB 486-50 EISA high performance 12 20 MB 486-50 EISA high performance The above user count recommendations are based on the assumption that each user will only be running ICLAS. If the users will run other applications along with ICLAS, the memory requirements per user will increase. You may also need to use a more powerful processor to support the additional applications. Limitations of ICLAS under WinView ---------------------------------- Not all features and functions of ICLAS are supported under WinView. Limitations under WinView are itemized below: 1) Only the US English language option has been tested and is known to work. Installation ------------ There are three steps required to setup ICLAS with WinView: the NetWare file server installation, the WinView installation, and the ICLAS software installation. The procedure described below will setup a WinView server as if it were multiple DOS LAN workstations setup to run ICLAS. A WinView userID will be created that ICLAS workstations will automatically login to, bringing them immediately to the ICLAS login screen. Administrators may choose to instead make ICLAS a Windows icon or an item on PSEL, the WinView text-based program selector. NetWare File Server Installation -------------------------------- 1) The ICLAS Installation Manual gives a step-by-step guide for installing a NetWare file server. It is suggested that you follow their instructions. ICLAS Installation Instructions: > NetWare 2.15 instructions -- Chapter 3 > NetWare 2.2 instructions -- Chapter 4 > NetWare 3.11 instructions -- Chapter 5 NOTE: Citrix has only tested ICLAS with Netware 3.11. The steps discussed in this document may not be applicable to other versions of NetWare. WinView Server Installation --------------------------- 1) Follow the installation procedures in the WinView "Installation Guide". When determining the drive partitioning on the application server, keep in mind that ICLAS will have problems if LASTDRIVE is greater then E:. It is imperative to limit the number of logical drives on the WinView server between C: and E:. After installation, ensure the statement "LASTDRIVE=E" is in the CONFIG.SYS file. 2) Login to the WinView Server as "ADMIN" with the password "citrix". Start an OS/2 session and enter the command: E \OS2\MDOS\ICLAS.BAT This will invoke the OS/2 editor and will create the file ICLAS.BAT in the \OS2\MDOS directory. ICLAS.BAT should include the following lines: REM Begin ICLAS.BAT \NETWARE\NETX rem CLSSRVST (This line necessary only if you rem have more than one ICLAS server rem on-line) CLSSETV G REM End ICLAS.BAT When you are finished, save this file and exit. 3) From the OS/2 prompt type: E \NETWARE\NET.CFG Change the PREFERRED SERVER to the ICLAS Netware file server. Add the statement SHOW DOTS = OFF if it is not present. Example: link driver SMC8232 slot 2 frame ETHERNET_802.3 protocol stack ipx sockets 100 protocol stack spx sessions 100 netware requester sessions 30 Directory Services Off Show Dots = Off preferred server ICLAS_01 If you make changes in the NET.CFG or CONFIG.SYS, you will have to reboot for changes to take effect. 4) From the OS/2 prompt type: CONFIG APPLICATION Pull down the "Profile" menu and choose NEW APP. Enter ICLAS as the name. Give the entry a title of your choice. (e.g. ICLAS Session) Put: "/k \OS2\MDOS\ICLAS.BAT" in the PARAMETERS field. Select the TYPE as: DOS FULL SCREEN Press F4 to save and exit. Press F3 to return to command prompt. 5) From the OS/2 prompt type: CONFIG PROFILE Pull down the Profile Menu and choose NEW. Enter ICLAS as the name. Highlight the new group ICLAS and press enter. Make the first userprogram: C:\OS2\CTX\ICLAS.PSF. Under Resource Limits, change MAX LOGINS to 999. Under Resource Limits, change MAX SESSIONS to 9999. Press F4 to save and exit. Highlight the ICLAS group and choose NEW from Profile Menu. Enter ICLAS as the new username. Press F3 to return to command prompt. ICLAS Installation ------------------ 1) Login to the WinView Server as ADMIN with the password citrix. Start a DOS session: CD \NETWARE NETX LOGIN SUPERVISOR You should be now logged into the NetWare file server as SUPERVISOR. 2) Put the ICLAS Disk 1 into drive A: and enter: A:G Follow all the instructions on the screen. When asked to insert DOS system diskettes into drive B:, press ESC. This will be done manually later on. The rest of the install only consists of switching diskettes. If you encounter any errors, you should contact IBM. 3) When the installation is done you should still be logged into the file server. Go to the PUBLIC directory: CD SYS:\PUBLIC There should be a DOS directory in the PUBLIC directory. If the directory does not exist, make the directory: MD DOS Then change into that directory: CD DOS Make a new directory for WinView called V2.21 MD V2.21 CD V2.21 You should now be in the directory \PUBLIC\DOS\V2.21. Copy WinView's COMMAND.COM into this directory: COPY C:\OS2\MDOS\COMMAND.COM 4) The file server should be downed and brought back up before continuing. 5) When the installation is done, log completely out of WinView. You may now log into WinView as the ICLAS user. You should come up to the ICLAS Login screen. You may now log in as SYSOP and begin to configure ICLAS. What Was Done ------------- ICLAS was installed and configured just as if it were on a network with multiple DOS clients. Instead of using ICLAS's recommended setup and configuration for DOS clients, one was created manually for use by WinView. The user ICLAS's first user program is a PSF (\OS2\CTX\ICLAS.PSF) that automatically starts a DOS session. The DOS session runs AUTOEXEC.BAT and ICLAS.BAT. ICLAS.BAT will bring the user to the ICLAS login screen. The PSF was placed as the first user program of the ICLAS user, but it can also be called or started from an OS/2 Command Prompt, the PSEL character based Program Selector, or as a program item in a Windows session. All of these methods will yield an ICLAS login screen. Other Notes ----------- After ICLAS is successfully installed on the server, running ICLAS should be no different, operationally, than running ICLAS on a DOS machine. The following are some additional considerations. ICLAS allows certain users to run applications from drive A:. If a user tries this ICLAS will attempt to use drive A: on the WinView server. If a user needs to access drive A:, it should be done from the WinView system console. The best way to prevent users from inadvertently trying to access the A: drive is to use CONFIG ACCESS to set Reserve access on the A: drive. You can add multiple WinView servers onto the ICLAS network. Perform the WinView installation as discussed above. Each WinView server should be configured like the others. ICLAS dedicated workstations To make certain workstations capable of only running ICLAS, use the CONFIG TERMINAL utility to configure them to automatically login as the user ICLAS.ICLAS (username.groupname) by specifying "ICLAS" as the Username and "ICLAS" as the Groupname on the "Edit Workstation Profile" screen. You may also blank out the session create hotkey specification to prevent users from starting more sessions. Running ICLAS from a WinCredible session Add a new item to any group specifying the program name as "C:\OS2\CTX\ICLAS.PSF". When a user clicks on this icon, the ICLAS PSF will be run resulting in an ICLAS login screen. Running ICLAS from PSEL, the WinView Program Selector Add a new entry under "Start Programs", specifying the program name as "C:\OS2\CTX\ICLAS.PSF". When a user selects this entry, the ICLAS PSF will be run resulting in an ICLAS login screen. Compatibility ------------- ICLAS changes the system login script on the file server. If you are using Netware 3.11 you might find you have to replace the SPOOL command that ICLAS places in the script with an equivalent CAPTURE command. To do this, login to ICLAS as SYSOP. You may then choose the "Netware Utilities Menu" option and then "System Configuration". From here you may go in and change the System Login Script.