Chapter 9. Troubleshooting

This chapter contains three sections: commonly asked questions about using SoftWindows, suggested solutions to problems that you may encounter when running PC applications on your workstation with SoftWindows, and lastly, details of the SoftWindows and MS-DOS error messages with explanations and suggested solutions.

Common questions

The following sections contain answers to the most commonly asked questions about using SoftWindows.

Using floppy disks

How do I format a floppy disk?

Use the FORMAT command at the C:\> prompt. See Chapter 7, “FORMAT”.

Using hard disks

How do I create a new hard disk?

Use the New Drive… function on the Disk Drives… cascade menu on the Options menu; refer to Chapter 4, "Setting up hard disk files" in the SoftWindows for Unix Administrator's Guide.

How do I make a hard disk file larger?

Create a new hard disk file, and then copy the contents of the old file to the new file; referto Chapter 4, "Setting up hard disk files" in the SoftWindows for Unix Administrator's Guide.

How do I share hard disks?

Make the hard disk read-only; more than one user can then read data from it. To do this, enter the following command in a Unix terminal window:

chmod 444 filename.hdf 

where filename.hdf is the name of the hard disk file.

It may be useful to use the RO_DISK_PANEL_DISABLE configuration option; for more information refer to Chapter 7, "RO_DISK_PANEL_DISABLE" in the SoftWindows for Unix Administrator's Guide.

Can I use hard disk files from other versions of SoftWindows or SoftPC?

You can use the hard disk file from other versions of SoftWindows as D:, but do not use them as drive C: because the version of Windows and the configuration files are not compatible. For information on upgrading your old SoftWindows hard disks, refer to Chapter 5, "Upgrading a version 1 hard disk file" in the SoftWindows for Unix Administrator's Guide.

Using CD–ROM

How do I set up a CD–ROM drive?

Refer to Chapter 4, "Setting up the CD-ROM" in the SoftWindows for Unix Administrator's Guide.

How do I read an MS–DOS CD–ROM?

Refer to Chapter 4, “Using CD-ROMs”.

Using memory

How do I change the memory setting for PC applications?

Use the Memory dialog box; refer to Chapter 4, "Setting up memory" in the SoftWindows for Unix Administrator's Guide.

Using keyboards

How do I set up a foreign keyboard in MS-DOS?

Use the MS-DOS KEYB command; refer to Chapter 4, "Setting up keyboards" in the SoftWindows for Unix Administrator's Guide.

How do I set up a foreign keyboard in Windows?

Use the Windows International control panel; refer to Chapter 4, "Setting up keyboards" in the SoftWindows for Unix Administrator's Guide.

Using the screen

How do I change the size of the SoftWindows screen?

Drag the sides or corners of the screen. See Chapter 4, “To resize the SoftWindows window”.

Using printers

How do I set up the COM and LPT ports?

Refer to Chapter 5, “Printing, input, and output”.

How can I print from an MS-DOS application?

Refer to Chapter 5, “Printing from MS-DOS applications”.

How do I set up a printer for Windows?

Use the Windows Printers control panel; refer to Chapter 5, “Printing from Windows applications”.

Using serial devices

How do I use the serial ports with PC applications?

Refer to Chapter 5, “To use serial input and output”.

Converting between

How do I convert text documents between DOS and Unix?

If the documents are on a SoftWindows hard disk file, you can use the MS–DOS utilities DOS2UNIX and UNIX2DOS; refer to Chapter 7, “DOS2UNIX”, or Chapter 7, “UNIX2DOS”.

If they are in the Unix file system, you can use the Unix utilities "dostounix" and "unixtodos" supplied in the $SWIN2HOME/bin directory. See Chapter 11, "Unix utilities in the SoftWindows for Unix Administrator's Guide.

How can I copy and paste between PC and X Windows applications?

Use the SoftWindows copy and paste facilities; refer to Chapter 4, “Copying and pasting between MS-DOS and Unix”.

