Installing the Simulator

Docker is installed in the Simulator VM by default.

Log into the simulator VM:

ssh -i key opc@IP address     (OCI public IP address) 

Switch to root user:

$sudo -s 

Navigate to the simulator directory, where 19.xx.0.0.0 is the release number.

# cd simulator_19.xx.0.0.0 

Run the following command to make sure that the docker is running:

# docker ps 

You may see a default container running already, for example, oda-1.  If that is the case, then you are set up to connect to the container to run the ODACLI commands already. Run the following command:

# ./connectContainer.sh -n odasim-1 

No password is required for an OCI VM. Note that if you run the simulator on a Mac system, then use the Mac password to login.

To access the Oracle Database Appliance simulator through GUI or Browser User Interface (BUI):

Ensure that you have access to the port number assigned to the container.

Go to the simulator log directory.

//log 

Run the cat command for the most recent log file.

cat 
ODA Simulator system info:
Executed on: 2021_06_14_06_33_PM
Executed by:
num= 1         
dept= oda      
hostpubip=      

USERS:
Container : oda-1
ODA Console: https://ip_of_simulator_machine :7095/mgmt/index.html
ODA cli access: Connect to the host and run following command:
sh connectContainer.sh -n oda-1

Note the port number, for example, 7095.

Following are optional steps for manually managing the containers.

Note that if you are running the simulator standalone in a Linux or Mac system, then you must run the following steps.

 Run the following command to make sure the docker is running and to view which containers are running:

#docker ps 

If you see any unwanted container running, run the cleanup script to start fresh:

#./cleanup_odasimulator_sw.sh 

Run the simulator setup script:

# ./setup_odasimulator_sw.sh noportainer 

For always free OCI account with 1GB memory, it is recommended that you set up the simulator with one user and the single node option.

If a default container is not running, you can manually create a single node container for a user.

# ./createOdaSimulatorContainer.sh -d oda -t single -o noportainer 

A single container called oda-1 is created.

To view the options, use the following command:

# ./createOdaSimulatorContainer.sh -help 

For standard OCI account with minimum 2GB memory, it is recommended that you set up the simulator with the high-availability option:

# ./createOdaSimulatorContainer.sh -d oda -t ha -o noportainer 

For each Oracle Database Appliance X8-2-HA simulator user, two containers, oda-1-node0 and oda-1-node1, are created.

Ignore any warning messages about Agent or Zookeeper. Ensure that you can connect to the container.

Note the assigned port numbers in the following output. The port numbers are necessary for logging into the simulator Browser User Interface (BUI).

ODA Simulator system info:
Executed on: 2021_04_11_03_23_PM
Executed by:
num= 1         
dept= oda      
hostpubip= ip_of_simulator_machine  

USERS:
Container : oda-1-node0
ODA Console: https://ip_of_simulator_machine:7095/mgmt/index.html
ODA cli access: Connect to the host and run following command:

sh connectContainer.sh -n oda-1-node0
Container : oda-1-node1
ODA Console: https://ip_of_simulator_machine:7097/mgmt/index.html 
ODA cli access: Connect to the host and run following command:
sh connectContainer.sh -n oda-1-node1

After you have completed the labs, you must clean up the environment by deleting the user containers. The following command deletes instances oda-1-node0 and oda-1-node1:

#  ./deleteOdaSimulatorContainer.sh -t ha -i 1 -n 1 -d oda 

Clean up your log files from the lab by deleting your logs in the / simulator_19.11.0.0.0/log directory.

To completely reset the lab, run the following command:

# ./cleanup_odasimulator_sw.sh 

This deletes all the containers.