Customize installation for DESK Managed

• Installation path (binaries): /opt/desk-managed
• DESK Server data files: /var/opt/desk-managed
• The system user who runs DESK processes: desk
• The system group who runs DESK processes: desk

The following environment and admin-user attribute parameters should be used for initial server configuration. When specified, the installer will generate an authentication token for the public REST API following successful installation and cluster registration.

--initial-environment <name> — Use this parameter to specify the name of the environment.

--initial-first-name <name> — Use this parameter to specify the administrator's first name.

--initial-last-name <name> — Use this parameter to specify the administrator's last name.

--initial-email <email> — Use this parameter to specify the administrator's email.

--initial-pass <pass> — Use this parameter to specify the administrator's password.

You can run the DESK Managed installer in any of the following modes:

--install — This is standard, interactive installation.

--install-silent — Use this parameter to install with default settings. You can use this parameter to automate DESK Managed installation (no prompts). You can use other command line parameters to bypass some of the default settings.

--upgrade — Starts the upgrade process. Use this parameter if you want to start DESK Managed upgrade from the command line.

--uninstall — Safely uninstalls DESK Managed.

--restore — Restores DESK Managed installation from the backup file referenced by the --backup-file parameter. Backup is performed by DESK Managed on a daily basis once you've enabled and configured backup on DESK Managed.

--system-check — Use this parameter to check if the machine and operating system fulfills the requirements of the new version.

--self-check — Use this parameter to verify that the installer file isn't corrupt.

You can change the installation path and other settings using the following parameters:

--license <license-key> — Use this parameter to provide the license key you obtained from the DESK team.

--license-file <path> — DESK license file, used when license key is not provided.

--binaries-dir <path> — Full path to the DESK binaries directory.

--datastore-dir <path> — Full path to the DESK installation space directory. All DESK data is kept here. It's recommended that you use a dedicated drive or partition for this directory.

--cas-datastore-dir <path> — Full path to the DESK metrics repository directory. If you specify this location, metrics data will be kept here instead of in the main data location.

--els-datastore-dir <path> — Full path to DESK Elasticsearch store directory.

--svr-datastore-dir <path> — Full path to DESK raw transaction store directory. If you specify this location, raw transaction data will be kept here instead of in the main data location.

--system-user <user:group> — name:group of system user who is authorized to run DESK processes.

--network-proxy — If your machine uses a network proxy to connect to the Internet, put the address here in the following format: protocol://[user:password@]server-address:port. The default value is none.

--cluster-ip — If your machine has more than one network interface you need to decide which network interface will be used for DESK Cluster traffic and put its IP4 address here.

--install-agent <on|off> — Enable/disable installation of self-monitoring OneAgent. The default value is on.

--agent-dir <path> — Allows installation of self-monitoring OneAgent to a different directory. For example, on Linux: /bin/sh Managed-installer.sh --agent-dir /data/desk/.

With --agent-dir set to /data/desk/, the installer creates the symbolic link /opt/desk/oneagent -> /data/desk and all OneAgent files are placed into the specified directory (in this example, /data/desk). Note that this symbolic link needs to be removed manually, once OneAgent has been uninstalled. Using this parameter on Linux when SELinux is enabled requires the semanage binary to be available on your system.

--hosts <on|off> — Enable/disable altering of /etc/hosts file. The default is on.

--generate-domain <on|off> — Generate domain name and corresponding certificates. The default value is on.

--no-start — (Upgrade only) Use this parameter when you don't want DESK Managed to start immediately following an upgrade.

--unregister — Use this parameter when uninstalling a cluster to unregister the cluster and release license from Mission Control.

If you want to use the installation file to install a secondary DESK Managed node in a cluster, use the following parameters:

--seed-ip <ip> — IPv4 address of the master server in the cluster.

--seed-auth <auth-token> — Authentication token for connection to seed node. You'll find this after logging into the seed node, on the Download node installer page.

Command line parameters can also help you install or update SSL certificates on DESK Managed. For more information on installing fully-qualified digital certificates, see Can I use my own SSL certificate?

--update-cert — If you want to replace the self-signed certificate generated during DESK Managed installation, use this parameter with the installation script and install a CA issued certificate. You need to use this parameter together with --ssl-keystore.

--ssl-keystore <path> — Use this parameter to provide the installation script with a path to the KeyStore file containing your CA issued certificates.

--version — Print version information.

--tmp-dir <path> — Full path to the directory for installer temp files