Skip to content

Latest commit

 

History

History
117 lines (80 loc) · 6.83 KB

ANSIBLE.md

File metadata and controls

117 lines (80 loc) · 6.83 KB
Raw

Ansible orchestration for 12c RAC in Docker Containers

Multiple node Oracle RAC cluster running in Docker containers.

Setup

If you're running CoreOS for your Docker host, some setup is required before proceeding. Instructions can be found in [ANSIBLE_SETUP.md] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ANSIBLE_SETUP.md)

Ansible

All of the ansible scripts are in the [ansible] (https://github.com/Seth-Miller/12c-rac-docker/tree/master/ansible) directory in this repository. Throughout these instructions it is assumed you are working from the ansible directory.

Besides the instructions found here, the yaml files are heavily commented with information and examples.

The tasks in the Ansible roles follow very closely to the instructions found in the [README.md] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/README.md).

Common Variables

The variables for all of the roles are contained in the [roles/common/vars] (https://github.com/Seth-Miller/12c-rac-docker/tree/master/ansible/roles/common/vars) directory. All of the roles reference variables in the [main.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/roles/common/vars/main.yml) file.

There is a second file called [files.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/roles/common/vars/files.yml) that is referenced for the file locations of the grid infrastructure and database installation files. This file was left intentionally blank so you can fill out the locations for these files based on your environment.

It is important that all of the playbooks reference the common role as well as the files.yml file.

vars_files:
  - roles/common/vars/files.yml
roles:
  - common

Prepare the Docker host

The [prepare_host.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/prepare_host.yml) file starts the prepare_host role. These tasks not only prepare the Docker host, they also build the containers that support the Oracle RAC cluster, including the DNS/BIND, DHCPD, and NFS server containers.

Run the prepare_host playbook.

ansible-playbook prepare_host.yml

Tags can be used to limit which tasks are executed in each playbook. If you want to only prepare the ASM file and block devices, add the asm tag.

ansible-playbook prepare_host.yml --tags=asm

Here is a list of tags and their descriptions for the prepare_host tasks.

Tag Description
asm Manage the ASM block and file devices
create_docker_networks Creates public and private Docker networks
create_directory Creates directories for container configuration files
config_files Copies config files to DHCPD and NFS containers
create_container Creates the BIND, DHCPD, and NFS containers
installation_files Downloads and unzips the Oracle installation files

Create the RAC node image

The [create_oracle_image.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/create_oracle_image.yml) file starts the create_oracle_image role. These tasks create the RAC node image which will be used by all RAC node containers. The image preparation consists of installing the grid infrastructure software, the database software, and patches for both. The image will be committed locally on the Docker host and called giinstalled.

Once the image has been created, it will not need to change until new binaries or new patches need to be applied.

Here is a list of tags and their descriptions for the create_oracle_image tasks.

Tag Description
create_rac1_container Creates the rac1 container
install_grid Installs the grid infrastructure binaries
install_database Installs the database binaries
opatch Updates opatch in both grid infrastructure and database homes
apply_patch Applies the bundle and one-off patches to the grid infrastructure and database homes
commit_rac1 Commits the prepared RAC node container to the giinstalled image

Create the first RAC node container

The [create_first_rac_node.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/create_first_rac_node.yml) file starts the create_first_rac_node role. These tasks create the first RAC node container (rac1) from the giinstalled image created in the previous step. These tasks configure the grid infrastructure for a cluster and start the cluster processes. It also relinks the oracle executable for RAC.

Here is a list of tags and their descriptions for the create_first_rac_node tasks.

Tag Description
create_rac1_container Creates the rac1 container
configure_grid Configures the grid infrastructure for the cluster
configure_grid_root Executes the grid infrastructure root scripts that start the cluster processes
configure_grid_tools Finishes configuring the grid infrastructure
relink_for_rac Relinks the oracle executable for RAC

Create the second RAC node container

The [create_second_rac_node.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/create_second_rac_node.yml) file starts the add_rac_nodes role, setting the this_rac_node variable to rac2. These tasks create the second RAC node container (rac2) from the giinstalled image. These tasks differ from the first RAC node container creation in that they add the rac2 container to the existing cluster running on rac1. It also relinks the oracle executable for RAC.

Here is a list of tags and their descriptions for the add_rac_nodes tasks.

Tag Description
create_additional_container Creates the rac2 container
add_new_node_to_cluster Runs addnode.sh on rac1 to add rac2 to the existing cluster
add_new_node_root Executes the grid infrastructure root scripts that starts the cluster processes
relink_for_rac Relinks the oracle executable for RAC

Add orcl RAC database

The [add_database.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/add_database.yml) file starts the add_database role. These tasks create the orcl Oracle database in the cluster using the dbca utility.

Here is a list of tags and their descriptions for the add_database tasks.

Tag Description
create_database Creates the orcl database

Add NDATA ASM disk group

The [add_NDATA_diskgroup.yml] (https://github.com/Seth-Miller/12c-rac-docker/blob/master/ansible/add_NDATA_diskgroup.yml) file starts the add_diskgroup role, setting the this_disk_group variable to NDATA. These tasks create the NDATA ASM disk group.

Here is a list of tags and their descriptions for the add_database tasks.

Tag Description
create_disk_group Creates the NDATA ASM disk group