prerequisites.adoc

Pre-requisites

This section will guide you through the pre-requisites before you can use this project.

You can proceed to the Quick Start guide if you have already done these.

1. Install Terraform

   1. Download Terraform

   2. Configure path on Linux/macOS

   3. Configure path on Windows

   4. Testing Terraform installation

2. OCI API Keys

   1. Generate API Keys

   2. Upload API Keys

3. Create an OCI Compartment

4. Obtain the necessary OCIDs

5. Identity and Access Management Rights

6. Using Autonomous Linux

Install Terraform

Start by installing Terraform and configuring your path.

Download Terraform

1. Open your browser and navigate to the Terraform download page. You need version 0.12.8+.

2. Download the appropriate version for your operating system.

3. Extract the the contents of compressed file and copy the terraform binary to a location that is in your path (see next section below).

Configure path on Linux/macOS

Open a terminal and type the following:

sudo mv /path/to/terraform /usr/local/bin

Configure path on Windows

Follow the steps below to configure your path on Windows:

1. Click on 'Start', type 'Control Panel' and open it

2. Select System > Advanced System Settings > Environment Variables

3. Select System variables > PATH and click 'Edit'

4. Click New and paste the location of the directory where you have extracted the terraform.exe

5. Close all open windows by clicking 'OK'

6. Open a new terminal and verify terraform has been properly installed

Testing Terraform installation

Open a terminal and test:

terraform -v
Terraform v0.12.16

OCI API Keys

Generate API keys

Follow the documentation for generating keys on OCI Documentation.

Upload your API keys

Follow the documentation for uploading your keys on OCI Documentation.

Note the fingerprint.

Create an OCI compartment

Follow the documentation for creating a compartment.

Note: OCI creates default root compartment during account/tenant creation. It should be not be used for this project. We recommend creating a new compartment or a child compartment.

Obtain the necessary OCIDs

The following OCIDs are required:

1. Compartment OCID

2. Tenancy OCID

3. User OCID

Follow the documentation for obtaining the tenancy and user ocids on OCI Documentation.

To obtain the compartment OCID:

1. Navigate to Identity > Compartments

2. Click on your Compartment

3. Locate OCID on the page and click on 'Copy'

Identity and Access Management Rights

If you are enabling notifications for the bastion host or instance_principal for the admin server, the Terraform user must have the rights to manage policies and dynamic groups respectively.

Using Autonomous Linux

Install only packages in the Autonomous Linux yum repo