Setting Unix file access

What are Unix file access permissions?

File access permissions are used to tell a computer system who has access to files and directories. Files and directories have a set of permissions to determine which users can read, write, and execute the contents of a file. If a system is shared or is part of a network, other people may need access to its files and directories.

By setting file access permissions you control who is able to read, write, and use your files and directories.

There are four types of permissions for files and directories:

Table 9-1. Permissions for Files and Directories

Permission

Symbol

What it means

Read

r

Allows users to view or copy a file, or list files in a directory.

Write

w

Allows users to create, edit, and delete a file. For a directory, the write permission allows users to create or delete files only.

Execute

x

Allows users to run an executable file, such as a program or application, and search a directory.

SUID

s

Runs a Unix executable as its owner, rather than as the user who launched it. SoftWindows uses this to gain access to network devices normally unavailable to the user.

Any of the permissions can be assigned to three categories of users:

Table 9-2. Users and Symbols for Permissions

User

Symbol

What it means

Owner

u

The creator of the file (or directory)

Group

g

The other users in the owners group

Others

o

All other users


How do I check Unix file access permissions?

You can check file access permissions using the Unix ls -l command.

In a Unix terminal window, move to the directory containing the file by typing the command:

cd pathname 

Then type:

ls -l filename 

The output will be of the form:

-rwxrwxrwx 1 root 512 jun 9 09:35 filename

where the file access permissions are represented by the letters rwxrwxrwx; r is for read, w write, and x execute. The three sets are for the Owner, Group, and Others, respectively.

How do I change Unix file access permissions?

You can change file access permissions using the Unix "chmod" command.

To change the permissions you need to be logged in as the owner or root. If necessary, ask your system administrator to do this. Then issue the chmod command with an appropriate parameter.

The parameter consists of u (owner), g (group), or o (other), followed by + or - to add or remove permissions, respectively, followed by the type of access: r (read), w (write), or x (execute).

For example, to make a file so that the Owner can read it or write to it, and the Group can write to it, give the command:

chmod u+w+r g+w filename 

For more information on file access permissions consult your Unix reference manuals.

Using Configuration

Where is my SoftWindows configuration stored?

In the .swin2config file in your home directory; refer to Chapter 7, "SoftWindows configuration file" in the SoftWindows for Unix Administrator's Guide.

What determines the configuration of MS-DOS?

The MS-DOS files AUTOEXEC.BAT and CONFIG.SYS; refer to MS-DOS configuration, in the SoftWindows for Unix Administrator's Guide.

Running PC

How do I install PC software with SoftWindows?

Refer to Chapter 7, “Installing MS-DOS applications”.

How do I give MS-DOS commands?

Type them at the C:\> prompt; refer to Chapter 7, “Using MS–DOS commands”.

How can I edit MS-DOS files?

Use the MS-DOS editor, EDIT; refer to Chapter 7, “Using the MS–DOS editor”. In Windows you can use the Windows Notepad text editor.

Using Windows

How do I install new Windows fonts?

Refer to Chapter 6, “To add fonts”.

What Windows drivers does SoftWindows use?

When you run Windows in a window you are not using one of the emulated display drivers (SVGA or Hercules), and the title bar changes to SoftWindows Desktop to indicate that you are using the SoftWindows Windows display and mouse drivers. These are called SoftWindows Display and SoftWindows Mouse.

Common problems

The following sections contain solutions to the most frequently encountered problems when using SoftWindows.

Using the mouse

The workstation mouse pointer has disappeared

While the mouse is attached for use by MS–DOS applications it is not available to Unix programs. To detach it refer to Chapter 4, “Using the mouse in MS-DOS”.

Using printers

Printing is not working properly

If you are using the print spooler, flush the port to ensure that all the data has been sent. Disable autoflush and flush the port manually. See Chapter 5, “To flush output manually”.

