Installing or Upgrading ThingWorx Flow Silently
You can perform a silent, unattended installation or upgrade of ThingWorx Flow from the command line interface.
 |
Silent installation is supported for PostgreSQL installation only.
|
Run the ThingWorx Flow installer with the --help parameter to see the various parameters that you can pass to the silent installer. For example:
• For Windows: ThingWorxFlowPostgres-9.x.x-x64.exe --help
• For Linux: ThingWorxFlowPostgres-9.x.x-x86_64.run --help
The installer detects if it is a fresh installation or upgrade of ThingWorx Flow. However, whether you are performing a fresh installation or upgrading from ThingWorx Flow 8.5.x to 9.x.x, you need to provide the following parameters in the command:
|
|
The following parameters and their values must be added in the command during a fresh installation as well as an upgrade installation.
• --FLOW_DB_LOGIN_USERNAME
• --FLOW_DB_LOGIN_PASSWORD
• --FLOW_DB_LOGIN_USERNAME_UPDATE
• --FLOW_DB_LOGIN_PASSWORD_UPDATE
|
|
Parameter
|
Description
|
Values
|
||
|---|---|---|---|---|
|
mode
|
Installation or upgrade mode
|
unattended
|
||
|
accept_eula
|
End user license agreement
|
YES
|
||
|
installdir
|
ThingWorx Flow installation directory
|
-
|
||
|
TWX_HOST
|
Specify one of the following values:
• Host name of the machine where you are installing ThingWorx Flow
• If ThingWorx was already deployed, it is recommended to reuse the host name that been used for the ThingWorx instance.
This configuration allows users to avoid having to change their bookmarks or learn a new URL. However, you must modify the value of the name attribute in the Host tag in the server.xml file under the Tomcat installation.
• Custom domain name. In this case, you must add the following line to the hosts file to map the domain name:
127.0.0.1 <Custom domain name>
|
-
|
||
|
TWX_PORT
|
ThingWorx Foundation port
|
-
|
||
|
TWX_PROTOCOL
|
ThingWorx Foundation protocol
|
https or http
|
||
|
TWX_SETTINGS_PATH
|
Full path to ThingWorx Foundation platform-settings.json file
|
-
|
||
|
NGINX_HTTPS_PORT
|
ThingWorx Flow HTTPS port
This port must be different than the ThingWorx Foundation port
|
443
|
||
|
POSTGRES_IP_ADDR
|
PostgreSQL only–Database server host name /IP address
|
-
|
||
|
POSTGRES_PORT
|
PostgreSQL only–Database server port
|
5432
|
||
|
TWX_FLOW_DB_NAME
|
ThingWorx Flow database name
|
-
|
||
|
FLOW_DB_LOGIN_USERNAME
|
ThingWorx Flow database user name
|
-
|
||
|
FLOW_DB_LOGIN_PASSWORD
|
ThingWorx Flow database password
|
-
|
||
|
FLOW_DB_LOGIN_USERNAME_UPDATE
|
Fresh and upgrade installation—ThingWorx Flow database user name
|
-
|
||
|
FLOW_DB_LOGIN_PASSWORD_UPDATE
|
Fresh and upgrade installation—ThingWorx Flow database password
|
-
|
||
|
TWXORCH_PUBLIC_URL
|
ThingWorx Flow public URL
Applicable for fresh installation only.
|
MACHINE_HOSTNAME/IPADDRESS-
|
||
|
debuglevel
|
Optional. Debug verbosity level.
|
0 or 1 or 2 or 3 or 4
Default value is 2.
|
||
|
SSL_MODE
|
Specifies whether connection with ThingWorx Flow database will be SSL.
|
true/false
|
The following is a sample command to install or upgrade ThingWorx Flow on Windows with PostgreSQL:
ThingWorxFlowPostgres-9.x.x-x64.exe --mode unattended --accept_eula YES
--TWX_HOST <hostname/ipaddress> --TWX_PORT <TWXPORT> --TWX_PROTOCOL <http/https>
--TWX_SETTINGS_PATH "PATH_TO_THINGWORX_PLATFORM_SETTINGS"
--NGINX_HTTPS_PORT <NGINX_HTTPS_PORT> --POSTGRES_IP_ADDR <DATABASE_HOSTNAME/IPADDRESS>
--TWX_FLOW_DB_NAME <FLOWDBNAME> --FLOW_DB_LOGIN_USERNAME <DBUSER> --FLOW_DB_LOGIN_PASSWORD <DBUSERPASSWORD>
--FLOW_DB_LOGIN_USERNAME_UPDATE <DBUSER> --FLOW_DB_LOGIN_PASSWORD_UPDATE <DBUSERPASSWORD>
--TWXORCH_PUBLIC_URL <FLOW_PUBLIC_URL>
--TWX_HOST <hostname/ipaddress> --TWX_PORT <TWXPORT> --TWX_PROTOCOL <http/https>
--TWX_SETTINGS_PATH "PATH_TO_THINGWORX_PLATFORM_SETTINGS"
--NGINX_HTTPS_PORT <NGINX_HTTPS_PORT> --POSTGRES_IP_ADDR <DATABASE_HOSTNAME/IPADDRESS>
--TWX_FLOW_DB_NAME <FLOWDBNAME> --FLOW_DB_LOGIN_USERNAME <DBUSER> --FLOW_DB_LOGIN_PASSWORD <DBUSERPASSWORD>
--FLOW_DB_LOGIN_USERNAME_UPDATE <DBUSER> --FLOW_DB_LOGIN_PASSWORD_UPDATE <DBUSERPASSWORD>
--TWXORCH_PUBLIC_URL <FLOW_PUBLIC_URL>
The following is a sample command to install or upgrade ThingWorx Flow on Red Hat Enterprise Linux (RHEL) 7.5 with PostgreSQL:
./ThingWorxFlowPostgres-9.x.x-x86_64.run --mode unattended --accept_eula YES
--TWX_HOST <hostname/ipaddress> --TWX_PORT <TWXPORT> --TWX_PROTOCOL <http/https>
--TWX_SETTINGS_PATH <PATH_TO_THINGWORX_PLATFORM_SETTINGS>
--NGINX_HTTPS_PORT <NGINX_HTTPS_PORT> --POSTGRES_IP_ADDR <DATABASE_HOSTNAME/IPADDRESS>
--TWX_FLOW_DB_NAME <FLOWDBNAME> --FLOW_DB_LOGIN_USERNAME <DBUSER> --FLOW_DB_LOGIN_PASSWORD <DBUSERPASSWORD>
--FLOW_DB_LOGIN_USERNAME_UPDATE <DBUSER> --FLOW_DB_LOGIN_PASSWORD_UPDATE <DBUSERPASSWORD>
--TWXORCH_PUBLIC_URL <FLOW_PUBLIC_URL>
--TWX_HOST <hostname/ipaddress> --TWX_PORT <TWXPORT> --TWX_PROTOCOL <http/https>
--TWX_SETTINGS_PATH <PATH_TO_THINGWORX_PLATFORM_SETTINGS>
--NGINX_HTTPS_PORT <NGINX_HTTPS_PORT> --POSTGRES_IP_ADDR <DATABASE_HOSTNAME/IPADDRESS>
--TWX_FLOW_DB_NAME <FLOWDBNAME> --FLOW_DB_LOGIN_USERNAME <DBUSER> --FLOW_DB_LOGIN_PASSWORD <DBUSERPASSWORD>
--FLOW_DB_LOGIN_USERNAME_UPDATE <DBUSER> --FLOW_DB_LOGIN_PASSWORD_UPDATE <DBUSERPASSWORD>
--TWXORCH_PUBLIC_URL <FLOW_PUBLIC_URL>
Proceed to post-installation steps for ThingWorx Flow.