A Messaging Server Configuration Scripts

This appendix provides information about the Oracle Communications Messaging Server configuration scripts.

configure Script

The configure script enables you to perform an initial configuration of your Messaging Server deployment. Table A-1 describes the configure options.

Table A-1 configure Options

Option Description

--dataroot=path

Specifies a non-default DataRoot. The product finds a non-default DataRoot by following the InstallRoot/data symlink, and finds a non-default ConfigRoot by following the InstallRoot/config symlink. Starting with Messaging Server 8.0.2, those two symlinks are optional and need not be present.

--debug

Provides general debug information primarily for LDAP operations.

--help

Displays help.

--ignoreSendmail

Keeps sendmail enabled after configuration. In other words, sendmail does not disable after configuration.

--ldapport [ldapport]

Specifies an LDAP port other than the default port 389.

--ldif

Causes configure to run without modifying the directory and instead generate an LDIF file (MessagingServer_home/data/install/configure.ldif) which the administrator can apply to the directory after initial configuration. This is needed if the person doing the installation does not have directory administrative rights.

--noldap

Runs without LDAP present (statefile only).

--novalidate

Skips most validation of user input.

--noxml

Generates legacy configuration (does not use XML-based Unified Configuration); can also be used to replace a Unified Configuration with a freshly generated legacy configuration (fresh installation of Messaging Server, not an upgrade where the configtoxml command was run). Not supported as of Messaging Server 8.0.2.

--preserveCritical

Does not overwrite critical attributes.

--saveState [statefile]

Specifies a location other than the default location (mentioned below) to save a state file.

--ssl

Requires SSL when configuring LDAP.

--state [statefile]

Uses a silent installation file. See "To Run a Messaging Server Silent Installation".

--version, --V

Displays product version.

--xml

Generates Unified Configuration (XML).

--noisc

Configures the front-end MTA, MMP, and mshttpd hosts to not use the Indexed Search Converter (ISC). With the removal of the classic message store in this release of Messaging Server, this enables you to install front-end services without requiring that Java be present.


Table A-2 describes the options that you can use in the configure statefile.

Table A-2 configure statefile Options

Option Description

Fqdn.TextField

Specifies local host's fully qualified domain name.

msg.DataPath

Specifies the non-default DataRoot.

iMS.UserId

Specifies the user name for server processes.

iMS.GroupId

Specifies the group name for server processes. Only used if iMS.UserId doesn't exist and needs to be created, in which case this group is used.

UGDIR_URL

Specifies the ldap or ldaps URL for the Directory Server.

UGDIR_BINDDN

Specifies the LDAP administrator user.

UGDIR_BINDPW

Specifies the LDAP administrator password. This password is obfuscated using a ROT-13 variant.

Postmaster.TextField

Specifies the email address for the postmaster.

admin.password

Specifies the password for server administration. This password is base64-encoded for obfuscation.

EmailDomain.TextField

Specifies the default email domain.

OrgName.TextField

Specifies the existing default organization DN.

InternalIPlist

Specifies IP address information, in comma-delimited form, for systems permitted to relay mail without authentication.

XMLCONFIG

When set to 1, creates a Unified Configuration. When set to 0, creates a legacy configuration. The --xml and --noxml command options override what is specified in the statefile. For Messaging Server 8.0.2, this option is ignored and Unified Configuration is always used.

cassandra

When set to 1, creates a Cassandra message store.

dssetup.ugsuffix

Specifies the user/group suffix.

dssetup.dcsuffix

Specifies the domain suffix.

dssetup.schematype

Specifies the schema type.