Installation overview

You install BDD by running a single script, which installs all of its components at once. When the script completes, your cluster will be running and ready to use.

The installer is contained in one of the BDD installation packages, which you will download to the install machine. The same package also contains BDD's configuration file and a second script that verifies whether your system meets all prerequisites.

The following sections describe the installation process, from preparing the install machine to running the installer.

Silent installation

Normally, the BDD installer prompts for the following information at runtime:
  • The username and password for your cluster manager (Cloudera Manager, Ambari, or MCS), which the script uses to query your cluster manager for information related to your Hadoop cluster.
  • The username and password for the WebLogic Server admin. The script will create this user when it deploys WebLogic.
  • The JDBC usernames and passwords for the Studio and Workflow Manager Service databases.
  • The username and password for the Studio admin.
  • The absolute path to the location of the installation packages.

You can avoid entering this information manually by running the installer in silent mode. To do this, set the following environment variables before installing. The installer will check for them when it runs and execute silently if it finds them. Note that many of these will be useful after installing, as they are used by BDD's administration script.

Environment variable Value
BDD_HADOOP_UI_USERNAME The username for your cluster manager (Cloudera Manager, Ambari, or MCS).
BDD_HADOOP_UI_PASSWORD The password for your cluster manager.
BDD_WLS_USERNAME The username for the WebLogic Server administrator.
BDD_WLS_PASSWORD The password for the WebLogic Server administrator. This must contain at least 8 characters, one of which must be a number, and cannot start with a number.
BDD_STUDIO_JDBC_USERNAME The username for the Studio database.
BDD_STUDIO_JDBC_PASSWORD The password for the Studio database.
BDD_WORKFLOW_MANAGER_JDBC_ USERNAME The username for the Workflow Manager Service database.
BDD_WORKFLOW_MANAGER_JDBC_ PASSWORD The password for the Workflow Manager Service database.
BDD_STUDIO_ADMIN_USERNAME The email address of the Studio admin, which will be their username. This must be a full email address and can't begin with root@ or postmaster@.

The installer will automatically populate this value to the STUDIO_ADMIN_EMAIL_ADDERESS property in bdd.conf, overwriting any existing value. If you set STUDIO_ADMIN_EMAIL_ADDERESS instead of this environment variable, the installer will still execute silently.

BDD_STUDIO_ADMIN_PASSWORD The password for the Studio admin. This must contain at least 8 characters, one of which must be a non-alphanumeric character.

The Studio admin will be asked to reset their password the first time they log in if you set the STUDIO_ADMIN_PASSWORD_RESET_REQUIRED property to TRUE.

INSTALLER_PATH The absolute path to the location of the installation packages. This is only required if you don't set the INSTALLER_PATH property in bdd.conf.