Installing from the Command Line v6.2

The section provides directions for installing xDB Replication Server from the Linux or Windows command line console.

There are basically three ways of performing command line installation.

• Text. Include the --mode text parameter when invoking the installer to perform an installation from the command line during which you are prompted for user input.
• Unattended. Include the --mode unattended parameter when invoking the installer to perform an installation without user input. In this case, required parameters must be specified on the command line when invoking the installer or the --optionfile parameter must be used to specify a file containing the parameter settings.
• Extract Only. Invoke the installer with the --extract-only parameter to only extract the files when you do not hold the root privileges required to perform a complete installation.

The xDB Replication Server installer program can either be downloaded directly from the EnterpriseDB website or by using Stack Builder or StackBuilder Plus.

The installer program name may vary depending upon how you obtained it. The following are some examples illustrating command line installation.

installation for Linux](/epas/latest/epas_inst_linux/)

Follow the directions for your host operating system to install Java runtime.

The following example shows how to start the xDB Replication Server installation in text mode.

$ ./xdbreplicationserver-6.2.0-alpha-1-linux-x64.run --mode text
Language Selection

Please select the installation language
[1] English - English
    .
    .
Please choose an option [1] :
----------------------------------------------------------------------------
Welcome to the Postgres Plus xDB Replication Server Setup Wizard.
    .
    .

The following example shows how to start the installation in unattended mode with an options file.

$ su root
Password:
$ ./xdbreplicationserver-6.2.0-alpha-1-linux-x64.run --optionfile /home/user/xdb_config

The following is the content of the options file, xdb_config.

mode=unattended
existing-user=user@xyz.com
existing-password=password
installer-language=en
prefix=/opt/PostgreSQL/EnterpriseDB-xDBReplicationServer
enable-components=repconsole,pubserver,subserver
admin_user=admin
admin_password=password
pubport=9051
subport=9052
serviceaccount=enterprisedb
servicepassword=password

The following is a list of the parameters that may be specified when running the installer program. Most parameters have a default value if the parameter is not specified.

Parameters

--help

Display the list of valid options.

--version

Display the product version information.

--extract-only { yes | no }

Specify yes or 1 to extract the xDB Replication Server components and files without performing installation. Specify no or 0 to perform the installation of xDB Replication Server as well. The default is no or 0.

--unattendedmodeui { none | minimal | minimalWithDialogs }

Specify the extent to which a user interface should be displayed during unattended installation. Specify none if no progress bars are to be displayed. Specify minimal if progress bars are to be displayed. Specify minimalWithDialogs if progress bars are to be displayed with dialog boxes if errors occur. The default is minimal.

--optionfile filename

Use the specified file containing installation configuration parameters in parameter=value format.

--mode { qt | gtk | xwindow | text | unattended }

Specify the installation mode. Specify qt to use the Qt graphical toolkit. Specify gtk to use the Gtk graphical toolkit (for Linux only). Specify xwindow to use the X Windows graphical toolkit (for Linux only). Specify text for installation in a command line console (for Linux only). Specify unattended to perform installation without requesting user input. The default is qt.

--debugtrace debug_logfile

Specify this parameter to create a debug log file.

--debuglevel { 0 | 1 | 2 | 3 | 4 }

Specify the amount of detail to be written to the debug log file. Higher values provide more detail. The default level is 2.

--existing-user edb_user_account

Specify your EnterpriseDB user account. (This is the email address used as your identifier when you created an account on the registration page of the EnterpriseDB website.)

--existing-password edb_user_password

Specify the password of your EnterpriseDB user account.

--installer-language { en | zh_CN | zh_TW | ja | ko }

Specify the installation language. Specify en for English. Specify zh_CN for Chinese Simplified. Specify zh_TW for Traditional Chinese. Specify ja for Japanese. Specify ko for Korean. The default is en.

--prefix installation_directory

The directory where the xDB Replication Server components are to be installed. The default is /opt/PostgreSQL/EnterpriseDB-xDBReplicationServer for Linux systems. The default is C:\Program Files\edb\EnterpriseDB-xDBReplicationServer for Windows systems.

--enable-components {[ repconsole ] [,pubserver ] [,subserver ]}

Specify the xDB Replication Server components to be installed. Specify repconsole for the xDB Replication Console and the xDB Replication Server Command Line Interface. Specify pubserver for the xDB publication server. Specify subserver for the xDB subscription server. At least one component must be included in this comma-separated list. The default is repconsole,pubserver,subserver.

--disable-components {[ repconsole ] [,pubserver ] [,subserver ]}

Specify the xDB Replication Server components to exclude from installation. The default is an empty list.

--admin_user admin_user

The xDB administrator user name to authenticate certain usage of the xDB Replication Server such as registering a publication server or a subscription server running on this host. Any alphanumeric string may be entered for the admin user name. The default admin user name is admin.

--admin_password admin_password

Password of your choice for the xDB administrator. There is no default for this parameter.

--pubport port

Port number for the publication server. The default is 9051.

--subport port

Port number for the subscription server. The default is 9052.

--serviceaccount account_name

The operating system account under which the publication server or subscription server is to run. The default is postgres.

--servicepassword account_password

The password for the operating system account. There is no default for this parameter.

Successful installation of xDB Replication Server results in the creation of directory structures and files in your host environment as described in Section Post-Installation Host Environment.

Before using Replication Server, you must download and install JDBC drivers. See Installing a JDBC driver for details.