CommuniGate Pro Installation

Data Files
You should download the CommuniGate Pro software either from the Stalker Web/FTP site, or from any authorized mirror site. Make sure you have the latest version of the software, and that the downloaded version is designed to work on the selected platform.

Install the Server following the instructions below, and then proceed with Initial Configuration.


On all systems, the CommuniGate Pro uses 2 directories (folders):

Installing on a MS Windows 2000/NT/9x System

You can also start the CommuniGate Pro server manually, as a "console application", by launching the CGServer.exe file. If started without parameters, the Server creates the C:\CommuniGatePro folder and uses it as its "base" folder". If you want to use any other location, use the --Base command line parameter:
CGServer.exe --Base D:\OtherDirectory

Installing on a Sun Solaris System.

Installing on a Linux System.

Note: Under Linux, each thread in a multi-threaded application is seen as a "process" when you use the ps and top system utilities. As a result, you may see 30+ CGServer "processes" when the server is just started, and more after it has been actively used. All those "processes" are actually CommuniGate Pro Server threads, and they share all their resources - VRAM, File Descriptors, etc.

Installing on a MacOS X Server (Rhapsody) System.

Installing on a FreeBSD System.

Installing on a BSDI BSD/OS System.

Installing on an AIX System.

Installing on an HP/UX System.

Installing on a Tru64 (Digital Unix) System.

Installing on an SGI IRIX System.

Installing on an SCO UnixWare System.

Installing on an IBM OS/400 System.

Initial Configuration

You may want to check the Migration section to plan your CommuniGate Pro deployment process.

Upgrading to a Newer Version

When you upgrade to a new version, the files in the application directory are substituted with the new files.

The base directory and all its files are not modified when you update the CommuniGate Pro Server software, so all accounts, mailboxes, messages, settings, Personal Web Sites, customized WebUser and WebAdmin files stay and continue to work with the new version of the Server.

Note: if you chose to manually modify WebUser and/or WebAdmin files right in the application directory, then you should save them before updating. If you properly placed your customized versions of WebUser and/or WebAdmin files into the Domain Webuser/WebAdmin directories, these customized files are not removed when you upgrade the Server software.

To upgrade:

Moving to a New Hardware Server

You may want to move your CommuniGate Pro server to a different computer - running the same or a different OS. All your module settings, account and domain settings, mailboxes, and other data can be preserved.

CommuniGate Pro keeps all its data in the base directory. This is the only directory you need to copy to your new server computer.

CommuniGate Pro uses the same file formats on all hardware and software (OS) platforms, so usually you can just pack the entire CommuniGate Pro base directory into an archive file (using tar and gzip on Unix systems, zip on MS Windows systems), and unpack the archive on the new server computer.

Additional processing is needed when you move the CommuniGate Pro Server from a computer running any MS Windows operating system to a computer running any flavor of Unix, or vice versa. CommuniGate Pro files are text files, and text files on MS Windows and Unix have different EOL (end of line) symbols: CR-LF (return - linefeed) on MS Windows and bare LF (linefeed) symbol on Unix systems. To copy files properly, you may want to use any FTP software to copy files between those systems: when an FTP client is instructed to transfer files in the ASCII mode, it properly converts EOL symbols.
Note: CommuniGate Pro base directory can contain non-text (binary) files in the WebUser and WebAdmin directories inside the Account and Domains subdirectories - graphic files used in the customized WebUser and WebAdmin Interfaces. Binary files can also be stored in Personal Web Sites - account.web directories inside the account directories. When you move a CommuniGate Pro base directory between systems using different EOL conventions, check that those binary files are copied in the BINARY mode (i.e. without EOL recoding).

If the new server computer is running a Unix system, check that the copied directory and all its files and subdirectories have the same access rights as they had on the old system.

After the CommuniGate Pro base directory is copied, download and install the proper version of the CommuniGate Pro Server on the new server computer. There is no need to copy the content of application directory from the old server computer, even if both new and old computers are running the same operating system.

Check that the newly installed copy of the CommuniGate Pro Server (its startup script, if any) is configured to use the copied base directory, and then start the CommuniGate Pro Server on the new computer. Use the WebAdmin Interface to modify the computer-related settings on the new server. For example, you may need to update the Client IP Addresses table or re-assign IP addresses to CommuniGate Pro Domains.

CommuniGate® Pro Guide. Copyright © 1998-2000, Stalker Software, Inc.