 |
Help Document |
|
 |
|
The FirstClass Post Office
The FirstClass Post Office is located in the FCPO (Windows) or FirstClass Post Office (Mac OS) folder.
Warning
It is vital that you maintain the integrity of your post office. Do not:
• rename it
• move it to a different volume unless you also move the FCServer or FirstClass Server folder to the same volume
• move it from the root of the volume on which it is located
• change, delete, or move anything other than the log files, statistics files, NETINFO file, modem definition (MDM) files, database extension files, or connection scripts
• add files or folders to any folders in the FCPO or FirstClass Post Office folder
• merge multiple FCPO or FirstClass Post Office folders into a single folder.
If you make unauthorized changes to the post office, the Server may not start, or it may damage data files. To start the Server, reverse the changes.
If you add, change or delete files in the post office, it might be damaged. If this happens, restore or reinstall your Server.
The FCPO/FirstClass Post Office folder
The FCPO (Windows) or FirstClass Post Office (Mac OS) folder contains the FirstClass post office.
Many of the files and folders in this folder are used only by the server. There are a few that you might need to look at:
• LOGFILES (Windows) or LogFiles (Mac OS) - contains the server's log files
• SERVER (Windows) or Server (Mac OS)
The SERVER (Windows) or Server (Mac OS) folder contains support files for the server as well as the following folders:
• DBEXT
Contains any database extension Dynamic Link Libraries (DLLs) installed on the server for Windows. When you first install your server, this folder is empty.
• MODEMS (Windows) or Modems (Mac OS)
Contains the modem definition (MDM) files. In addition, there is an Other Modems folder (Mac OS only) that contains additional MDM files.
• PORTS (Windows) or Ports (Mac OS)
Contains the session configuration files for the modem ports on the server.
• SCRIPTS (Windows) or Scripts (Mac OS)
Contains the connection script files.
• STATS.DIR (Windows) or Stats.Dir (Mac OS) - contains the statistics files
• NETINFO file
The NETINFO file allows you to configure IPX, AppleTalk, and TCP/IP connections. The file is located in the FCPO/SERVER (Windows) or FirstClass Post Office/Server (Mac OS) folder. You can use NotePad, SimpleText, or any text editor to view and edit it.
The NETINFO file can contain the parameters described below. Parameters must be in upper case, with spaces before and after the equal signs.
IPX
Purpose
Disables or enables the IPX protocol.
Syntax
IPX = n
where n can be either zero (to disable the protocol) or 1 (to enable it)
Default
IPX = 1
IPXAUTO (Mac OS only)
Purpose
Disables or enables automatic frame detection.
Syntax
IPXAUTO = n
where n can be either zero (to disable the automatic frame detection) or 1 (to enable it).
Default
IPXAUTO = 1
Notes
If automatic frame detection is enabled, when the server receives a packet with a given frame type, it automatically begins broadcasting packets of that type. You can disable this feature, explicitly specifying the frame types to be broadcast by the server.
If you turn off automatic frame detection, you must supply one or more of the explicit frame parameters (IPXNET8022, IPXNETENII, IPXNET8023, or IPXNETSNAP), and you must specify the network number with the IPXNETWORK parameter.
The IPXNETWORK parameter is used for any frame types that are not explicitly defined with one of these parameters.
If you are running Netware 4.x on the same network as your server, you may want to turn off IPXAUTO. Otherwise, you may receive warning messages at frequent intervals from the Netware router claiming that FirstClass is changing its network address.
IPXNET8022 (Mac OS only)
Purpose
Specifies the network number for packets with the 802.2 frame type.
Syntax
IPXNET8022 = n
where n is the network number
Default
The value specified for IPXNETWORK, as in this example:
IPXNET8022 = FC000001
Notes
The value can be any hex address.
IPXNET8023 (Mac OS only)
Purpose
Specifies the network number for packets with the 802.3 frame type.
Syntax
IPXNET8023 = n
where n is the network number
Default
The value specified for IPXNETWORK, as in this example:
IPXNET8023 = FC000002
IPXNETII (Mac OS only)
Purpose
Specifies the network number for packets with the Ethernet_II frame type.
Syntax
IPXNETII = n
where n is the network number
Default
The value specified for IPXNETWORK, as in this example:
IPXNETII = FC000003
IPXNETWORK (Mac OS only)
Purpose
Specifies the IPX network number for SAP packets, in hexadecimal notation.
Syntax
IPXNETWORK = n
where n is the network number. Specify zero for "this network". Most routers will translate zero to the appropriate number when routing packets to another network.
Default
IPXNETWORK = 0
IPXNETSNAP (Mac OS only)
Purpose
Specifies the network number for packets with the Ethernet_SNAP frame type.
Syntax
IPXNETSNAP = n
where n is the network number
Default
The value specified for IPXNETWORK, as in this example:
IPXNETSNAP = FC000004
TCPGUIPORT
Purpose
Sets the port number of the main port that accepts connections from users of the FirstClass client software for Mac OS and Windows who are connecting with TCP/IP.
Syntax
TCPGUIPORT = n
where n is the port number
Default
TCPGUIPORT = 510
This is the standard FCP port, and is the recommended value. If you don't specify a TCPGUIPORT, 510 is used.
Notes
Connections through this port do not use the error correction component of the FirstClass protocol (FCP), because the TCP/IP protocol handles error correction.
The TCPGUIPORT accepts connections over network and remote sessions.
The number of network sessions the port can support is determined by the number of network sessions you configure on your server.
The number of remote sessions the port can support is determined by the number of surplus remote sessions in the server. The server comes with two remote sessions. You can purchase additional remote sessions.
Users of terminal emulators can connect to this port by pressing Enter/Return twice.
Users who autoregister on any port other than the TCPGUIPORT, TCPRGUIPORT, or UDPPORT are defined as regular users.
TCPGUIPORT2
Purpose
Creates an optional, additional port for users of the FirstClass client software for Mac OS and Windows who are connecting with TCP/IP.
Syntax
TCPGUIPORT2 = n
where n is the port number
Example
TCPGUIPORT2 = 3000
This is the recommended value. There is no default value.
Notes
Connections through this port do not use the error correction component of the FirstClass protocol (FCP), because the TCP/IP protocol handles error correction.
This port accepts connections over network and remote sessions.
The number of network sessions the port can support is determined by the number of network sessions you configure on your server.
The number of remote sessions the port can support is determined by the number of surplus remote sessions in the server. The server comes with two remote sessions. You can purchase additional remote sessions.
Users of terminal emulators can connect to this port by pressing Enter/Return twice.
Users who autoregister on any port other than the TCPGUIPORT, TCPRGUIPORT, or UDPPORT are defined as regular users.
TCPCLUIPORT
Purpose
Sets the port number of the TCP/IP port that accepts connections from users connecting to the server with a terminal emulator or telnet client.
Syntax
TCPCLUIPORT = n
where n is the port number
Default
TCPCLUIPORT = 23
This is the recommended value. If you don't specify a TCPCLUIPORT, 23 is used.
Notes
This port does not accept connections from the FirstClass client software for Mac OS or Windows.
Connections to this port are immediate. Users do not need to start their sessions by pressing Enter/Return twice.
This port supports the telnet protocol and telnet negotiation.
This TCPCLUI port handles line terminators differently from the standard CLUI. Normally, only a CR is accepted as a line terminator in the CLUI. The TCPCLUI port, however, also accepts CRLF and CRLFNULL as acceptable line terminators. If you are using a terminal scripting program, it should pause at least 10 milliseconds (ms) after sending a line terminator.
If you are supporting older systems or clients (prior to 5.5), use port number 3003.
TCPRGUIPORT
Purpose
Creates an optional, remote TCPGUI port.
Syntax
TCPRGUIPORT = n
where n is the port number
Example
TCPRGUIPORT = 3004
This is the recommended value.
Notes
This port accepts native TCP/IP GUI connections, but command-line users can connect by pressing Enter/Return twice.
Users who autoregister on any port other than the TCPGUIPORT, TCPRGUIPORT, or UDPPORT are defined as regular users.
TCPFCPPORT
Purpose
Creates an optional port for use with a terminal server.
Syntax
TCPFCPPORT = n
where n is the port number
Example
TCPFCPPORT = 3002
This is the recommended value. There is no default value. If you don't specify a TCPFCPPORT, no TCPFCP port is created.
Notes
The terminal server has a TCP/IP connection to the server; therefore, this connection does not require error correction. The connection between the FirstClass client software and the terminal server, however, passes through a modem and over telephone lines. Therefore, it requires error correction. A TCPFCP port uses the FirstClass protocol (FCP) to guarantee the integrity of the information passing between the FirstClass client software and the TCP/IP terminal server.
This port accepts connections only from users connecting with a remote session. Thus the number of simultaneous TCP connections the server can support is limited by the number of surplus remote sessions on the server.
The TCPFCP port runs the full FCP error-correcting sliding window packet link on top of a TCP connection. It is intended for use with connections that are not TCP from end to end (for example, when clients dial into a terminal server connected to the FirstClass server through TCP/IP). For these types of connections, FCP does its own error correction.
The TCPFCP connection can also be used to handle users connecting with a Communications Toolbox TCP/IP tool such as the Outland TCP Tool.
If you are running a terminal server, you must configure it to automatically connect to the server on the TCPFCP port after it answers an incoming call.
Users who autoregister on port 3002 are defined as remote users.
UDPPORT
Purpose
Sets the port number that accepts connections from users of the FirstClass client software for Mac OS and Windows who are connecting with UDP/IP.
Syntax
UDPPORT = n
where n is the port number
Default
UDPPORT = 810
This is the standard FCP port for UDP, and is the recommended value. If you don't specify a UDPPORT, 810 is used.
Notes
Connections through this port use the flow control and error correction features of the FirstClass protocol (FCP), making this a more useful choice than TCP/IP for a slow network connection (such as a modem connection through an ISP).
The UDPPORT accepts connections over network and remote sessions.
The number of network sessions the port can support is determined by the number of network sessions you configure on your server.
The number of remote sessions the port can support is determined by the number of surplus remote sessions in the server. The server comes with two remote sessions. You can purchase additional remote sessions.
Users who autoregister on any port other than the TCPGUIPORT, TCPRGUIPORT, or UDPPORT are defined as regular users.
APPLETALK
Purpose
Disables or enables the AppleTalk protocol.
Syntax
APPLETALK = n
where n can be either zero (to disable the protocol) or 1 (to enable it)
Default
APPLETALK = 1
Mirroring your Post Office
To simplify your backup procedures and allow you to keep your server running during backups, you can mirror post office contents to the volume of your choice, then back up the mirror contents while your server continues to run normally.
You can only mirror volumes with a status of full use. Volumes which were previously full use but now have a status of limited use or browse only cannot be mirrored, even though they still may contain some post office data. For this reason, do not change the full use status of a mirrored volume unless it contains no current accounts or conferences. Additionally, mirroring to an AppleTalk-mounted volume is not recommended because calls to AppleTalk block and cause degraded FirstClass performance.
Make sure there is sufficient space on the mirror volume to hold the existing post office and any expected growth. If there is not sufficient space, you will receive a disk write error and the server will retry 10 times. If it still fails, you will receive a retries exceeded error. The folder will have the name FCPOnnnn (Windows) or FirstClass Post Office nnnn (Mac OS), where nnnn is the four-digit hexadecimal FirstClass ID of the source volume.
Notes
• If you encounter "Not enough memory to operate on file" displayed on the server console, it is a mirror error and indicates that more memory is required. To solve this, add physical RAM to the computer or change the "Preferred size" memory allocation.
• Additionally, mirroring to an AppleTalk-mounted volume is not recommended because calls to AppleTalk block and cause degraded FirstClass performance.
• Source files with resource forks that are mirrored lose the resource fork in the mirrored copy (for example, .SES files with .CTB resources).
What is mirrored
All the folders in your post office folder are mirrored with the following exceptions:
• FCPO\SERVER\DBEXT (Windows) or FirstClass Post Office:Server:DBEXT (Mac OS)
• FCPO\FCAS
• FCPO\FCRAD
• FCPO\NOMIRROR (Windows) or FirstClass Post Office:NOMIRROR (Mac OS)
• LogFiles folder
• Stats.Dir folder
• Internet Services files, such as en.fc and mimetype, which you may have modified.
Remember to back up the Internet Services files from the original volume.
Note
The first time you perform mirroring, all your post office files will be synchronized. On a large post office, this can be a lengthy task taking several hours. Therefore, it is best to set up a post office for mirroring for the first time when there is no user or trash collection activity.
To enable mirroring:
1 Double-click Volumes on your administrator Desktop.
2 Select the volume you want to mirror.
3 Choose File > Properties (Windows) or Get Info (Mac OS).
4 Fill in the fields on the Disk Mirroring tab.
5 Click OK.
The initial synchronization process begins. You can view synchronization progress on your server monitor's Volumes tab. The first stage in synchronization is building a list of files to copy. The second stage is copying those files. When complete, "Disk mirror status" is Synchronized and active.
Backing up mirrored content
If you have a post office spread across several volumes, you should back up all these volumes each time you perform a backup, to avoid breaking cross-volume links.
To back up a mirrored volume:
1 Choose Admin > Control > Pause Mirroring.
If you have a post office spread across several volumes, this will pause all activity on these volumes.
2 Use your backup software to copy the mirrored post office.
This post office has the name FCPOnnnn (Windows) or FirstClass Post Office nnnn (Mac OS), where nnnn is the four-digit hexadecimal FirstClass ID of the source volume.
3 Restart mirroring after the backup is complete by choosing Admin > Control > Continue Mirroring.
An incremental synchronization will be performed automatically.
Permanently stopping mirroring
If you want to replace your post office with a backup, or move your post office to a different machine, you need to permanently stop mirroring. Perform the following tasks on each mirrored volume:
1 Double-click Volumes on your administrator Desktop.
2 Select the volume you want to mirror.
3 Choose File > Properties (Windows) or Get Info (Mac OS).
4 Clear "Enable disk mirroring for this volume" on the Disk Mirroring tab.
5 Click OK.
You can check the Volumes tab of the server monitor to make sure the "Disk mirror status" for this volume is Not mirrored.
Mirroring tasks
You must perform the following tasks to use mirroring as part of your backup process:
1 Enable mirroring
This is a one-time task that must be performed for each volume with a post office on it. You will have to wait until the mirror has been completed (fully synchronized) before you can perform the rest of these tasks.
2 Back up mirrored content