2 Installing DIVArchive

This chapter describes DIVArchive software components and system installation, and includes the following information:

Software Component Relationships
DIVArchive Backup Service
Installing the DIVArchive System

Software Component Relationships

The following figure displays the relationships and dependencies among the software components of a DIVArchive system. It specifically points out the client/server links between them.

A client/server link between two components does not necessarily mean that the server software must be started before the client. For example, the DIVArchive Manager to Actor connection. Each Actor acts as a server and the Manager initiates a client connection to the Actor. However, an Actor can be launched after the Manager is running since the Manager will attempt to reconnect to the Actor at periodic intervals.

See Appendix A for DIVArchive options and licensing information.

Note:

DIVArchive can run independently of the Control GUI and Configuration Utility. They can be launched at any time after the DIVArchive Manager is running.

Software Component Distribution

The DIVArchive platform is flexible and scalable, so the installation of some software components can vary depending on the degree of storage and servers that are managed. Small installations can have all DIVArchive software components installed on a single computer. A very large installation will have these components distributed among several servers. All of these components run as system services.

The following list identifies where the components are typically installed:

DIVArchive Managers: Main and Backup DIVArchive Manager servers
DIVArchive Oracle Database: Main and Backup DIVArchive Manager servers
DIVArchive Metadata Database: Main and Backup DIVArchive Manager servers
DIVArchive Backup Service: Main and Backup DIVArchive Manager and Actor servers
DIVArchive Robot Managers: Main and Backup DIVArchive Manager servers. Robot Managers can also be installed on a separate server when the tape library is installed a substantial distance from the DIVArchive Manager servers.
DIVArchive Storage Plan Manager: Main and Backup DIVArchive Manager servers
DIVArchive VACP Services: Main and Backup DIVArchive Manager servers
DIVArchive SNMP Agent: Main and Backup DIVArchive Manager servers
DIVArchive Access Gateway: Main and Backup DIVArchive Manager servers
DIVArchive Actors: DIVArchive Actor servers
DIVArchive Transfer Manager Communicator (TMC): DIVArchive Actor servers
DIVArchive Archive Manager Communicator (AMC): DIVArchive Actor servers
DIVArchive Drop Folder Monitor (DFM): DIVArchive Actor servers

DIVArchive Backup Service

Caution:

Users should have an elevated awareness of error messages from the Backup Service. See the Oracle DIVArchive Database User's Guide in the Oracle DIVArchive Core documentation library for more information.

The DIVArchive Backup Service ensures reliability and monitoring of both the Oracle Database and Metadata Database backups.

The DIVArchive Backup Service component is installed as an integral part of the standard DIVArchive system installation. The component is typically installed on the same server as the DIVArchive Manager and Oracle Database. The DIVArchive Backup Service enables configuration of scheduled backups through its configuration file. The DIVArchive Backup Service manages and monitors the entire backup process.

When using complex objects, it is strictly required to use the Backup Service. The DIVArchive Backup Service is the only component backing up the Metadata Database and removing outdated Metadata files. When a delete request for a complex object is sent and processed, the data is removed from the Oracle Database, but the Metadata Database file is not deleted. The Metadata Database file is removed by the Backup Service after the configured clean up period (define by the Recovery Period parameter) has been reached.

Caution:

Do not change the Metadata Location parameter when the system is running.

If a database or system failure occurs, where restoring from a system backup is necessary, restoration of a stored backup is accomplished manually through existing Oracle scripts and should be performed by Oracle Support personnel only.

The DIVArchive Backup Service uses existing Oracle RMAN backup scripts to generate full database backups and incremental database backups. Oracle Database backups and Metadata Database backups are incrementally replicated to all remote backup systems by the DIVArchive Backup Service.

The DIVArchive Backup Service periodically sends status messages to the DIVArchive Manager. The DIVArchive Manager saves all error messages received in the Manager Events Log, and also forwards messages to all connected Control GUI applications to be displayed in a dialog box. If no Control GUIs are connected at the time of the error, no error dialog boxes will be displayed, but errors can be reviewed later in the Events Log.

