Chapter 3. Installation
Prev |  | Next

## 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:

    portnumber@servername

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 744@myserve R

For a Bourne or Korn shell:

    LM_LICENSE_FILE=744@myserve 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.

Prev | Table of Contents | Next
Chapter 2. Installation requirements |  | Chapter 4. Setting up SoftWindows