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
--customer-label-value <CUSTOMER LABEL VALUE>
-l <CUSTOMER LABEL VALUE>
Adds a value to the
customer
label in alerts.
If you are using Zebra's alert monitoring service, OpsRamp, pass your customer name. Specifying your customer name only adds this information to your alerts; you must still set Zebra's OpsRamp instance as an alerting target after configuring
Resonate
. For information, refer to the Alerting Targets section of the
Resonate RFID Reader Management
User Guide.
You can only use this option when installing
Resonate
.
Default: N/A
Required: If sending alerts to Zebra's OpsRamp, yes. Otherwise, no.
--help
Displays the installer's possible options and their descriptions (this table).
Default: N/A