3.3.1 Configuring the Environment Before Installation

Oracle VM Manager requires a system user named oracle, a group called dba, and a /u01 directory with specific permissions on installation folders. The Oracle VM Manager installation media includes a shell script, createOracle.sh, that automatically configures the environment. This script does the following:

Note

You must use the bash login shell with the oracle user to install Oracle VM Manager.

The createOracle.sh script does the following:

Creates the required operating system user, oracle, and groups, dba.
Note
The script does not set a password for the oracle user as a security measure. Because the user does not have a password, it is not possible to log in as the oracle user. If you want to allow login access, you must set the password manually.
Creates the /u01 directory, if it does not already exist, and sets permissions on required installation folders.
Note
The /u01 directory must exist before you can install Oracle VM Manager. This directory must also have 2.4 GB of space available.
Sets the required parameters in the /etc/security/limits.conf file on a Linux system.
Opens the required ports in the /etc/sysconfig/iptables file on a Linux system.

Note

You should run the createOracle.sh script if you are installing Oracle VM Manager on the system for the first time. You do not need to run this script if you are reinstalling Oracle VM Manager on the same system.

To run createOracle.sh and configure the environment, do the following:

Mount the Oracle VM Manager installation media. See Section 1.3, “Installation From DVD-ROM or CD-ROM” or Section 1.4, “Loopback ISO Mounts”.
Change directory to the mount point, for example:
```
# cd /mnt/cdrom
```
As the root user, run createOracle.sh
```
# ./createOracle.sh
```

Important

The createOracle.sh script does not automatically enable the iptables service. You should manually confirm that the iptables service is enabled.

Manually Setting Up the Oracle User

To install Oracle VM Manager, you must have an oracle user that is a member of a group named dba and which has the correct security limits set.

The environment configuration script automatically creates and configures the oracle user. As an alternative to using the script, you can set up the oracle user with the following commands:

If the oracle user does not exist on the Oracle VM Manager host, enter the following commands as the root user to create the user, create the group, add the user to the group, and set the user's password:
```
# groupadd dba
# useradd -g dba oracle
```
If the oracle user already exists, add it to the dba group using the following command:
```
# usermod -g dba oracle
```
The oracle user must also have a hard nofiles and soft nofiles minimum of at least 8192, as well as some other security limits set. To set these, edit the /etc/security/limits.conf file to include the following:
```
oracle       hard    nofile  8192
oracle       soft    nofile  8192
oracle       soft    nproc   4096
oracle       hard    nproc   4096
oracle       soft    core    unlimited
oracle       hard    core    unlimited
```