Redirect print output to a file, then print the file outside SoftWindows; refer to Chapter 5, “Redirecting to a file and piping to a process”.

Using FSA drives

I get an error message when I try to use an MS-DOS file on an FSA drive

Because MS-DOS was not designed to handle file ownership and permissions like the Unix system, MS-DOS uses an assortment of standard file error messages to indicate that you do not have permission to read, write to, or execute a given file or directory.

The following messages may indicate that you do not have access to a particular file or directory due to the file permissions:

File creation error
File not found
Invalid directory
Invalid path (or file not found)

If one of these messages appears in MS-DOS and you are certain that the file or directory exists, you should check the permissions and ownership using Unix.

Also note that an SUID bit with incorrect ownership will cause permission problems on FSA drives.

Alternatively, copy the files to the hard disk C: or D: and try again.

Using networking

Problems experienced with SoftNode generally tend to be one of two types—problems with the ODI driver loading or configuring itself, or problems with networking applications after the software has been loaded.

ODI driver problems

If the driver completely fails to load, it will display a message which says:

Could not find a host network card

This means that SoftNode has been unable to make contact with the networking facilities on the host machine. This is normally due to one of two things:

  • SoftWindows has lost its SUID bit. The SoftWindows executable $SWIN2HOME/bin/swin needs to be installed by root, and should be owner root, mode 4755.

  • The network package which SoftWindows requires is not installed on the host workstation. For more information about which software package must be installed on each system refer to SoftWindows network devices in the SoftWindows for Unix Administrator's Guide.

If you are not sure whether these packages are installed on your system, contact your system administrator.

If the driver loads but reports an error registering one or more of the protocols specified in the NET.CFG file, then SoftNode probably does not support the appropriate frame type or protocol on that version of SoftWindows.

Network software errors

If the ODI system loads successfully but the network software package you wish to use does not function properly, then it may be that either SoftNode or the package has been configured incorrectly. Please refer to Chapter 9, "Networking with SoftWindows" in the SoftWindows for Unix Administrator's Guide for additional troubleshooting information.

The ETHER/TOKEN commands do not work

If the following message appears:

Bad command or file name

the batch file ETHER.BAT or TOKEN.BAT could not be found. These files are located in the C:\NOVELL directory, and you can amend the MS–DOS PATH variable to include this directory if required.

Unable to access network drivers

Edit CONFIG.SYS and check for an entry of the form:

LASTDRIVE=Z

The NetWare 3.11 client uses drives after the value of LASTDRIVE in the CONFIG.SYS file. By default, LASTDRIVE is set to K. The Netware 3.12 and NetWare 4 client, and LAN Manager, require LASTDRIVE to be set to Z.

Running PC applications

No display is visible in the SoftWindows window

An MS-DOS application may have been started with the wrong video mode. Change the display type; refer to Chapter 4, "Setting up the display" in the SoftWindows for Unix Administrator's Guide.

Application fails to run at all or locks up SoftWindows

The application may be copy protected and installed on an FSA drive. Reinstall on the C: or D: drives.

Alternatively, the application may require additional memory; refer to Chapter 4, "Setting up memory" in the SoftWindows for Unix Administrator's Guide.

Using Windows

Windows will not run

Windows needs a minimum of 2 Mbyte of memory to run, and 4 Mbyte is recommended. Check that this has been set correctly; refer to Chapter 4, "Setting up memory" in the SoftWindows for Unix Administrator's Guide.

Windows will not run with a read-only C: drive

Temporarily make it readable and writable. Then in your AUTOEXEC.BAT file change the line

SET TEMP=C:\DOS

to specify a writable disk. For example:

SET TEMP=H:

I cannot load extra Windows drivers from G:

To load extra Windows drivers, set up an FSA drive (not drive G: as this is required for Windows to run) as $SWIN2HOME/winsetup. This must be done before Windows is started. When you are prompted for the disk or directory from which to load a driver, enter the appropriate drive letter and path, such as I:\.

