CommuniGate Pro
Version 5.2
Objects
 
 
Database

Account Data

The CommuniGate Pro Server stores Account information in several places. Most of the information is stored in the Account service files, while some Account data is grouped in the Domain files.

Domain Files

For each CommuniGate Pro Domain, a file directory is created in the Domains subdirectory inside the Server base directory. The directories have the same names as the domains.

For the main domain, the Accounts file directory is created inside the base directory.

Inside each domain file directory, a Settings file directory is created. This directory contains the following files:

Access.settings
This file has the dictionary format, and contains the names of the users that have administrative access rights to the server or to the domain, and the list of the granted rights. By storing all administrative access rights in one location the CommuniGate Pro Server makes it easier to maintain server security. Only the Access.settings file stored in the main domain Settings directory can contain the server-level access rights. All other files can contain only the domain-level administrative access rights.
Domain.settings
This file contains the Domain Settings.
RPOP.data
This file contains the information about all individual RPOP (remote POP) accounts that should be polled on behalf of the Domain users.
Template.settings
This file contains the Account Template for this Domain and provides the Account Settings for new Accounts in this Domain.
Aliases.data
This file contains the list of all account-level aliases specified for the Domain Accounts.
LISTS
This directory contains files with the information about the mailing lists created in the Domain.
WebSkins
This directory contains custom WebUser Interface Skins for this Domain.

Account Service Files

Every CommuniGate Pro Account contains at least one (INBOX) Mailbox, and at least two service files. Service files have special file name extensions:
.settings this dictionary file contains Account Settings, including the Account Rules.
.info this dictionary file contains volatile Account information, such as mailbox sizes, last UIDs used in each mailbox, etc.
Since the .info file is being modified rather often, the CommuniGate Pro Server is built to survive .info file corruptions. For example, if the mailbox last UID information is corrupted, the server rescans the mailbox and restores the correct mailbox info.
.dst this optional dictionary file contains the Account "DataSet", that includes Account DataSet Address Books (also known as string lists), and application preferences set via ACAP.
.web this optional file directory is the Account File Storage.
.rpopids this optional file directory contains a file for each RPOP Account that has the Leave On Server option enabled. Each array file contains UIDs of the messages already retrieved from that PROP Account.
.roaming this optional dictionary file contains Netscape Roaming information.

Account Files Location

The Account files are located in the Domain file directory or in its subdirectory (see the Domains section for the details). The GetAccountLocation CLI command can be used to learn the physical location of the Account files.

For a multi-mailbox Account, a directory with the Account name and .macnt extension is created, and all Account files are stored in that directory. The Account service files are stored as account.extension. The INBOX mailbox is stored as the INBOX.mailboxType file.
Example: for the multi-mailbox Account John, the john.macnt directory is created, and the files INBOX.mbox, account.settings, account.info are placed in that directory.

For a single-mailbox Account, the INBOX mailbox is created as a file in the Domain file directory or its subdirectory, and it has the accountName.mailboxType file name. The account service files are stored in the same directory as accountName.extension.
Example: for the single-mailbox Account John, the john.mbox, john.settings, and john.info are placed into the domain file directory.


Netscape Roaming

The Netscape® Communicator product can use any advanced HTTP server to store and restore its settings.

To use this Netscape Roaming service, the user should specify the following URL as the Roaming Server URL:
http://domain[:port]/Settings/
where domain is the user domain (or the main CommuniGate Pro domain), and port is the CommuniGate Pro User HTTP port.

The actual Account name is not specified in this URL. Access to the /Settings/ realm requires authentication, and the CommuniGate Pro Server opens the Account specified in the browser username/password dialog box.

If the URL used contains the correct domain name of the target Account, the Account name can be specified as a simple name (i.e. without the domain part), but if the URL contains the name of some other CommuniGate Pro Domain (because the target domain does not have any A-record), the Account name should be specified along with the Domain name, i.e. instead of the jsmith string, the jsmith@domain.com string should be used in the Netscape username/password dialog box.

The Netscape Settings are stored as separate files inside the Account service directory with the .roaming extension.


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