Installing and setting up FirstClass Server on Mac OS X
Installing FirstClass server and Internet Services
You can install the FirstClass server and Internet Services on separate machines, or on the same machine, with either a single processor or multiple processors. The minimum requirements for each install are listed below, but the actual performance of your system will vary depending on how powerful your hardware is and how busy your system gets.
If you install the FirstClass server and Internet Services on two machines, we generally suggest using the machine with the more powerful processor to run Internet Services, though that depends to a large extent on how you use your system. If, for example, your system will be used primarily as a web server, you will want Internet Services on the more powerful machine. If, on the other hand, your server will be under a heavy load of FirstClass users, then you will want the server to be on the machine with the better disk system.
Before installing FirstClass
Before you can install FirstClass you must create a user named “fcadmin” and log into the operating system as this user. Create the fcadmin user as follows:
1 Choose Apple menu > System Preferences > Accounts.
2 Click New User to open the New User form.
3 Type a long name and short name for the user.
The long name you choose doesn’t matter, but we recommend (and this documentation will assume) the long name FirstClass Administrator.
The short name must be fcadmin.
 CautionIf you don’t give the user exactly this short name, you won’t be able to install FirstClass.
4 Type a password for the user.
You will be asked for this password to install FirstClass and to perform other administrative duties.
6 Select “Allow user to administer this computer”.
Caution
If you don’t do this you won’t have administrative level permissions and won’t be able to install FirstClass.
7 Log out of the current user account and log back in as fcadmin.
Installing FirstClass
During the installation you will be asked whether you want to install the FirstClass server and whether you want to install Internet Services. To install both on the same machine, accept the default [yes] in both cases. To install the FirstClass server and Internet Services on separate machines, repeat the installation process on both machines, selecting only the component you want to install.
The installer will attempt to determine appropriate default settings for the System Profile and Internet configuration forms to allow the FirstClass server and Internet Services to “just work”. The installer will ask you to confirm these defaults during the installation. After installation, you should review these forms and verify that they do not need to be changed.
The installer will also ask you whether you want the server and Internet Services to autostart on a machine restart. By default, these programs will be running in the background after a reboot even if no user is logged into Mac OS X yet.
 NoteYou can also disable the server or Internet Services "autostarts" manually after installation by removing the FirstClass Server and/or FirstClass Internet Services folders from StartupItems in the /Library folder.
Install FirstClass as follows:
1 Double-click “Install FirstClass Server.command” to start the installer script.
2 Follow the prompts.
In many cases, you need only hit <Enter> to confirm the default responses.
3 Restart the Mac OS X machine at the end of the installation process, if you chose to autostart either the server, or Internet Services, or manually start the server and Internet Services from the Desktop icons created by the installer.
Note
If existing HTTP or FTP services are enabled on the Internet Services machine, Internet Services will fail to open the reserved IP ports. To disable the conflicting services, choose Apple menu > System Preferences > Sharing and clear these services.
Starting your server and logging in
In order to do any system administration, whether from the server, or from the client, the server must be running. Most administrative functions you perform will be done when you are logged into the client as the administrator.
Starting your server
By default, the Mac OS X installer configures the server and Internet Services to autostart on system restart. These programs will run in the background after a reboot even if no user is logged in. You can also start the server manually.
The FirstClass server application resides in the /Library folder in a FirstClass folder and is called fcsd (FirstClass server daemon). You can start fcsd directly but we suggest you use the FirstClass Server Start alias on the Mac OS X desktop. There are aliases on the desktop for all of the following:
FirstClass Server Start 
FirstClass Server Stop 
Internet Services Start 
Internet Services Stop 
Status of FirstClass Services 
You can also start, stop and check the execution status of the server and Internet Services manually with the shell scripts (provided) as follows:
1 Choose Go > Applications.
2 Double-click the Terminal application in the Utilities folder.
3 Type one of the commands below and press Enter.
4 If prompted for a password,
Enter the fcadmin user’s password.
Possible commands:
• fcsctl start starts the server
• fcsctl stop stops the server
• fcsctl status checks server status
• fcisctl start starts Internet Services
• fcisctl stop stops Internet Services
• fcisctl status checks Internet Services status.
Note
Only the root user or machine administrators can start or stop the server or Internet Services. No matter who launches these programs, they will start up under the root user and admin group and will then fall back to the real context of the user who launched them, switching back to root-equivalent access only while opening reserved IP ports. Currently, only one user, fcadmin, is supported, so manually start the server and Internet Services only from this account.
Logging in as administrator
The FirstClass installation application adds a special user account for the administrator:
• the user ID is admin
• the password is admin
• the name is Administrator.
Caution
To preserve the security of your system, you should change the password for the administrator account as soon as you log in by choosing Collaborate > Change Password. Keep the new password confidential. We recommend that you not save the password in your settings file.
 WarningYou can change the name, password, and user ID associated with the administrator account, but never delete this account. If you do, you won’t be able to log in as the administrator, and you will have to re-install your server. We suggest the administrator use a personal account for non-administrator tasks.
