TQ Server on Apple MAC

A machine which is to act as the server for Typequick application should have the TQ Server application installed on it.

When the machine is a Mac, it should be running OS X 10.2 or OS X Server 10.2, or higher.

To simplify administration of the Typequick server, TQ Server should be run as a service on the Mac. This way TQ Server is started and stopped automatically when the machine is turned on and off.

In order to get the security settings correct for TQ Server on the Mac, you should install just the Typequick resources component first using an Administrator account, and then do a second install from the CD of the TQ Server component using the super-user account.

Note If a standalone install is done, TQ Server is installed as a normal application, not as a service, so the entire installation is done under a normal administrator account. Similarly, when installing just the client component on a workstation, a normal administrator account can be used.

The following topics provide additional detail on issues that might arise before or after the installation:

Installing as the super-user

The installation process installs TQ Server as a service which will automatically be started when the machine is booted. To successfully install TQ Server however, it is essential that the person running the install program is logged in as super-user (root), as some of the files being altered can only be altered by the super-user. If you do not know how to log in as the super-user, please follow these steps:

1. Log on as an Administrator and go to /Applications/Utilities and run the NetInfo Manager.
2. Click on the lock symbol at the bottom of the window that appears and respond to the password challenge.
3. Use the menu bar at the top of the screen to access Domain->Security->Authenticate then Domain->Security->Enable Root User. If the root user is already enabled you will see a menu entry to disable it. In this case you should just escape from the menu. If you need to set the password for root (because you don't know what it is), you should choose the appropriate menu entry and make the change.
4. Ensure that you can type into the login window by going to the Apple menu then choosing "System Preferences...". Then choose "Login" in the Personal section. This will show a window with two tabs. Choose the "Login Window" tab. Finally, ensure that the "Name and password entry fields" radio button is selected for the "Display login window as: " section.
5. You should now be able to log out and log in as "root" with the password you set in step 3.

Change Details

This section indicates the areas of the machine's hard drive that are changed as a result of installing the TQ Server component.

To install TQ Server as a service, the installation process creates a folder called TQServer in /System/Library/StartupItems.    

This folder (and its sub-folders) contain the information required for OS X to recognise TQ Server as a service.

In addition, a startup script (TQServerCtlMacOSX) is placed in /usr/sbin to invoke the real startup scripts.

Finally, a line is added to the file /etc/hostconfig to alert OS X to the presence of the service. Unfortunately the uninstall process can miss this line and leave it in the hostconfig file, so the file should be manually checked for a reference to TQServer and the line removed if present after an uninstall.