Complete the following steps to configure your Content Runtime environment.
The Content Runtime is a virtual machine. A Chef server is installed on the virtual machine as part of the configuration of the Content Runtime. Two docker containers are installed on the machine to help communicate with the Chef server and to manage the software repository.
There are four templates:
The VMware
template deploys a virtual machine to the target VMware vSphere cloud. The Other
template deploys the Content Runtime to an existing virtual machine. This allows you to instantiate a virtual machine and perform as
much or as little configuration as needed to create the Content Runtime. IBM and Amazon templates use a cloud provided Ubuntu 14.04 image as a deployment virtual machine.
The configuration process installs the following components on the Content Runtime virtual machine:
These components are illustrated in Figure 2. Components on the Content Runtime virtual machine.
Figure 2. Components on the Content Runtime virtual machine
After you complete the task, you must populate the software repository on the file system of the Content Runtime virtual machine. See Populating the Software Repository and Populating the Install Manager Repository for more details.
Before selecting a template, consider the following:
VMware
Beside the common parameters listed in the following section, you must have all the information needed to instantiate a virtual machine through the VMware vCenter. This information is entered in the Content Runtime template. The parameters are listed in the following Common Parameter Values section.
Amazon Web Services
When deploying an AWS EC2 instance, information such as the region (for example us-east-1
), a VPC subnet ID and a security group ID will be required besides the common parameters. A private IP address associated to the provided subnet
is optional.
Note When providing a Key Name for Pattern Manager key set
, the key needs to be created manually in the AWS EC2 dashboard. This can be done by accessing the Key Pairs page. Click Import Key Pair and provide the public key associated to the Pattern Manager. Selecting Create Key Pair will generate a key which is not supported by the system.
IBM Cloud
An IBM Datacenter, such as dal09
for Dallas 09, will be required alongside hardware specifications. The default values for these specifications are the minimum recommended for a Content Runtime deployment, but they can be tweaked. Optional
settings include the ability to associate a portable IP address to the virtual machine.
Other
Beside the common parameters, the Other
template allows you to provide the IP address of an existing virtual machine and login credentials to the Content Runtime template. An existing VMware vCenter, Amazon Web Services or IBM Cloud
account can be used to manually create a virtual machine to be used. This may be the easiest solution for first time users.
For more information about public and private keys, see SSH Keys and related input required while deploying content runtime. Deploying a content runtime requires the following categories of parameters:
SSH public and private keys for the pattern manager. It can be generated with the following commands:
In Mac OS:
ssh-keygen -t rsa -f [output_keyfile] -N "" -C "";base64 [output_keyfile] > [output_keyfile].enc
In Unix:
ssh-keygen -t rsa -f [output_keyfile] -N "" -C ""; base64 -w 0 [output_keyfile] > [output_keyfile].enc
The [output_keyfile].enc output file is the encoded private key used. The [output_keyfile].pub file is the public key. The content of these files are used as input to the template.
Note:
Parameter values which are grayed out are immutable values that are displayed as part of the Content Runtime template for informational value only.
The virtual machine must have a connection to the internet for the duration of the configuration process.
The following tables contain a list of values which are required for creating the Content Runtime. In the first table, there are the values which are common for all providers followed by a table for specific values for each cloud provider.
/opt/ibm/docker/software-repo
direct-lvm
mode (only supported in the Other
template, see Production Docker for more information)advanced_content_runtime_chef
Data Type. The namespace
of the data object is same as the namespace of the content runtime. Optionally, if you want this data object to be available to middleware template deployments that are in a different namespaces, then make this data object as globally accessible.If any problem occurs, see Troubleshooting and known issues.
In Content runtimes page, you can use the following methods to search for content runtimes:
Docker recommends configuring direct lvm mode for production environments .
The following two methods can be used to allow the Content Runtime to configure production docker:
Other
template
On an existing Content Runtime virtual machine.
daemon.json
with the command sudo rm /etc/docker/daemon.json
.~/advanced-content-runtime/launch-docker-compose.sh
.Note: There is an underlying option missing on the lvcreate
command on Ubuntu 14.04, therefore the Content Runtime does not attempt to configure direct-lvm
on Ubuntu 14.04.
After the Content Runtime is deployed, you can log in to the Content Runtime virtual machine either by using the password or by using the SSH key.
VMWare Cloud
To log in to the Content Runtime deployed on VMWare, use the password if you had provided one during the deployment or use the SSH private key that is associated with the SSH public key. This SSH public key is the value you provided for input User’s Public Key.
IBM Cloud
To log in to the content runtime deployed on IBM Cloud, do the following steps:
Save the copied contents to a file and use this private key to SSH into the virtual machine. Alternatively, if you had provided a value for User’s Public Key, then you can use the private key associated with this value.
Amazon Cloud
To log in to the content runtime deployed on IBM Cloud, do the following steps:
You must complete the Software Repository configuration step as described in Software repository configuration.