Proxy installation - Linux

validation-status-icon-error WARNING: Never install ERA Server and ERA Proxy on the same computer!

 

1.Make sure all prerequisites are met.

2.Run an installation script to install the Proxy server. See an example of the installation script below.

Connection settings

A target must be specified with a:

Hostname

IPv4 address

IPv6 address

DNS resource record - The Linux computer must be in the domain - see the chapter DNS Resource record.

Port must be specified: use port 2222 for both Server and Proxy.

Example of an installation script
(New lines are split by "\" for copying the whole command to Terminal)

./proxy-linux-x86_64.sh \
--db-hostname=10.1.179.28 \
--db-name=era_6_db_proxy \
--db-admin-username=sa \
--db-admin-password=admin.1 \
--db-user-username=tester \
--db-user-password=Admin.1 \
--db-port=1433 \
--db-type="MS SQL Server" \
--db-driver=MySQL \
--skip-license \
--hostname=10.1.179.30 \
--port=2222 \
--cert-path=/home/adminko/Desktop/proxy.pfx \
--cert-auth-path=/home/adminko/Desktop/CA-server.der \
--cert-password=root \

You can modify the following attributes:

Attribute

Description

Required

--db-hostname

Computer name or IP address of the database server (default value is localhost)

Yes

--db-name

Name of the database to be used (default value is era_db or era_proxy_db)

Yes

--db-admin-username

Database administrator username (used by installation for creating and modifying database; default value is root)

Yes

--db-admin-password

Database administrator password

Yes

--db-user-username

Database ERA Proxy user username (used by ERA Proxy for connecting to database); should be no longer than 16 characters

Yes

--db-user-password

Database ERA Proxy user password

Yes

--db-port

Port of the database server (default value is 3306)

Yes

--db-type

Type of database, which will be used (possible values: MySQL Server, MS SQL Server; default value is MySQL Server)

Yes

--db-driver

ODBC driver used for connecting to database (command odbcinst -q -d gives a list of available drivers, use one of this drivers for example: --db-driver="MySQL")

Yes

--skip-license

Installation will not ask user for license agreement confirmation

-

--hostname

Hostname or IP address of the Server (default value is localhost)

Yes

--port

Server port (default value is 2222) or Proxy port (default value is 1236)

Yes

--proxy-port

Port which will be used by proxy (default value is 2222)

-

--product-guid

Product GUID (if not defined, it will be generated)

-

--cert-path

Local path to the Proxy certificate file

Yes*

--cert-content

Base64 encoded content of PKCS12 encoded public key certificate plus private key used to set up secure communication channels with Server and Agents

Yes*

--cert-auth-path

Path to the Server's Certificate Authority file

Yes**

--cert-auth-content

Base64 encoded content of DER encoded certificate authority private key certificate used to verify remote peers (Proxy or Server)

Yes**

--cert-password

Certificate Authority password. Must match the Agent's certificate password (can be empty if password was not used in peer certificate)

Yes

--cert-auth-password

Certificate Authority password

 

--keep-database

Database will not be removed during uninstallation

-

* Use only one of the --cert-path or --cert-content options.
** Use only one of the --cert-auth-path or --cert-auth-content options.

To verify whether the installation was successful, use the following command to verify whether the service is running:

sudo service eraproxy status

The installer log may be useful for troubleshooting and can be found in Log files.