Version 5.1
SysAdmin |
|---|
| ||||||||||
|
|
Version 5.1 |
||||||||||||||||||||||||||||||||
|
|
Note: If an Account is granted the Master access right, the Account user can access all realms.
Note: These Server Administration access rights can be granted to the Main Domain Accounts only. Accounts in secondary Domains can be granted Domain Administration rights only.
When a Server is installed for the first time, it creates the postmaster Account in the Main Domain, and it grants the Master access right to that Account.
An WebAdmin Interface Type ranging from Basic to Expert is assigned to each Administrator. These Types (or Expertise Levels) are designed to simplify the learning process:
When the CommuniGate Pro Server is installed for the first time, and the postmaster Account is created, the Basic WebAdmin Interface Type is set for that Account. You can change the Interface Type by opening the WebAdmin Preferences pages.
Note: This documentation shows the WebAdmin pages and settings as they are displayed in the Expert mode.
Note: unless you create additional Domains
ONLY the E-mail Messages and Signals directed to addresses in the Main Domain will
be processed as local. If the Main Domain Name is entered as company.com,
then Messages to mail.company.com or Signals to sip.company.com will not
be processed as local, and if such a Message or Signal is received, the Server will try
to deliver it to the mail.company.com or the sip.company.com system over the network.
If the DNS record for mail.company.com or sip.company.com points to the same Server computer,
the mail loop or signal loop error will be detected, and the Message or Signal
will be rejected.
If your Server should serve several domain names, enter the additional domain names as Main Domain Aliases (if those domain names should be mapped to the Main Domain), or create additional Secondary Domains.
Kernel problems are very unlikely to happen. If you see any problem with the Server,
try to detect which component is causing it, and change the Log setting of that component
(Router, SMTP, POP, etc.) to get more information.
If you see "exception raised"
messages in your CommuniGate Pro Log and/or in the OS system.log or mail.log,
you may want to disable this option and force the Server to stop when an exception is raised again,
and to produce a core dump file.
Core dump files can be uploaded to the CommuniGate Systems ftp site for examination.
CommuniGate Systems recommends you to disable this option if you are running any beta-version of the CommuniGate Pro software.
If this option is enabled, WebAdmin realms are addressed using the /realmName/page URLs, with /realmName/ as the authentication realm. The Server Administrator needs to enter a password to open each realm, but the Server Administrator needs the access right for that realm only.
Enable this option if some of your Server Administrators do not have the Master access right.
Use the WebAdmin Interface to open the Account Defaults page in the Users realm to specify Server-wide
language settings.
If you want to set a default language for a particular Domain, open that Domain pages in the WebAdmin Users realm,
and open the Domain Account Defaults page from there.
Click the WebUser Preferences link to open the Default Preferences page.
Select the default Language and select a matching Preferred Character set: ISO-2022-JP for Japanese, KOI8-R for Russian, etc. If most of your users use modern Web browsers with the proper UTF-8 support, set the Use UTF-8 option to Reading and Composing.
Set the display names for the INBOX mailbox and the virtual MAPI Outbox folder. These strings are used only with the CommuniGate Pro own client components - the WebUser Interface and MAPI, so you can enter any valid mailbox name here, in any language. You can also change these names at any time.
Set the names for special mailboxes - Sent, Drafts, Notes, Trash, Contacts, Calendar, and Tasks. Please note that these names will be used with the CommuniGate Pro own client components only - the WebUser Interface and MAPI. To make the user's IMAP clients use the same mailboxes for the same purposes, the same mailbox names should be specified in the IMAP client configurations. If you change these names later, the new mailboxes will be created when a client needs to access a special mailbox: the already existing special mailboxes will not be renamed.
Open the Account Defaults page in the Domains section of the WebAdmin Interface if you want to set the Server-wide default time zone. If you want to set a default time zone for a particular Domain, open the Domains page of the WebAdmin Interface, open the Accounts or Settings page for the selected Domain and open the Domain Account Defaults page from there. Click the WebUser Preferences link to open the Default WebUser Preferences page.
Select the default Time Zone from the list. If you select the "built-in" zone (***), the Server will use a fictitious zone that has the same time difference with GMT as the Server OS has at this time. This zone has no support for daylight saving time and it cannot be used for sending recurrent events outside your Server. Unless your Time Zone is not listed, avoid selecting the "built-in" zone.
All CommuniGate Pro Server files - accounts, domains, mailboxes, settings, queues, etc. are stored in one place - in the Server base directory.
When the Server starts, it creates the following objects inside its base directory:
For more information about the Account and Domain files and directories, see the Account Data section.
You can use symbolic links to move some of these directories to other locations (and other disks).
On Unix and OpenVMS platforms you can use the startup script with the stop parameter, or you can get the Server process id from the ProcessID file in the base directory and use the kill command to stop the server. On OpenVMS platforms the KILL.EXE program can be found in the application directory.
On the Windows NT platform, you can use the Services control panel to stop and start the CommuniGate Pro server.
You can also use the shutdown CLI API command to stop the server.
When the Server receives a shutdown request, it closes all the connections, commits or rolls back mailbox modifications, and performs other shutdown tasks. Usually these tasks take 5-15 seconds, but sometimes (depending on the OS network subsystem) they can take more time. Always allow the Server to shut down completely, and do not interrupt the shutdown process.
The Server places records into the OS log:
The system Log is:
CommuniGate Pro can "drop" the root privilege. The privilege can be dropped in the "permanent" or "reversible" mode. When asked to drop the root (uid=0) privilege, the Server changes its UID:
When the root privilege is dropped, the following restrictions apply:
If the root privilege was dropped in the "reversible" mode, the root privilege can be restored. For example, if you need to open a listener on the port 576, but the Server root privilege has been dropped, you should restore the root privilege first, then open the listener port, and then you can drop the Root privilege again.
To drop the root privilege permanently, use a special Command Line Option.
To drop the root privilege in the "reversible" mode, click the "Drop Root" button on the General page. The button should change to the "Restore Root" button - you can use it to restore the Server root privilege. This option is not available on those platforms that cannot drop the root privilege correctly (Linux).
A Domain Administrator can control the Domain using the same WebAdmin port (see HTTP module description for the details), or using the Command Line Interface (API) commands. Domain Administrator access is limited to his Domain (and, optionally, to certain other domains), and to explicitly allowed Domain and Account settings and operatons.
When you grant the Domain Administrator access right to a user, you will see
a list of specific access rights - the internal names of Domain and Account Settings.
Each option controls the settings this Domain Administrator can modify, and the operations
this Domain Administrator can perform.
Domain Administrator access rights can be granted to users by a Server Administrator with the All Domains and Account Settings access right.
A System Administrator with the All Domains and Account Settings access right can perform all operations potentially available to a Domain Administrator in any Domain.
Note: when a Domain Administrator connects to the Domain WebAdmin Interface, the browser displays the Login Dialog Box. If the Administrator Account is in a different Domain, the full account name (accountName@domainName) should be specified.
| Domain Settings | |
|---|---|
| Access Right | Description |
| DomainAccessModes | Enabled Services |
| AutoSignup | WebUser Interface: Auto-Signup Setting |
| TrailerText | WebUser Interface: Mail Trailer Text Setting |
| WebBanner | WebUser Interface: Web Banner Text Setting |
| WebSitePrefix | WebUser Interface: Personal Web Site Prefix Setting |
| Foldering | Large Domains: Foldering Method Setting |
| FolderIndex | Large Domains: Generate Index Setting |
| RenameInPlace | Large Domains: Rename in Place Setting |
| AllWithForwarders | Mail to All: Send to Forwarders Setting |
| MailToAllAction | Mail to All: Distributed for Setting |
| ExternalOnUnknown | Unknown Names: Consult External Authenticator Setting |
| MailToUnknown | Unknown Names: Mail to Unknown Names Setting |
| MailRerouteAddress | Unknown Names: Mail Rerouted to Setting |
| SignalToUnknown | Unknown Names: Signal to Unknown Names Setting |
| SignalRerouteAddress | Unknown Names: Signal Rerouted to Setting |
| CentralDirectory | Directory Integration Setting |
| CertificateType | Security: Domain PKI Settings |
| KerberosKeys | Security: Kerberos Keys |
| RelayAddress | SMTP Sending: Send via Setting |
| recipientStatus | SMTP Receiving: When Receiving Setting |
| Objects | |
| Access Right | Description |
| CanCreateAccounts | Create, rename, and remove Accounts |
| CanCreateGroups | Create, rename, remove, and modify Groups |
| CanCreateForwarders | Manage Forwarders |
| CanCreateLists | Create, rename, and remove Mailing Lists |
| CanAccessLists | Modify Mailing Lists |
| CanCreateAliases | Manage Aliases |
| CanCreateTelnums | Manage Telephone Numbers |
| CanPostAlerts | Post Domain and Account Alerts |
| CanAdminSubDomains | Administer other Domains |
| CanModifySkins | Manage Domain Skins |
| CanModifyPBXApps | Manage Domain Real-Time Applications |
| CanAccessMailboxes | Unrestricted Access to all Account Mailboxes |
| CanAccessWebSites | Unrestricted Access to all File Storage files |
| CanCreateWebUserSessions | Manage WebUser sessions via CLI |
| CanImpersonate | Ability to Impersonate |
| Account Settings | |
| Access Right | Description |
| BasicSettings | Basic Settings: Password, RealName, Custom and Public Info settings |
| PSTNSettings | PSTN settings |
| WebUserSettings | WebUser Interface Settings |
| UseAppPassword | CommuniGate Password: Allow to Use |
| PWDAllowed | CommuniGate Password: Allow to Modify |
| PasswordEncryption | CommuniGate Password: Encryption |
| RequireAPOP | Authentication methods: Secure only |
| UseKerberosPassword | Kerberos Authentication |
| UseCertificateAuth | Certificate Authentication |
| UseSysPassword | Authentication methods: Enable OS Password |
| OSUserName | Authentication methods: Server OS user name |
| UseExtPassword | Authentication methods: External Authentication |
| AccessModes | Enabled Services |
| MaxAccountSize | Mail Storage limits: Mail Storage |
| MaxMailboxes | Mail Storage limits: Mailboxes |
| DefaultMailboxType | Mail Storage options: New Mailboxes |
| QuotaNotice | Mail Quota Processing: Send Notice |
| QuotaAlert | Mail Quota Processing: Send Alerts |
| QuotaSuspend | Mail Quota Processing: Delay New Mail |
| RulesAllowed | Mail processing options: Rules |
| RPOPAllowed | Mail processing options: RPOP Accounts |
| MailToAll | Mail processing options: Accept Mail to all |
| AddMailTrailer | Mail processing options: Add Mail Trailer |
| SignalRulesAllowed | Signal processing options: Rules |
| MaxSignalContacts | Signal processing limits: Contacts |
| MaxWebSize | File Storage limits: Web Storage |
| MaxWebFiles | File Storage limits: Web Files |
| AddWebBanner | File Storage options: Add Web Banner |
| DefaultWebPage | File Storage options: Default Web Page |
The bottom part of every WebAdmin page contains the name of the authenticated Administrator viewing that page, and the link to the WebAdmin Preferences page.
Each CommuniGate Pro WebAdmin realm has its own Preferences. Click the Preferences link to open the Preferences page.
The specified Preferences are stored as one of the Administrator Account Setting attributes, so different administrators can have different Preferences.
The WebAdmin Interface uses the same Skins Interface as the WebUser Interface. By uploading custom admin* files to the default Domain Skin, the Domain WebAdmin Interface is modified.
The Server Administrator can also upload custom admin* files into the Server-wide and Cluster-wide Skins.
Note:The Server WebAdmin interface always uses the "stock" Skin files located in the WebSkins subdirectory of the application directory. If you modify the WebAdmin interface for the Main Domain, the modified pages will be used when a Domain Administrator of the Main Domain uses the WebAdmin Interface. The Server Administrator will see the framed version of the WebAdmin Interface (with the Settings, Domains, Directory, and Monitors realms) and the "stock" Skin files will be used to compose the Server WebAdmin Interface pages.
To modify the Server Strings, open the General pages in the WebAdmin Interface Settings realm, and open the Strings page:
Note: The actual Strings page has much more elements.
To modify a Server String, enter the new text in the text field, and select the upper radio button. To change the string to its default value (displayed under the text field), simply select the lower radio button.
Click the Update button to update the Server Strings.
To specify the External Helper program path and other parameters, open the General page in the Settings realm of the WebAdmin Interface and click the Helpers link:
The checkbox next to the Helper name tells the Server to start the specified program as a separate OS process.