While you can log into the administrator account using a web-based client, you must use a FirstClass client to perform all administrative tasks.
Registering your server and licenses
When you log in as administrator for the first time, the online registration form will be on the administrator’s Desktop. Click on it to open it.
You must complete and send this form to Open Text to get access to online software and documentation updates and to be allowed to post support questions to our customer conferences. You can either email the completed preaddressed form or print the form and mail it to one of the addresses indicated in the message body.
You do not have to complete all the fields on the form and some will already be filled in for you. The help text on the form explains which fields are optional. A copy of this form will be left on your Desktop for your future reference.
Once FirstClass receives your registration, you will be sent information on accessing our online system and given access to customer conferences.
Configuring the System Profile
Once you have installed your server and logged in as admin, configure the System Profile. Many of the fields on this form will be already populated with information you filled out during the install process.
To open the System Profile, choose Admin > System Profile.
To access help for this form, press F1 with the form open.
The FirstClass Server folder
The FirstClass server and Internet Services files are stored in a FirstClass Server folder within the /Library folder. Before logging into your FirstClass system and beginning to use it, you may want to familiarize yourself with the contents of the FirstClass Server folder.
The FirstClass Server folder contains the server application and all supporting files. If you installed Internet Services on the same machine as the FirstClass server, the Internet Services files will also be in the folder. Otherwise, they will be in the corresponding FirstClass Server folder on the Internet Services machine.
This folder contains the following folders and files:
• fcsd
The FirstClass core server executable.
• fcsd.rez
The FirstClass server resources.
• fcslang.rez
The FirstClass language resource file.
• FirstClass Server Start.command/FirstClass Server Stop.command
Commands that activate control scripts to start and stop the FirstClass server.
• .log/.old files
Log files that are generated every time you start the server or Internet Services. The .log files contain detailed log entries from the latest run, and the .old files contain the output of the previous run. Because these files recycle every time you start the server, you lose the information after two restarts. Similar information is stored permanently, though, in the server logs under /Library/FirstClass Server/Volumes/Master/fcns/logfiles.
Note
If you have had previous experience with FirstClass on a Windows or classic Mac OS, you will be used to seeing the information that is recorded in these log files in the server console of FirstClass.
• Status of FirstClass Services.command
A command file that activates a control script that provides you with the status of the FirstClass server and Internet Services.
• Volumes
A folder in which you can define an explicit list of logical FirstClass volumes accessible to the server. These need not correspond directly to physical drives, but could also be folders or symbolic links to any location visible in the Mac OS X file system hierarchy. For this reason, they are referred to as logical volumes. For more information about FirstClass logical volumes and their uses, see Using FirstClass volumes in the Administrating FirstClass chapter of this guide.
• fcfixvol
A utility you use to properly set the initial permissions on the files and folders in a FirstClass post office after you copy the post office from one volume to another or restore from a backup. For the purpose of migration, this includes another utility (fclower.pl) that converts all post office file names to lowercase for use in the Mac OS X file system.
Internet Services folders and files
The following folders and files are also in the FirstClass Server folder if you installed Internet Services on this machine:
• fcisd
The FirstClass Internet Services executable.
• fcisd.rez
The Internet Services resources.
• fcp
A folder containing FCP network protocol definition files. FCP is the protocol used to communicate between the FirstClass client or services modules and the FirstClass server.
• config
A folder containing configuration files for Internet Services.
• inetsvcs.fc
The settings file for Internet Services. This is preconfigured for 127.0.0.1 by default for systems with the FirstClass server and Internet Services on a single machine. If the FirstClass server and Internet Services are on two separate machines, this must be updated with the server’s IP address or name. See Configuring the inetsvcs.fc file for more information.
• Internet Services Start.command/Internet Services Stop.command.
Commands that activate control scripts to start and stop Internet Services.
FirstClass file locations on Mac OS X
It is recommended that you review and understand the ownership, nature, and location of the FirstClass files and folders (directories) on Mac OS X. While familiarizing yourself with the FirstClass server for OS X, you may find it convenient to print this information and post it next to the server computer for reference.
fcadmin is the OS X user who executes and manages the FirstClass server and Internet Services. The fcadmin user belongs to the OS X admin group and owns all of the files.
The FirstClass server (named fcsd) runs as a full-fledged UNIX daemon (service), while Internet Services (fcisd) executes in the background as an application. Both are launched in the background automatically at operating system startup time, if you selected that option during installation, and neither requires a user login.
Several root directories (those that start with “/”) are hidden from the Finder. You must use the Finder’s Go > Go to menu command, or Command+Shift+G, or the Terminal utility, to see folders such as /usr and /Volumes.
Locations:
/Library/FirstClass Server/
all executable-related files for both fcsd and fcisd
/Library/FirstClass Server/fcfixvol
a FirstClass fcpo utility to set file permissions and ownership and to convert file names to lowercase. May be executed at any time.
/Library/FirstClass Server/fcisd.log
/Library/FirstClass Server/fcisd.old
current and prior Internet Services logs since launch, if IS installed on the computer
/Library/FirstClass Server/fcp
the fcp files that inetsvcs.fc uses to establish a connection to the server
/Library/FirstClass Server/fcsd.log
/Library/FirstClass Server/fcsd.old
current and prior server logs since launch. Equivalent to legacy console to log.
/Library/FirstClass Server/inetsvcs.fc
Internet Services settings file, if IS installed on the computer
/Library/FirstClass Server/Volumes/Master/fcns
the master logical volume
/Library/FirstClass Server/Volumes/.../fcns
a secondary logical volume if present
/Library/FirstClass Server/Volumes/.../ fcns8001
the mirror logical volume if present
Any or all entries under /Library/FirstClass Server/Volumes/ may be links to other directories or volumes, but the actual fcpo folders, and the folders underneath fcpo, cannot be symbolic links.
Note
Ensure fcfixvol utility is run at least once on all logical FirstClass volumes before the server is launched.
/Library/StartupItems/FirstClass Internet Services
installed if IS auto launch selected during installation. This folder can be deleted to stop Internet Services from being auto-started at system startup time.
/Library/StartupItems/FirstClass Server
installed if server auto launch selected during installation. This folder can be deleted to stop the core server from being auto started at system startup time.
Library/FirstClass Server/Stats
If desired, you must manually create this folder, as described in Collecting activity statistics in the Administrating FirstClass chapter of this guide.The above is the recommended path for this folder. It is not created by default.
/usr/sbin/fcsctl
/usr/sbin/fcisctl
the server and Internet Services control scripts used from a Terminal shell, by the desktop icons, and by the StartupItems scripts. These are not normally visible from the Finder desktop. Choose Go > Go to Folder (Command+Shift+G) and enter /usr/sbin to see these files.
Note
This folder also includes many OS X system files that should not be modified or deleted.
/Volumes
lists all available OS X desktop-mounted volumes. Do not confuse /Volumes with /Library/FirstClass Server/Volumes.
| 
