Silent Installation

Use the System Manager command-line interface (CLI) to generate configuration and secrets files, encrypt/decrypt secrets files, and to install or uninstall components. Each command outputs basic information in PowerShell when run and logs all information in Seq. If errors occur, you can troubleshoot by checking the log in Seq.

If you need to make changes like enabling TLS or configuring masking, you can do it by using the command-line instructions. There is no need to uninstall the previous version. Simply rerun the System Manager installation and adjust the config.json and secrets.zip files as required. You can use the original template and make changes there.

To use the CLI for an install, you must have the following prerequisites in place:

  • The server where you will complete the install, configured with the prerequisites for Nintex RPA server.

  • Microsoft SQL Server Management Studio on the Nintex RPA Server.

  • MSSQL Server 2016 or later installed on a remote server.

  • Ensure that you have access to the server hosting MSSQL database and that you have full credentials, including usernames and passwords, for this database.

    To ensure proper functionality, you must establish an open connection between both servers.
  • The Nintex System Manager executable (NintexSystemManagerSetup.exe) already run.
  • The installation bundle zip file (for example: nintex-rpa-server-23.11.0-full.zip).
  • To execute any commands, you must use PowerShell run as administrator.
Before proceeding with the CLI installation, ensure that you have run the System Manager executable file (NintexSystemManagerSetup.exe). This step is essential to set up the required configurations and dependencies for a successful CLI installation.

The steps below show the order an installation must follow. See the full reference to commands and arguments, with descriptions and examples, in the CLI Commands table below. The command syntax is: nintex-sysmgr-cli <command> <arguments>.

  1. (Optional) Store the installation bundle and Nintex System Manager executable file in the same directory. While this step is optional, it can help with easier management. You can achieve this by specifying the desired destination directory using the appropriate command arguments.

  2. Run PowerShell as administrator.

  3. Navigate to the folder that contains the Nintex System Manager executable (NintexSystemManagerSetup.exe).

  4. Run the configTemplate command to generate a config.json file.

  5. Edit the config.json file as required, referring to the list of parameters and their descriptions found [here]. Make the necessary changes based on your specific configuration needs.

  6. Run the secretsTemplate command to generate a secrets.json file.
  7. Edit any secrets you wish to change and set the relevant secrets for remote third parties, referring to the list of parameters and their descriptions found [here]. By default, all passwords are set to a random string that you can change to human-readable passwords. Changing the passwords for third party applications will make them easier to remember when you log into their user interface.
  8. Run the setPassword command. This password is used to encrypt and decrypt the secrets.zip file.

    Ensure that the environment passwords are entered consistently. Otherwise, you will be prompted to enter the passwords again.

  9. Run the encrypt command to generate an encrypted secrets.zip file. Delete the unencrypted secrets.json file in production after the secrets.zip file is created so that your secrets are not exposed. You can recreate the secrets.json file using the decrypt command if you need to.
  10. Run the install command to perform the installation using the bundle, edited config, and encrypted secrets files.
  • The --command=encrypt --delete command is not fully implemented and requires manual intervention to delete the JSON file used to encrypt the secrets. Future releases will use the -delete argument. Not deleting the secrets.json file is a security risk.
  • To delete the secrets.json file, use the --command=encrypt --remove command.
  • Only the all-in-one server type is available.

In the command examples listed below, the nintex-sysmgr-cli, installation bundle zip file, config.json, and secrets.json files are in the C:\sysmgr directory. You can use any directory you want, but be sure to edit the commands below to match your environment.

The home directory path is what the Nintex System Manager executable uses as the working directory and is where the components will be installed.

Command syntax: nintex-sysmgr-cli <command> <arguments>
Command Arguments Example and Description
--command=configTemplate
  1. --h - home directory path
  2. --z - zip bundle path
  3. --d - destination where to save the config template file (with file name)
Copy

Config template

nintex-sysmgr-cli --command=configTemplate --h=C:\nintex --z=C:\sysmgr\nintex-pd-22.11.0.218-full.zip --d=C:\sysmgr\config.json
The config.json file generated by this command contains values used to install components and connect to the various servers needed for installation. Edit the config.json file for your environment, e.g., SERVER_FQDN, CUSTOMER_DOMAIN, SEQ_ADDRESS, MYSQL_SERVER, MONGODB_SERVER. Other default values are preconfigured for you.
--command=secretsTemplate
  1. --h - home directory path
  2. --z - zip bundle path
  3. --d - destination where to save the secrets config template file (with file name)