You can configure the service to monitor specific disks for space and send warnings and errors accordingly. By default, the monitored disks are C: and H: drives. You can change this configuration modifying the MONITORED_DRIVES=d1:,d2: parameter in the Backup Service configuration file.

MONITORED_DRIVES=d1:,d2:: Identifies the drive letters to be monitored buy the DIVArchive Backup Service. The default is C: and H: and may be changed as required. The d1 and d2 represent the drive letters to backup.

Set the value for the Backup Service monitor timeout in the Configuration Utility Manager Setting tab. The default setting is fifteen minutes.

See the Oracle DIVArchive Database User's Guide in the Oracle DIVArchive Core documentation library for more information.

Installing the DIVArchive System

The following sections describe installation of the DIVArchive system. Contact Oracle Support if you need assistance.

Note:

The Oracle Database must be available for DIVArchive before installation. See "Installing and Configuring the Oracle Database" in the Oracle DIVArchive Database User's Guide.

Downloading the Software

You must stay current with the release of DIVArchive that you install and operate. Current releases of the software are found on the Oracle Software Delivery Cloud.

Use the following procedure to obtain the DIVArchive software:

Log in to the Oracle Software Delivery Cloud (https://edelivery.oracle.com) and search for DIVArchive.
Select the licenses you require (for example, DIVArchive Actor, DIVArchive Manager, and so on). You must search each time after adding a new license to the list.
Select the operating system you run for each selected license using the Select Platform button.
Continue through the download wizard, accepting the terms, until the final download screen appears.
Confirm that all the licenses you require are listed.
Click Download All on the bottom right of the screen, or click the file name link, to download the software.
Save the download where it is easily accessible.

Installing DIVArchive for Windows

Double-click the executable file to begin the installation.
After installation begins, select the components to be installed and then click Next to proceed.
Enter the desired installation folder in the Destination Folder field. Oracle highly recommends using the default installation folder (C:\DIVA). However, if another location is desired, click Browse to navigate the computer to locate the folder. Click Next.
Select Install, and then click Next.
Select the components to install, and then click Next.

Starting 7.6.2 the option to install different DIVA components such as Actors, Manager, and so on has been removed. The installer will always install all DIVA components together. If you select Database, the installer will create the DB user schema as well and you will be prompted to enter the DB information.

For 7.6.1 and earlier, after installing, the user must create the database user and schema manually. See Manually Create the Database User and Schema for 7.6.1 and below.

If upgrading 7.2.2 and lower using 7.6.2 installer, you must manually update the actor configuration and actor partial restore configuration in the database using config utility. See Actor Configuration in the Database.
Installation will continue in the specified destination folder using the selected components. The installation progress screen is displayed until installation is complete. Clicking Show Details will show the detailed progress (per file) of the installation.
The Close button will be highlighted when the wizard is finished.
Click Close to complete installation and close the program.

Manually Create the Database User and Schema for 7.6.1 and below

The database user must be created using the DIVA operating system user account. Use the following procedure to create the database user:

Open a terminal console.
Change to the DIVA_HOME/Program/Database/Core/Install directory.
Execute create_diva_user.bat (Windows) or create_diva_user.sh (Linux), which creates the given DIVA database user and its associated tables

Usage:
```
create_diva_user syspasswd username userpasswd oracle_connection [-useronly|-tablesonly] [-custom_tablespaces tables_tablespace indexes_tablespace temp_tablespace]

create_diva_user {DIVA|SYS} current_password new_password [-orapwd]
```
Parameter Definitions:
- syspasswd — Password of the Oracle 'sys' account
- username — Username to create
- userpasswd — Associated user password
- oracle_connection — Oracle TNS service name or Oracle connection string (such as IP_ADDRESS:PORT/ORACLE_SERVICE_NAME)
- DIVA|SYS — Mention either DIVA or SYS to reset the repective password in the password file
- new_password — New password
- current_password — Current password. If there is no current database password, then enter the new password for the is parameter.
- -useronly — Only creates the database user and no database objects
- -tablesonly — Only creates the database objects for the given user.
- -custom_tablespaces — Use of custom tablespaces
  - tables_tablespace — tablespace for tables
  - indexes_tablespace — tablespaces for indexes
  - temp_tablespace — database temp tablespace
- -orapwd — Option to reset/generate password file.

Installing DIVArchive for Linux

Installing DIVArchive in a Linux environment is a manual installation. The following sections describe installation procedures for DIVArchive 7.6 and above on a Linux host computer.

Prerequisites and Initial Set-up

These instructions assume that Oracle Linux 7, x86_64 or later, is installed with sqlplus, and the Oracle client.

If you require a Linux environment in a language other than English, create a user and identify the desired language in the user profile. Oracle Linux 7 x86_64 and later has support for a variety of languages (other than English) and the language can be selected during Linux installation.

For more information on Oracle Linux 7 x86_64 and later see the documentation located at https://docs.oracle.com/en/operating-systems/?tab=2, or contact Oracle Support for assistance.

Note:

Linux paths and file names are case-sensitive.

Use the following procedure to prepare for installation:

Use the following command to create a directory on the host computer:
```
mkdir /home/oracle/Downloads/DIVA_INSTALL
```
Copy the installation packages to the directory.
Confirm you have the latest DIVArchive and DIVArchive API releases and copy them into the directory you created in Step 1. The file transfer can take a bit of time due to the large file size.
If the system will have the Oracle Database server, see Oracle DIVArchive Database User's Guide to verify the system meets requirements.

Installing FTP Services

Open a terminal console on the host computer.
At the prompt enter yum install vsftpd.x86_64 and press Enter.
When prompted if it is ok to install, enter y and press Enter.
When installation is complete, start the service and confirm that it starts on system startup using the following commands:
```
service vsftpd start
chkconfig vsftpd on
```
Create a directory in the /home/diva path for managed storage and then mount the /managed partition in this location as follows:
```
mkdir /home/diva/managed
mount --bind /managed /home/diva/managed
```

Installing DIVArchive 7.6 for Linux

Starting with 7.6.2, the installer has an option to create the database user schema. If you select this option you must provide the database information.

Open a terminal console.
Use the following command to change the permissions and make the installation script executable:
```
chmod +x DIVArchive-7.6.{build_number}.sh
```
The {build_number} in this command will be the last two digits of the file name. For example, in DIVArchive-7.6.0.17.sh, the 0.17 is the build number
Use the following command to execute the installation script:
```
./DIVArchive-7.6.{build_number}.sh
```
When the Please specify diva user home directory [/home/diva] prompt is displayed, press Enter to accept the default directory.
Starting with 7.6.2, the installer can create the DB user schema using the installer. When prompted, enter the DB information.

For 7.6.1 and earlier, after installing DIVArchive youi must create the database user and schema manually. See Manually Create the Database User and Schema for 7.6.1 and below.

Installing the DIVArchive Services

You control the DIVArchive services using the divaservice script.

Open a terminal console.
Change to the /home/diva/DIVA/Program directory.

Execute the divaservice script using the following options:

Table 2-1 divaservice Script Commands

command^Foot 1	Descriptions
`divaservice configure {SERVICE_NAME}`	Configures the specified (already installed) DIVArchive service. The first time you install a service you must use the `configure` option to include the configuration settings. It will generate a configuration file, install, and then start the service.
`divaservice install {SERVICE_NAME} {configuration_file_absolute_path}`	Installs the specified DIVArchive service using the specified configuration file. If you already have a fully configured configuration file, use the install option and include the absolute path to the configuration file for that service.
`divaservice {start-all\|stop-all\|restart-all}`	Starts, stops, or restarts all of the services at the same time.
`divaservice {start\|stop\|restart\|uninstall\|status} {SERVICE_NAME}`	Starts, stops, restarts, uninstalls, or gets the current status of a specific service.
`divaservice list`	Lists the names of all currently installed DIVArchive services.
`divaservice profile`	Displays the DIVArchive services profile.
chkconfig {SERVICE_NAME} on	Use this to start the DIVArchive services when Linux starts. For example, `chkconfig DIVAmanager_manager80` on will cause the Manager service to start with Linux.

^Footnote 1{SERVICE_NAME} can be one of the following: manager, actor, robotmanager, migrate, dfm, dbbackup, lynxlocaldelete, spm, or rsync.

Example — If you are upgrading, or want to install the services with preconfigured configuration files, you can use the && command to do it consecutively (linking them together):

divaservice install manager '/home/diva/DIVA/Program/conf/manager/manager.conf' && divaservice install actor '/home/diva/DIVA/Program/conf/actor/actor.conf' && divaservice install robotmanager '/home/diva/DIVA/Program/conf/robot_manager/robotmanager.conf'

Creating Control GUI and Configuration Utility Shortcuts

You can add Control GUI and Configuration Utility shortcuts to your desktop (for easy access) using the following procedure:

Open a terminal console.
Open the gedit program with root user permissions. If you are not logged in as the root user, use the following command:
```
sudo gedit
```

To create the Control GUI shortcut, enter the following text and save the file as /usr/share/applications/diva-control-gui.desktop:

[Desktop Entry]
Version=7.6
Name=Control GUI
Comment=Oracle DIVArchive CSM
Exec=sh -c "cd /home/diva/DIVA/Program/GUI/bin/ && ./gui.sh"
Icon=/home/diva/DIVA/Program/GUI/bin/gui.ico
Terminal=false
Type=Application
Categories=Application;DIVA;Oracle;

To create the Configuration Utility shortcut, enter the following text and save the file as /usr/share/applications/diva-config-util.desktop:

[Desktop Entry]
Version=7.6
Name=Config Utility
Comment=Oracle DIVArchive Configuration Utility
Exec=sh -c "cd /home/diva/DIVA/Program/ConfigUtility/bin/ && ./configUtility.sh"
Icon=/home/diva/DIVA/Program/ConfigUtility/bin/configUtility.ico
Terminal=false
Type=Application
Categories=Application;DIVA;Oracle;

Use the following command to copy the shortcuts to the desktop after you have created both files:

cp /usr/share/applications/{diva-control-gui.desktop,diva-config-util.desktop} /home/diva/Desktop

When you click each shortcut for the first time you may be asked if you trust the file. You must confirm them as being trusted files and they will be marked trusted.

Starting, Stopping, and Accessing DIVArchive in Linux

The following aliases become available after DIVArchive installation and are defined in /home/diva/DIVA/Program/.divaenv.:

alias DIVAgui="CurrDIR=`pwd`; cd /home/diva/DIVA/Program/GUI/bin; ./gui.sh; cd ${CurrDIR}"

alias DIVAconf="CurrDIR=`pwd`; cd /home/diva/DIVA/Program/ConfigUtility/bin; ./configUtility.sh; cd ${CurrDIR}"

Note:

All Linux paths, file names and command are case-sensitive.

Use the following procedure to start DIVArchive when running in a Linux environment:

Open a terminal console.
Change to the proper directory as follows:
```
cd /home/diva/DIVA/std_linux
```
Start all DIVArchive services as follows:
```
./divaservice start-all
```
Open the Configuration Utility as follows (or use the Desktop shortcut):
```
DIVAconf
```
Use the following connection parameters:

User Name

Enter the database user name that was created.

Password

Enter the database user's associated password.

SID

Enter lib5

Service Name

Leave this field blank.

IP Address

Enter the IP address of the database host computer.

Oracle Port

Enter 1521
Open the Control GUI as follows (or use the Desktop shortcut):
```
DIVAgui
```

When shutting DIVArchive down, close the Control GUI and Configuration Utility. When they have closed, use the following command to stop all DIVArchive services:

./divaservice stop-all

You can use the following command to restart the services (if necessary) for any reason when they are already running:

./divaservice restart-all

Installing the Database

See the Oracle DIVArchive Database User's Guide.