2. Starting and Quitting MAE

• starting MAE

• quitting MAE

• troubleshooting MAE startup

Before you start MAE, make sure that you know which directory contains the mae program. If you installed MAE according to instructions presented in Chapter 1 of this guide, the mae program is in the apple/bin directory, which is in the location specified during installation.

IMPORTANT If you installed MAE while logged in as root, log in as an ordinary user to start MAE. Do not start MAE with superuser privileges.

To start MAE:

1. Open a terminal emulator window.

2. Enter the pathname of the mae program.

   For example, if mae is located in the apple/bin subdirectory of your home directory, and you are currently in your home directory, enter apple/bin/mae at the command prompt.

Using command line options

Some of the options available for the mae command

Using manual pages

• Append the full pathname of the apple/man1 directory to the MANPATH variable

  or

• use the man command as follows:
  man -M applemandirectory commandname

  Substitute the pathname of the apple/man1 directory for applemandirectory.

• Choose Shut Down from the Special menu on the MAE desktop.

  This command quits all open Macintosh applications, puts away all mounted Macintosh volumes (including CD-ROM discs and floppy disks), and closes the MAE window. MAE performs all housekeeping tasks necessary for a clean shutdown. The Shut Down command does not quit any X applications that may be running, not even those you started from the MAE desktop, and it does not shut down your workstation.

  Note: Do not quit MAE by using window manager capabilities available in your X environment. Use the Shut Down command, as described here.

MAE cannot open the apple directory

Unable to locate <apple_dir>
Please use the -appledir option to give the path to the apple directory.

This message appears if MAE can't locate the directory that contains the startup files for MAE.

You can specify the directory where the MAE files are located by using the option -appledir directory-path with the mae command, replacing directory-path with the name of the directory that contains the MAE files. See the mae manual page for more information.

If you cannot locate the MAE files, you may need to reinstall MAE. See Chapter 1 of this guide.

MAE cannot display in the X display

If you are running MAE on the same workstation that is running the X display server, set your DISPLAY environment variable to:

local:0

If you are running MAE on a different machine than the X display server, set your DISPLAY environment variable to the name of the machine on which the X display server is running and append the characters:

:0

For example, if you are running on a machine named my_machine, set the DISPLAY variable to the following:

my_machine:0

If MAE cannot connect to the X display server, run the xhost command on the X display server machine. For example, if MAE is running on a workstation named my_workstation and the X display server is on a machine named my_terminal, run the following command on my_terminal:

xhost +my_workstation

This command allows MAE on my_workstation to open a display on my_terminal.

On Solaris, the xhost command is located in /usr/openwin/bin. On
HP-UX, xhost is located in /usr/bin/x11.

Handling startup problems

• Install MAE as root, but log in as an ordinary user to start MAE.

  If you start MAE as root, MAE tries to build a System Folder in the root directory, which might not have enough free disk space. You must be able to create the System Folder directory in your home directory. In addition, if you start MAE as root, you increase the possibility of deleting important workstation files from within MAE.

• Be sure that you have plenty of available disk space (at least 5 MB) in your home file system.

  The Installer checks free space for the package installation, but in addition to the space needed to install, MAE uses more space by building a System Folder in your home directory when first launched. Therefore, there should be at least 5 MB available for it.

• Your home directory should be local to the machine in which the MAE process is running, that is, not connected through a remote mount point.

  The first time MAE starts, it scans the directories from the root directory to your home directory. If there are remote mount points in that path, the scan can cause delays or hangs at startup.

• Check UNIX permissions on your home directory and the files and directories within the apple directory. Permissions should not be a problem unless you made changes while logged in with superuser privileges.

• Check the RAM and available swap space of the workstation. MAE requires a minimum of 16 MB of RAM and 16 MB of swap space; 32 MB of RAM and 32 MB of swap space are recommended.

Problems with the License Binder

ERROR: WARNING: Could not get DISPLAY value. Using user name only for license lookup.

MAE is unable to determine the display server being used and therefore cannot check to see if the display server is authorized to run MAE. Try setting the -display option in the mae command line or set the environment variable DISPLAY and export it.

ERROR: WARNING: Could not get username value. Using display only for license lookup.

MAE is unable to determine the login name of the user and therefore cannot check to see if the user is authorized to run MAE.

ERROR: Cannot access MAE license directory - '<directory_name>'. Your system administrator must run the 'license_binder' program to enable MAE for you.

Investigate the following possibilities:

• The directory that should contain the License Binder data files either does not exist or is not readable.

• If you have not yet run the License Binder, you must do so before launching MAE.

• If you have previously run the License Binder, make sure the directory is readable and searchable (execute permission) and try launching MAE again.

• If the License Binder data files are not in the default location, set the environment variable MAE_LICENSES to the path of the directory where the data files are located.

Investigate the following possibilities:

• The directory that should contain the License Binder data files does not contain any data files.

• If you have not yet run the License Binder, you must do so before running MAE.

• If the License Binder data files are not in the default location, set the environment variable MAE_LICENSES to the path of the directory where the data files are located.

A file of unknown format has been detected in the License Binder data directory. It will be ignored.

ERROR: WARNING: Cannot open license control file - '<file_name>'.

A file in the License Binder data directory could not be opened for reading and will be ignored. Change the permissions to allow read access.

ERROR: WARNING: Skipping corrupted license control file - '<file_name>'.

A License Binder data file has been damaged. The file will be ignored. Remove the file and run the License Binder again. Attempts to modify a License Binder data file by hand often result in a corrupted data file.

For more information about error messages that may appear during startup, see the on-line Read Me file that comes with MAE (README.TXT).

Where to go from here

If you need to print a document in MAE, see Chapter 4 of this guide, "Printing in MAE."

To learn about some MAE-specific features, see Chapter 5 of the MAE User's Guide, "Using the Toolbar."

To use a CD-ROM disc or a floppy disk, see Chapter 6 of the MAE User's Guide, "Mounting CD-ROM Discs and Floppy Disks."