Install the Controller Using the Command Line

Determine which host you plan to install your Controller on before starting. The host that runs the Enterprise Console is "localhost".

Note: You may also use the loopback address '127.0.0.1' or the machine's actual hostname.

Complete the following steps carefully if you choose to install the Controller on this shared host rather than on a remote host. Note that all services on Windows machines must be installed on the Enterprise Console host since the Enterprise Console does not support remote operations on Windows.

In the <Installation directory>/platform-admin directory, run the following commands to install the Controller:

  1. Create a platform:
    Linux
    CODE 
    platform-admin.sh create-platform --name <platform name> --installation-dir <platform installation directory>
    Windows
    CODE 
    platform-admin.exe cli create-platform --name <platform name> --installation-dir <platform installation directory>
  2. Add the credential.For a remote host on Linux machines only: 
    platform-admin.sh add-credential --credential-name <name> --type <ssh> --user-name <username> --ssh-key-file <file path to the key file
    <file path to the key file> is the private key file. The installation process deploys the key to the Controller host. For the localhost:The localhost does not require credentials. You can, therefore, skip this step, especially for Windows deployments. For more information, see Manage Hosts.
  3. Add the host.For a remote host on Linux machines only: 
    platform-admin.sh add-hosts --hosts remotehost --credential <credential name>
    For the localhost:
    Linux
    CODE 
    platform-admin.sh add-hosts --hosts localhost
    Windows
    CODE 
    platform-admin.exe cli add-hosts --hosts localhost
  4. Install the Controller on the host. On a remote host for Linux machines only:
    CODE 
    platform-admin.sh submit-job --service controller --job install --args controllerPrimaryHost=<remotehost> controllerAdminUsername=<user1> controllerAdminPassword=<password> controllerRootUserPassword=<rootpassword> mysqlRootPassword=<dbrootpassword>
    On the localhost:
    Linux
    CODE 
    platform-admin.sh submit-job --service controller --job install --args controllerPrimaryHost=localhost controllerAdminUsername=<user1> controllerAdminPassword=<password> controllerRootUserPassword=<rootpassword> mysqlRootPassword=<dbrootpassword> newDatabaseUserPassword=<password> controllerDBHost=<host> controllerProfile=<profile>
    To install the Controller with Azul Prime JDK, set the startWithPrime to true as follows:
    CODE 
    ./platform-admin.sh submit-job --platform-name ujjuPlatform --service controller --job install --args controllerPrimaryHost=appdva-test5-vm160 controllerAdminUsername=admin controllerAdminPassword=root controllerRootUserPassword=root mysqlRootPassword=root startWithPrime=true
    Windows
    CODE 
    platform-admin.exe cli submit-job --service controller --job install --args controllerPrimaryHost=localhost controllerAdminUsername=<user1> controllerAdminPassword=<password> controllerRootUserPassword=<rootpassword> mysqlRootPassword=<dbrootpassword> newDatabaseUserPassword=<password> controllerDBHost=<host> controllerProfile=<profile>
Note that these are the required parameters for installing a Controller with a demo profile size. For information about optional configuration options, run the following command:
Linux
CODE 
platform-admin.sh list-job-parameters --job install --service controller
Windows
CODE 
platform-admin.exe cli list-job-parameters --job install --service controller