Chapter 3. Installation

This chapter describes how to install SoftWindows. Note that SoftWindows may be pre-installed on your system, and may have either a permanent license or a time limited trial license already installed. If the SoftWindows2 icon appears in your Applications Icon Catalog page, then SoftWindows has been pre-installed and you will most likely not need any of the information in this chapter.

To install SoftWindows you need an activation license, which can be one of the following:

Table 3-1. Licenses

License

Description

Demonstration license

Allows any number of users to run SoftWindows for a limited time period.

Concurrent (full) license

Allows a specified number of users to run SoftWindows for an unlimited time period.

To install a demonstration or concurrent license you need to:

  1. Install SoftWindows.

  2. Find your license server FLEXlm HostID and server name; refer to Chapter 6, “Hostids for FLEXlm-supported machines”. Complete the warranty card and email it or fax it to Insignia Solutions using one of the following numbers:

    • USA users: (415) 694-3705

    • European users: (+44) (131) 451-6981

    Insignia Solutions will then provide your authorization code.

  3. Install your license.

This chapter describes each of these procedures in detail.

Before you install

Before installing SoftWindows, you need to have either a network connection to a machine with the installable image online or a CD–ROM drive accessible from your workstation. If necessary, refer to your system's documentation for information on how to do this.

The installation process also requires:

  • At least 70 Mbytes of disk space.

  • At least 32 Mbytes of physical memory. The performance of SoftWindows will be improved with more memory. 64 Mbytes are recommended.

It is recommended that at least three times the physical memory be allocated to the swap space, or twice the physical memory size, for systems with more than 32 Mbytes.

Installing SoftWindows

To install SoftWindows from the CD-ROM proceed as follows:

  1. Insert the CD-ROM into the drive.

  2. Double-click on the CD-ROM drive icon to start the “Software Manager.”

  3. Start the install or optionally, select the subsystems to install as described below.

  4. Once the installation is complete, log out and log in again as a user to make the changes to the system files take effect.

To install from a network inst image, start the “Software Manager” by selecting “System” from your Toolchest. Drag the inst file into the drop box and follow steps 3 and 4 above.


Note: To find more information on managing installs using the Software Manager, select “Help” from within the Software Manager window.

The SoftWindows product subsystems are as follows:

Table 3-2. Product Subsystems

Subsystem

Description

SoftWindows 2.0-core

This is the main part of the product and in almost all situations should be installed.

Fonts and Localization

The fonts necessary for SoftWindows to run correctly.

Release Notes

Last minute information about this release

Online Registration Tools

Allows you to use your InterNet or World Wide Web connections for Registration and support.

SoftWindows 2.0 Manuals

Standard Unix style man pages for SoftWindows and the FLEXlm license server.

SoftWindows 2.0 User Guide

An Insight book covering the basic information about using the SoftWindows product.

SoftWindows 2.0 Admin Guide

An Insight book covering advanced information about using the SoftWindows product.

Insignia's Generic documentation

The Hyperhelp viewer and versions of the User Guide and Administrator guide for other platforms. This is not normally needed.

MS Windows 3.1 Setup files

Compressed Windows installation files required for installing Microsoft Windows.


Licensing SoftWindows

If SoftWindows has not yet been licensed, the SoftWindows license manager dialog box will be displayed:

Figure 3-1. License Manager Dialog Box


This allows you to enter the licensing details for your copy of SoftWindows.

To license SoftWindows

  1. If you do not already have an authorization code, complete your warranty card, including your serial number, FLEXlm HostID, and server name, and fax it to Insignia Solutions using one of the following numbers:

    USA users: (415) 694-3705
    European users: (+44) (131) 451-6981

    Insignia Solutions will then contact you with your authorization code.

  2. Enter the data into the license manager dialog box as follows.

    You must enter the data exactly as shown on the license sheet:

    Table 3-3. License Sheet

    Field

    What you enter/select

    Type Of License

    Demonstration or concurrent.

    Serial Number

    A serial number in the form:
    1234 1234 1234 1234

     

    Note that you must enter the spaces. Alternatively, enter a demo code of the form 30-day, specifying the number of days.

    Number Of Users
    (Concurrent license only)

    The number of licenses purchased.

    Expiry Date

    The expiry date supplied by Insignia in the form Day, Month, Year
    for example: 15, 12, 1993
    or: 1,1,0 (for concurrent licenses).

    Authorization Code

    The 20-character authorization code supplied by Insignia; made up from the characters 0-9 and A-F (in upper case) with no spaces between the characters.


  3. Choose Install License to install the license.

You can now run SoftWindows as described in the section “Running SoftWindows,” of the SoftWindows 2.0 for Unix User's Guide.

Setting up SoftWindows for each user

Once SoftWindows has been installed on the system, each user who wants to use SoftWindows. will automatically be setup with an environment to keep their own settings and files. A disk file will be created in the user's home directory which will act as the C: drive would on a real PC.

Changes made:

The automatic procedure makes the following changes:

  • A hard disk container file is created in the user's HOME directory. This file is named WIN311-USER.hdf, where USER is replaced by the user's login name.

  • The X server is set up so that it does not intercept certain key combinations, such as Alt-F4, which are used by Microsoft Windows.

The following table lists the files altered:

Table 3-4. Files Altered by SoftWindows

File

.Xdefaults

.4Dwmrc


To set up SoftWindows manually

This section lists the environment variables you could change if you want to modify the default behavior of SoftWindows.

LM_LICENSE_FILE

Normally, you do not need to worry about this, but if your site uses a network FLEXlm license server, this needs to be set up to specify the location of the FLEXlm license server. It should be set to:

[email protected]

where portnumber refers to the TCP/IP port number of the license server. The default should be 744, as this is the number assigned to SoftWindows.

For example, if the server is called myserve, and FLEXlm is attached to port 744, then LM_LICENSE_FILE should be set up as follows:

For a C shell:

setenv LM_LICENSE_FILE [email protected] R

For a Bourne or Korn shell:

[email protected] R
export LM_LICENSE_FILE R

SWIN2HOME

This environment variable can be used to inform SoftWindows where it was installed. It is used by the SoftWindows executable when looking for various ancillary files. If you have done an automatic installation or manually installed SoftWindows in the /usr/lib/SoftWindows2 directory, then you do not need to set SWIN2HOME.

Additional installation notes

To make the floppy disk drive available to SoftWindows

See Chapter 4, “To set up the floppy disk drives A: and B:”

To make the CD–ROM drive available to SoftWindows

See Chapter 4, “Setting up the CD-ROM”.

Troubleshooting

Licensing problems (FLEXlm)

If you get a licensing error when starting SoftWindows, you should proceed as follows on the license server:

  1. Check that the lmgrd daemon is running by typing:

    ps -efl | grep lmgrd
    

    If necessary, refer to “To start FLEXlm manual.”

  2. Check the data in the license.dat file.

Does the SERVER line point to the license server? Is there a DAEMON line pointing to the insignia daemon? If not, either edit the file or re-run SoftWindows as root on the licensing server, and choose Licensing from the Actions menu. See “Licensing SoftWindows,” for more information.

Bad or missing fonts

This error occurs whenever SoftWindows detects that none of the fonts required are available from the X server, and the fonts installed in the SoftWindows installation are not usable by the X server. To resolve this problem you need to compile the SoftWindows fonts for your particular X terminal with commands such as:

xset +fp $SWIN2HOME/fonts/SGI
xset fp rehash 

where $SWIN2HOME is the SoftWindows installation directory.

To make the change permanent, include these commands in the.xinitrc file in each user's home directory. If the “.xinitrc” files does not already exist, create it and insert these commands.