








                    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.