Alternatively, assuming you have set drive I: to be $SWIN2HOME/winsetup, before running Windows type:

ASSIGN A=I 

Error message when running Windows

If you get one of the following error messages when trying to run Windows:

cannot find files needed to run either standard or 386 enhanced mode; check to ensure the path is correct or reinstall Windows.
Invalid drive to search path

you have tried to connect to a network that maps a G: drive over the current SoftWindows G: drive, and the Windows system files cannot be found.

To solve this problem, map the Windows files to a different drive as follows:

  1. Determine an unused drive letter to be used for the Windows system files; for example the W: drive.

  2. Edit your $HOME/.swin2config file and make the following changes:

    • Replace the line:

      DRIVE_G_FSA_DIRECTORY $SWIN2HOME/windows 
      

      with:

      DRIVE_G_FSA_DIRECTORY
      

    • Replace the line:

      DRIVE_W_FSA_DIRECTORY
      

      with:

      DRIVE_W_FSA_DIRECTORY $SWIN2HOME/windows
      

  3. Edit the AUTOEXEC.BAT file on your C: drive and change the PATH line, replacing the G: drive with the W: drive, so that it reads:

    PATH C:\WINDOWS;W:\;C:\DOS;C:\INSIGNIA
    

  4. Finally, restart SoftWindows to make the changes take effect.

MS-DOS errors

These errors appear in the SoftWindows window:

Table 9-3. Errors Appearing in the SoftWindows Window

Error

Explanation

Suggestion

Not ready error reading drive A/B Abort, Retry, Fail

Your floppy disk drive is not attached to SoftWindows, or the specified drive is set to Empty in the Open Disk Drives dialog box, or there is no disk in the drive.

Attach or select the floppy disk drive, or insert a disk and retry the command.

Invalid drive specification

If you are trying to access drive D:, there is no SoftWindows hard disk file selected as drive D:.

Select a file as drive D:

 

If you are trying to access an FSA drive, the software needed to access FSA drives is not set up correctly.

Check that CONFIG.SYS and AUTOEXEC.BAT are set up correctly

Non-System disk or disk error

SoftWindows is attempting to boot from an MS-DOS floppy disk in drive A: which has not been initialized as a startup disk.

Eject the floppy disk from drive A:


SoftWindows FSA errors

These errors appear in the SoftWindows window and relate to the use of FSA drives

Table 9-4. FSA-Related Errors in the SoftWindows Window

Error

Explanation

Suggestion

The host filesystem directory cannot be found

The FSA directory cannot be found.

 

Verify that the Unix directory has not been renamed, moved, or deleted.

 

The host filesystem name must be a directory

An FSA drive has been given the name of a Unix file.

Only Unix directories can be specified for FSA drives.

 

The host filesystem must have read access

The FSA directory cannot be read.

Change the Unix directory's access permissions.

The x drive is not being used

You are trying to detach a drive with NET USE /D which is not attached.

Check the NET USE command argument for drives currently attached.

The x drive is not a network drive

You are trying to attach a non-network drive which is already in use, for example, drive C:, with a NET USE command.

Retry the NET USE command with the correct drive id.

The x drive is already in use

You are trying to attach a network drive (id of E onwards) with a NET USE command, but the drive is already in use.

Retry the NET USE command with the correct drive id.

Illegal drive specification

The drive letter specified in an FSADRIVE or NET USE command is not valid.

Check that it is a single letter followed by a colon, in the range E to LASTDRIVE.


SoftWindows errors

Errors reported by SoftWindows are numbered, and appear in an error dialog box.

For details of these errors, refer to Chapter 12, "Error messages" in the SoftWindows for Unix Administrator's Guide.

Networking errors

By default, networking errors are not displayed in an error dialog box.

Please refer to Chapter 9, "Troubleshooting" in the SoftWindows for Unix Administrator's Guide for details of how to enable network error reporting.