Copy

Secrets template

nintex-sysmgr-cli --command=secretsTemplate --h=C:\nintex --z=C:\sysmgr\nintex-pd-22.11.0.218-full.zip --d=C:\sysmgr\secrets.json
The secrets.json file generated by this command contains connection credentials for the various servers and components in plain text. Edit credentials as needed for connections to 3rd party servers like your MySQL server.
--command=setPassword
  1. --h - home directory path
Copy

setPassword

nintex-sysmgr-cli --command=setPassword --h=C:\nintex
You will be prompted to enter a password to be used by the System Manager for encrypting or decrypting the secrets.zip file after you run the setPassword command. If you choose to skip this step, the encrypt and decrypt commands will prompt you to create a password. Alternatively, you can manually create an environment variable with the key NINTEX_SYSMGR_SECRETS_PASS and set its value to any desired password.
--command=encrypt
  1. --h - home directory path
  2. --f - unencrypted secrets file
  3. --d - destination where to save the encrypted secrets file (with file name)
  4. --secrets-pass-env - environment variable holding password to use to encrypt secrets zip file
Copy

Encrypt secrets file

nintex-sysmgr-cli --command=encrypt --h=C:\nintex --f=C:\sysmgr\secrets.json --d=C:\sysmgr\secrets.zip --secrets-pass-env=SYSMGR_SECRETS_PASS
This command encrypts your .json secrets file using the environment variable you set up earlier. For security purposes, we recommend deleting the json secrets file after the encrypted file is generated.
--command=decrypt
  1. --h - home directory path
  2. --f - encrypted secrets zip file
  3. --d - destination where to save the decrypted secrets file (with file name)
  4. --secrets-pass-env - environment variable holding password for encrypted secrets zip file
Copy

Decrypt secrets file

nintex-sysmgr-cli --command=decrypt --h=C:\nintex --f=C:\sysmgr\secrets.zip --d=C:\sysmgr\secrets.json --secrets-pass-env=SYSMGR_SECRETS_PASS
The decrypt command uses the same environment variable as the encrypt command to decrypt the secrets zip file.
--command=install
  1. --h - home directory path
  2. --z - zip bundle path
  3. --s - server type
  4. --external-config - config file
  5. --secrets-file - encrypted secrets zip file
  6. --secrets-pass-env - environment variable holding password for encrypted secrets zip file
Copy

Install package

nintex-sysmgr-cli --command=install --h=C:\nintex --z=C:\sysmgr\nintex-pd-22.11.0.218-full.zip --s=allInOne --external-config=C:\sysmgr\config.json --secrets-file=C:\sysmgr\secrets.zip --secrets-pass-env=SYSMGR_SECRETS_PASS
The install command uses the previously generated and edited files (config template and secrets template), and the installation bundle zip file, to install the product and components. All output is logged to Seq. The only currently supported server type is all-in-one.
--command=uninstall
  1. --h - home directory path
  2. --z - zip bundle path
  3. --s - server type
  4. --wipe - should wipe all data (backups, cache, etc..)
Copy

Regular Uninstall Package

nintex-sysmgr-cli.exe --command="uninstall" --s="allInOne"
Copy
Uninstall Wipe package
nintex-sysmgr-cli.exe --command="uninstall" --wipe --s="allInOne"

To uninstall using the CLI, you have two options:

  • Regular uninstall: This option removes the product assets, but cache files will remain. If you decide to reinstall, the product will use the previously stored data.

  • Uninstall with wipe: This option will thoroughly remove all product data.

    Data in remote databases and Seq will not be removed automatically. For instance, Aerobase data in the database will need to be manually deleted.

Windows requires paths with spaces in them to be enclosed in inverted commas, for example: "C:\sysmgr home folder\subfolder\file name.txt".

A: You can cancel the installation in PowerShell like you do with any script by pressing CTRL + C. If that fails, you can stop the Nintex System Manager Agent Windows service, which will cancel the installation.

A: You can complete the steps in this document again from the beginning and reconfigure values in the configuration template and then reinstall. However, for Aerobase. For Aerobase, you need to go to your database and delete (nintex_authentication). The installation will recreate the database with the correct data.

A: The installation bundle zip file contains a manifest.json file with preconfigured values for all of your plug-ins.

A: Upon finishing the System Manager installation, continue by installing the Discovery Robots. After the robot installation is finalized, ensure the products' functionality by launching and interacting with the Process Discovery Console.