Example installation commands

About this task

Consider the following examples to understand the use and capabilities of the twsinst command. You can optionally encrypt the password using the secure script. For more information, see Optional password encryption - secure script.

The following example shows the syntax used when using the twsinst script to install a new instance of a fault-tolerant agent.

On Windows™ operating systems:

cscript twsinst.vbs -new 
   -uname TWSuser1 -password user_password -acceptlicense yes
   -agent fta -company HCL -displayname thishostcomputername
   -hostname thishostname.mycompany.com
   -inst_dir "c:\Program Files\HCL\TWA_TWSuser1"
   -master TWSmdm -port 37124 -thiscpu fta101

On UNIX™ and Linux™ operating systems:

./twsinst -new
   -uname TWSuser1 -acceptlicense yes -agent fta
   -company HCL -create_link -hostname thishostname.mycompany.com
   -inst_dir "/opt/HCL/TWA_TWSuser1" -master TWSmdm
   -port 37124 -reset_perm -skipcheckprereq
   -thiscpu fta101 -work_dir "/home/TWSuser1/tmp"

The following example shows the syntax used when downloading and deploying the certificates from the master domain manager to a dynamic agent. Ensure the certificates are available on the master domain manager in the TWA_DATA_DIR/ssl/depot path.

cscript twsinst.vbs -new
   -uname TWSuser1 -password user_password -acceptlicense yes  -agent dynamic
   -displayname thishostcomputername -hostname thishostname.mycompany.com
   -inst_dir "c:\Program Files\HCL\TWA_TWSuser1"
   -jmport 31114 -tdwbport 31116 -tdwbhostname mainbroker.mycompany.com -wauser wauser
   -wapassword password

./twsinst -new
   -uname TWSuser1 -acceptlicense yes  -agent dynamic
   -displayname thishostcomputername -hostname thishostname.mycompany.com
   -inst_dir "/opt/HCL/TWA_TWSuser1" -jmport 31114 -reset_perm -skipcheckprereq
   -tdwbport 31116 -tdwbhostname mainbroker.mycompany.com -wauser wauser
   -wapassword password

cscript twsinst.vbs -new
   -uname TWSuser1 -password user_password -acceptlicense yes  -agent dynamic
   -displayname thishostcomputername -hostname thishostname.mycompany.com
   -inst_dir "c:\Program Files\HCL\TWA_TWSuser1"
   -jmport 31114 -tdwbport 31116 -tdwbhostname mainbroker.mycompany.com -wauser wauser
   -wapassword password

In the following example, you install a new agent with both dynamic agent and fault-tolerant agent capabilities.
By setting jwt to true, you install the agent and authenticate with the master domain manager using JWT. The jwt parameter requires the tdwbhostname and tdbwport parameters for connecting to the dynamic domain manager and the wauser and wapassword parameters, which provide the credentials to be used when logging in to the master domain manager. The credentials are required when you first download the JWT from the master domain manager:
```
twsinst -new -acceptlicense yes -agent both -uname TWSuser1 -tdwbhostname Saturn 
-tdwbport 37116 -master Jupiter -jwt true -wauser MDMAdmin -wapassword 125784gtrOLK8542Mnfdw!
```
This example is a variation from the previous example. Instead of using the wauser and wapassword parameters when logging in to the master domain manager, you authenticate using the API Key you have previously retrieved from the Dynamic Workload Console. For this purpose, use the apikey parameter:
```
twsinst -new -acceptlicense yes -agent both -uname TWSuser1 -tdwbhostname Saturn
-tdwbport 37116 -master Jupiter -jwt true -apikey eyJraWQiOiJha2li....KINijWmdC-fY
```

In the following example, you install a dynamic agent and authenticate with the master domain manager named Saturn using JWT. The agent hosts a local gateway with gateway ID GWD1:

twsinst -new -acceptlicense yes -agent dynamic -uname TWSuser1 -hostname Titan -displayname Titan
-tdwbhostname Saturn -tdwbport 37116 -jwt true -wauser MDMAdmin 
-wapassword 125784gtrOLK8542Mnfdw! -gateway local -gwid GWID1 -jmport 42427

In the following example, you install an agent and authenticate with the master domain manager using JWT. The agent connects to the remote gateway installed on the agent in the previous example. In this case, the tdwbhostname parameter must be set to the host name of the dynamic agent (Titan) hosting the gateway and to which the agent you are installing will connect. In the same way, the tdwbport parameter must match the port number of the dynamic agent hosting the gateway. You have set this port using the jmport parameter when installing the dynamic agent hosting the gateway.
```
twsinst -new -acceptlicense yes -agent both -uname TWSuser1 -displayname Tetis
-tdwbhostname Titan -tdwbport 42427 -jwt true -wauser MDMAdmin 
-wapassword 125784gtrOLK8542Mnfdw! -gateway remote -jmport 54548
```
In the following example, you install the agent using local .PEM certificates for authentication. Ensure you copy the .PEM certificates on the agent before you start the installation. The path to the certificates is specified with the sslkeysfolder parameter. The sslpassword parameter specifies the password to access the certificates. In this case, the jwt parameter must be set to false:
```
twsinst -new -acceptlicense yes -agent both -uname TWSuser1 -tdwbhostname Saturn 
-tdwbport 37116 -master Jupiter -jwt false -sslkeysfolder /MyCertsFolder 
-sslpassword fer1smx8854ijDSW65?!
```
In the following example, you install the agent and download to the agent the .PEM certificates from the master domain manager. Ensure the certificates are available on the master domain manager in one of the following paths:
On Windows operating systems
```
installation_directory\TWS\ssl\depot
```
On UNIX operating systems
```
TWA_DATA_DIR/ssl/depot
```
To download the certificates, specify the wauser and wapassword parameters to connect to the master domain manager. In this case, the jwt parameter must be set to false
```
twsinst -new -acceptlicense yes -agent both -uname TWSuser1 -tdwbhostname Saturn -tdwbport 37116 
-master Jupiter -jmport 1234 -port 1235 -netmansslport 1236 -jwt false -wauser MDMAdmin 
-wapassword 125784gtrOLK8542Mnfdw!
```