Go to main content
11/15

# B Oracle Secure Backup obparameters Installation Parameters

This appendix describes the installation parameters for Oracle Secure Backup on Linux or UNIX. You can set these parameters in the `obparameters` file, which is a plain text file located in the install subdirectory of the Linux or UNIX Oracle Secure Backup home.

Note:

The `obparameters` file is not used in Windows installations.

This appendix contains these sections:

- customized obparameters

- start daemons at boot

- identity certificate key size

- create preauthorized oracle user

- default UNIX user

- default UNIX group

- linux ob dir and solaris64 ob dir

- linux db dir and solaris64 db dir

- linux temp dir and solaris64 temp dir

- linux links and solaris64 links

- ask about ob dir

- default protection

- run obopenssl

## B.1 customized obparameters

If you customize any of the parameters in the `obparameters` file, then set the `customized` `obparameters` parameter to `yes`.

Table B-1 customized obparameters: Values

Value | Meaning
--- | ---
`no` (default) | Specifies that installation parameters in the `obparameters` file have not been changed. The value of `no` is set by default.
`yes` | Specifies that installation parameters in the `obparameters` file have been changed.

## B.2 start daemons at boot

The installation tools can update the control file of each host to automatically start Oracle Secure Backup each time you start the system.

Table B-2 start daemons at boot: Values

Value | Meaning
--- | ---
`no` | Specifies that the Oracle Secure Backup daemons do not start automatically at start time.
`yes` (default) | Specifies that the Oracle Secure Backup daemons start automatically at start time.

## B.3 identity certificate key size

This option configures the key size in bits, and thus the level of security, associated with every host identity certificate issued by the administrative service daemon.

The default is `1024`.

Note:

Certificate key sizes smaller than 1024 are not considered secure. Certificate key sizes of 3072 or more are considered very secure.

Table B-3 identity certificate key size: Values

Value | Meaning
--- | ---
`512` | Specifies a 512-bit long certificate key size.
`768` | Specifies a 768-bit long certificate key size.
`1024` (default) | Specifies a 1024-bit key length. This is the minimum required value for adequate security.
`2048` | Specifies a 2048-bit key length. This value offers adequate security.
`3072` | Specifies a 3072-bit key length. This value offers a very high level of security.
`4096` | Specifies a 4096-bit key length. This value offers a very high level of security.

## B.4 create preauthorized oracle user

This parameter controls whether the Oracle Secure Backup installation process creates an Oracle Secure Backup user named `oracle` which has been preauthorized to perform database backup and restore operations.

Table B-4 create preauthorized oracle user: Values

Value | Meaning
--- | ---
`yes` | An Oracle Secure Backup user is created during installation. The parameters `default` `UNIX` `user` and `default` `UNIX` `group` specify the user and group parameters with which the Oracle Secure Backup user is created.
`no` (default) | No Oracle user is created.

## B.5 default UNIX user

After the Oracle Secure Backup installation is successfully completed and the administrative domain has been initialized, you can create a default Oracle Secure Backup user named `oracle` if requested. By setting this parameter, you specify the Linux or UNIX operating system user to which the Oracle Secure Backup user named `oracle` is mapped. You can also perform this task through the Oracle Secure Backup Web tool.

See Also:

"create preauthorized oracle user"

Table B-5 default UNIX user: Values

Value | Meaning
--- | ---
`UNIX_user` | Specifies the Linux or UNIX operating system user name defined in `/etc/password` to which the Oracle Secure Backup user named `oracle` is mapped. By default, the Linux/UNIX user is named `oracle`.

## B.6 default UNIX group

After the installation is successfully completed and the administrative domain has been initialized, a default group is created on Linux or UNIX if requested. The user specified by the `default` `UNIX` `user` parameter is a member of this group.

See Also:

"create preauthorized oracle user"

Table B-6 default UNIX group: Values

Value | Meaning
--- | ---
`UNIX_group` | Specifies a Linux or UNIX group defined in `/etc/group`. By default, the Linux/UNIX group is `dba`.

## B.7 linux ob dir and solaris64 ob dir

To keep the installation and administration of Oracle Secure Backup as straightforward as possible, Oracle provides a mechanism for you to identify the name of the Oracle Secure Backup home directory for each platform in your network. This directory must be private to each platform and not shared through Network File System (NFS) or a similar remote file system.

When the installation programs install Oracle Secure Backup software, they choose these home directories for the installation or verify that these are the directories you have used. These defaults might be changed based on the availability of disk space on your computer.

Table B-7 os-name ob dir: Parameters and Values

Parameter | Meaning
--- | ---
`linux ob dir` | Specifies Oracle Secure Backup home location for Linux hosts. The default is `/usr/local/oracle/backup`.
`solaris64 ob dir` | Specifies Oracle Secure Backup home location for Solaris 64-bit hosts. The default is `/usr/local/oracle/backup`.

## B.8 linux db dir and solaris64 db dir

Each platform has a discrete directory in which Oracle Secure Backup retains host-specific information. This directory must be private to each platform and not shared through Network File System (NFS) or a similar remote file system.

