Installing Components
Incredibuild is installed in the /opt/incredibuild directory, however, the data files are stored in the data directory you specify in the installation commands.
Installation Prerequisites
-
Verify that your machines meet all operating system and hardware requirements.
-
Verify that Security-Enhanced Linux (SELinux) is disabled. For details, see Disabling SELinux.
-
Incredibuild requires the following ports: 2088, 2089, 8080, 8081, 9952, and 9953. If they are not available, use the G ,N, and L flags when running the installation commands below to modify the ports.
-
Get the installer file by registering on our website. If you are already a registered customer but you need the installer file, contact sales@Incredibuild.com.
-
Running the installer must be done by a user with root user permissions.
Typical Installation
Make sure that all of the Installation Prerequisites above have been met before installing.
-
Install Incredibuild on a high availability machine that will act as your Coordinator. Copy the installer file to the machine and run the following:
sudo bash ./incredibuild__<version no.>.ubin install -C -A <path_to_incredibuild_data_directory>
You can also install an Agent on the same machine by adding the -S flag.
Make sure the data directory is not /opt/incredibuild as this is used for other items.
-
Install Incredibuild on all other machines that you want to initiate or help with workloads. The -S flag installs an Agent that can act as an Initiator and Helper. Replace it with -H to install an Agent that can only act as a Helper.
sudo bash ./incredibuild_<version no.>.ubin install -S -O <Coordinator_Machine_IP_or_Hostname> -A <Path_to_Incredibuild_Installation_Directory>
Full Installation Command List
There are many more parameters that can be used to modify the installation. To display Incredibuild Linux help, use the install command without any parameters.
ibuser@incredibuild:~$ ./incredibuild_3.11.0-229.ubin install
Parameter | Description | Notes |
---|---|---|
-A <Path> |
The path to the storage directory, where Incredibuild DBs and file cache will be stored. |
This parameter must be included in the installation of all components. Incredibuild will automatically create a link to this path. By default, the allocated file size is 11GB, but this size can be configured using the -Z parameter (see below). The storage directory cannot be under: /opt/incredibuild |
-C | Incredibuild Coordinator installation. | |
-C -H | Coordinator and Helper Agent installation. | |
-C -S | Coordinator, Initiator Agent, and Helper Agent installation. | |
-H | Helper Agent installation. | |
-O <Coordinator |
The IP address or hostname of the Coordinator machine. |
|
-R SUVM | A supplementary Agent installation command, for installing Initiator and/or Helper Agent on an image of VMs that will receive SUVM licenses. | For more information on this command, see Creating a VM Image for the SUVM License. |
-S | Initiator Agent and Helper Agent installation. | |
-6 | For the Coordinator installation - specifies that the communication between the Coordinator and the Agents will be done using IPv6, instead of IPv4. |
|
-D |
For an Agent installation - skips the automatic Agent-Coordinator connectivity test. |
|
-G <port> | For all components - specifies the port for accessing the Web Management Console using HTTP. |
|
-L <port> | For all components - specifies the port for accessing the Web Management Console using HTTPS. |
|
ib_console -v | For all components - shows the version no. of the installed component. | For more information, see Checking the Version No. of the Installed Incredibuild Components. |
-N <port> | For all components - specifies the Coordinator Utility Port. |
|
-Z <size> | For all components – specifies the size of the allocated file cache in GB. |
|
-p, --profile <profile_file> |
Adds an additional profile file. For details, see ib_profile. |
|
Installing Older Versions
In general, we recommend using the latest version of Incredibuild. The installation commands were updated in version 3.11, but if you need to install an earlier version you can use the following procedure. Note that in earlier versions, the -i flag is required for installation, and .bin is used instead of .ubin. Make sure that all of the Installation Prerequisites above have been met before installing.
-
Install Incredibuild on a high availability machine that will act as your Coordinator. Copy the installer file to the machine and run the following:
sudo bash ./incredibuild__<version no.>.bin -i -C -A <Path_to_Incredibuild_Installation_Directory>
You can also install an Agent on the same machine by adding the -S flag.
-
Install Incredibuild on all other machines that you want to initiate from or help with workloads. The -S flag installs an Agent that can act as an Initiator and Helper. Replace it with -H to install an Agent that can only act as a Helper.
sudo bash ./incredibuild_<version no.>.bin install -i -S -O <Coordinator_Machine_IP_or_Hostname> -A <Path_to_Incredibuild_Installation_Directory>