First time Installation
The IncrediBuild Enterprise Edition installer should be installed on the host machine that you intend on using within your IncrediBuild infrastructure.
During the first installation you will install an IncrediBuild Coordinator, PostgreSQL, which serves as the database that will store the data regarding your builds and Agents utilization, and Apache Server, which serves as the host for the the IncrediBuild Dashboard.
Additionally you have the option of installing an Agent on your host machine. This is optional incase you rather only have Agents installed on other machines in your infrastructure instead.
Notes:
- You must obtain a valid Enterprise Edition license to complete the installation process.
- To obtain a license contact us at sales@incredibuild.com
First Time Installation
To get you started with IncrediBuild Enterprise Edition
- Download the IncrediBuild Enterprise Edition installer file.
- After you have the installer file downloaded, you may begin the installation process.
- Open the installer file and you will be greeted by this screen:
- Click Next to proceed.
- You will be given two options. You can directly Install IncrediBuild to your machine or you can set up an Automated Installer. For your first installation use the "Install IncrediBuild" option.
- Click Next to proceed.
- Accept the Terms and Conditions and click Next.
- On the following screen you have the choice of doing a Typical Installation or a Custom Installation.
Notes:
- For your first installation it is suggested to use the Typical Installation option. This will allow you install both an IncrediBuild Coordinator and an IncrediBuild Agent on your host machine.
- It is not necessary to install an Agent on your Main Coordinator machine. However it is necessary to have Agents on the other machines within your Infrastructure to harness the capabilities of IncrediBuild.
- Use the custom Installation option to manually select which components you would like installed on your machine, besides that, the procedure is the same.
- Click Next to proceed.
- You can install a new Coordinator or connect to an existing one. Install a new Coordinator for your first installation.
- Click Next to proceed.
- The Agent Settings screen will appear. You can configure the maximum cache size for the Agent and also have the option to install the IncrediBuild add-in for the Microsoft Visual Studio IDE.
- Click Next to proceed.
- Now you can select which ports to be used by the IncrediBuild Agent. We suggest using the default ports selected unless they conflict with other ports currently in use.
- Click Next to proceed.
- The Coordinator Network Settings window will appear. We suggest using the default port unless it conflicts with a port currently in use.
- Select a Destination Folder for where you want IncrediBuild installed.
- Click Next to proceed.
- Select where you want your IncrediBuild Database installed and select a port to be used for the locally installed Dashboard. We suggest the default port unless it conflicts with a port currently in use.
Note: Make sure your selected destination is large enough to contain your database as it could become really big in size over time. It is suggested to have atleast 5GB of space available for this.
- Click Next to proceed.
- Setup is now ready, Click next and wait for the installation process to complete.
Popups may appear during the installation process for the Apache server. Make sure you allow access through Windows Firewall.
- Setup is now complete, now all you need to do is load in a valid license.
- Locate your license file location and load it in.
- Click Next, the Loaded License screen will now appear, confirming your License details.
- Click Next to proceed.
If you haven't received your license, contact us at sales@incredibuild.com.
- The next window will notify you that the IncrediBuild components have successfully been installed.
- Click Finish.
- You are now ready to use IncrediBuild Enterprise Edition.
Installing Additional Agents
Notes:
- After you have finished your initial setup and have a Coordinator installed on your host machine, you don't need to install the entire Enterprise Edition installation file on the remote Agent machines. There is a file called "install.exe", which will be located in the directory wherever you have intially installed IncrediBuild. ((C:\Program Files (x86)\Xoreax\IncrediBuild\install.exe).
- This is suggested since you don't need PostgreSQL nor the Apache server on these Agent machines, so the installation file is much smaller.
- Additionally, the smaller installation file includes options for installing a backup Coordinator and single-use VM instances if needed.
To install IncrediBuild Agents:
To install additional Agents on other machines within the network, repeat the installation procedure, but connect to the previously installed main Coordinator, rather than creating a new one.
- Download the IncrediBuild installer file.
- repeat the installation procedure, but connect to the previously installed main Coordinator, rather than creating a new one.
- This will install an IncrediBuild Agent on the machine.