Table B-8 os-name db dir: Parameters and Values

Parameter | Meaning
--- | ---
`linux db dir` | Specifies the directory where host-specific information is retained for Linux hosts. The default directory is `/usr/etc/ob`.
`solaris64 db dir` | Specifies the directory where host-specific information is retained for Solaris 64-bit hosts. The default directory is `/usr/etc/ob`.

## B.9 linux temp dir and solaris64 temp dir

Oracle Secure Backup typically uses the `/usr/tmp` directory on each host for storage of transient files. Oracle Secure Backup requires that the temporary directory be able to contain lockable files and that it be accessible during the beginning of the restart process. The directory must be on the local disk. You can specify a different directory for each platform by modifying any of these `<os-name> temp dir` parameters.

Table B-9 os-name temp dir: Parameters and Values

Parameter | Meaning
--- | ---
`linux temp dir` | Specifies the directory where transient files are stored for Linux hosts. The default directory is `/usr/tmp`.
`solaris64 temp dir` | Specifies the directory where transient files are stored for Solaris 64-bit hosts. The default directory is `/usr/tmp`.

## B.10 linux links and solaris64 links

During installation, symbolic links are created, typically in `/usr/bin` and `/etc`, so that an Oracle Secure Backup user is not required to change search paths. You can modify this behavior as follows:

- Comment out or delete these parameters if you do not want the installation programs to create any links.

- Change the value of these parameters if you want the installation programs to create links in another directory for a specific platform.

These parameters are particular to each supported platform. On some systems, it might be more appropriate to place links in `/bin` instead of `/usr/bin` or in `/usr/etc` instead of `/etc`.

This parameter must be followed by three values, in the order shown:

1. The name of the directory in which to create the bin link.

2. The name of the directory in which to create the etc link.

3. The name of the directory in which to create the lib link.

Note:

Oracle recommends using the defaults provided for this parameter.

Table B-10 os-name links: Parameters and Values

Parameter | Meaning
--- | ---
`linux links` | Specifies the directories where symbolic links are created for Linux hosts. The default directory list is `/usr/bin/etc/lib`.
`solaris64 links` | Specifies the directories where symbolic links are created for Solaris 64-bit hosts. The default directory list is `/usr/bin/etc/lib`.

Note:

If the `obparameters` file specifies a lib directory for the operating system type of the current installation, then `installob` creates a libobk.so symbolic link in that directory. That symbolic link points to the actual libobk.so file in a platform-specific lib directory in the Oracle Secure Backup home (such as.lib.linux32).

## B.11 ask about ob dir

Specifies whether the installation notifies you when you are about to install Oracle Secure Backup into a directory other than the default Oracle Secure Backup home.

Table B-11 ask about ob dir: Values

Value | Meaning
--- | ---
`yes` | Enables notification when you select a directory other than the default Oracle Secure Backup home.
`no` (default) | Suppresses notification when you select a directory other than the default Oracle Secure Backup home.

## B.12 default protection

Specifies directory and file protection information that is in effect when the Oracle Secure Backup installation is complete.

Caution:

The file protection information is provided for reference only. Oracle strongly recommends using the defaults provided because changing them can prevent the product from functioning.

Values

Each line in the `default` `protection` section of the `obparameters` file indicates the file owner, group number and permissions for the file or files specified by name, or by wildcard pattern. The default values are as follows:

    default protection:
        root.0          755 ./.wrapper
        root.0          644 ./device/*
        root.0          755 ./install/*
        root.0          644 ./help/*
        root.0          755 ./man/*
        root.0          644 ./man/man1/*
        root.0          644 ./man/man8/*
        root.0          644 ./samples/*
        root.0          755 ./samples/autoobtar
        root.0          755 ./samples/bdf2ds
        root.0          755 ./samples/*.sh
        root.0          700 ./admin
        root.0          700 ./admin/*
        root.0          700 ./admin/config/*
        root.0          755 ./.bin.*/*
        root.0         4755 ./.bin.*/obtar
        root.0         4755 ./.bin.*/obt
        root.0         4755 ./.bin.*/obtool
        root.0          755 ./.etc.*/*
        root.0         4755 ./.etc.*/obixd
        root.0         4755 ./.etc.*/observiced
        root.0         4755 ./.etc.*/obscheduled
        root.0         4755 ./.etc.*/obrobotd
        root.0          755 ./.etc.*/
        root.0         4755 ./.etc.*/doswitch
        root.0          644 ./.drv.*/*
        root.0          755 ./.lib.*/*
        root.0          755 ./*
        root.0          755 /usr/etc/ob
        root.0          644 /usr/etc/ob/.hostid
        root.0          755 /usr/etc/ob/xcr
        root.0          644 /etc/obconfig

## B.13 run obopenssl

Specifies whether the installation prompts you to create the certificates for the Apache Web server.

Note:

Oracle recommends using the default provided to ensure proper initialization of your Oracle Secure Backup Web tool.

Table B-12 run obopenssl: Values

Value | Meaning
--- | ---
`yes` (default) | Create the certificate.
`no` | Do not create the certificate.