install.sh

install.sh

The
install.sh
script installs Resonate RFID Reader Management. You run the script after setting up the system(s) with the
setup.sh
script. In a multi-node configuration, run the script from the primary node.
install.sh
has several command-line options to customize the installation process.

Command Syntax

install.sh [options]

Options

Option
Description
--external-hostname=<RESONATE SERVER FQDN>
-h <RESONATE SERVER FQDN>
Specifies the external hostname of the server (cluster). This is the FQDN to use to access the server (cluster) from outside the network.
Default: N/A
Required: Yes.
--mode=<MODE>
-m <MODE>
Specifies the deployment mode for installing the server. Valid
<MODE>
values are:
  • prod-single-node
  • prod-multi-node
Default: prod-single-node
Required: For a multi-node setup.
--smtp-server <SMTP SERVER FQDN/IP>
Specifies the FQDN or IP address of the SMTP server to use.
Default: N/A
Required: Yes.
--smtp-port <PORT>
Specifies the port of the SMTP server to use.
Default: 25
Required: No
--admin-email <EMAIL>
Specifies the email address to use for the system administrator (first user with administrator privileges). When the system is up, the installer sends an email to this address with a link to the newly installed platform, requesting that the user set their password.
Default: N/A
Required: Yes.
--tls-certificate <TLSCERTIFICATE>
-c <TLSCERTIFICATE>
Specifies the path on your Resonate server to your trusted X.509 digital enterprise certificate. Provide a file that includes the full certificate chain; the
install.sh
script assigns the certificate to the server. Use this option to avoid the
self-signed certificate
error when browsing to the Resonate web interface. Before using this option with the installer, add the certificate to the new Resonate server's file system; the certificate should be PEM encoded.
If required, you should typically run
install.sh
with this option at Resonate installation time or before adding readers; otherwise, you will have to re-initialize the readers.
When passing this option, also use the
--tls-key <TLSKEY>
option to pass the private key.
Default: N/A
Required: No
--tls-key <TLSKEY>
-k <TLSKEY>
Specifies the TLS private key associated with the X.509 digital enterprise certificate.
Default: N/A
Required: No
--tls-override
Overrides the existing TLS certificate and private key in the cluster.
Default: N/A
Required: No
--help
Displays the installer's possible options and their descriptions (this table).
Default: N/A