Installing IBM Cloud Private Cloud Foundry
Complete the following steps to download and install IBM® Cloud Private Cloud Foundry.
Note: IBM Cloud Private Cloud Foundry, a fullstack version which is a traditional Bosh based deployment, will be deprecated in an upcoming release. The Cloud Foundry Enterprise Environment, a Kubernetes based version, is the preferred Cloud Foundry deployment.
Installation requires approximately 2 - 3 hours. This installation time does not include the time that it takes to download the installation files.
- Download the full installation file from Passport Advantage
(14 GB).
- You might need to install IBM® Cloud Private Cloud Foundry in a data center that does not have an Internet connection. In this situation, copy the installation file to a server that has access to the Docker Community Edition (CE) and VMware environments.
- If Docker CE is not already installed, install Docker CE. For more information, see Install Docker
.
- Create an installation directory.
- Extract the full installation file into the installation directory.
- Change to the installation directory.
-
Run the following command to import Docker images from the installation directory.
import_images.sh -
Create a directory to store the installation configuration. You must allocate a minimum of 35 GB of space to this directory, but you might need up to 100 GB of space. Run the following command to create the installation configuration directory:
mkdir -p /home/user/data -
Run the installation script. In the following example,
/home/user/datais the installation configuration directory../launch.sh -n IBMCloudPrivate -c /home/user/data -e LICENSE=accept -
You can find a template file for your IaaS infrastructure in the following location:
/<installation_configuration_directory>/extensions/embedded/cfp-bosh-templates/uiconfig_<environment_type>_template.yml. The<environment_type>variable depends on your IaaS infrastructure. Copy this file to your installation directory and modify it. Replace the default and sample values with the actual values for your particular environment.- For parameters that are common to vSphere, OpenStack, and AWS see Common parameters.
- For parameters that are specific to vSphere, see vSphere parameters.
- For parameters that are specific to OpenStack, see OpenStack parameters.
- For parameters that are specific to AWS, see AWS parameters.
-
Configure DNS. For more information about DNS, see Configure Domain Name Service resolution IBM® Cloud Private Cloud Foundry.
- (Optional) Prepare to use an external database. See Configuring the Director service to use a different database.
-
(Optional) Prepare to use an external database for IBM Cloud Private Cloud Foundry. See Configuring remote databases for IBM Cloud Private Cloud Foundry.
-
Use one of the following methods to start your deployment:
Command line interface (CLI)
Run the following command to start your deployment and display the logs:
./launch_deployment.sh -c your-uiconfig.ymlIf you use the CLI to start a deployment, you can still use the user interface to monitor the deployment.
Cloud Foundry deployment tool
For more information about using the Cloud Foundry deployment tool to install IBM Cloud Private Cloud Foundry, see Installing IBM Cloud Private Cloud Foundry with the Cloud Foundry deployment tool.