Oracle Video Server(TM) Installation Guide: Sun SPARC Solaris
Release 2.1.7.3

A48486-2

Library

Product

Contents

Index

Prev Next

Chapter 4
Installing the Oracle Video Server Software

This chapter describes the installation of the Oracle Video Server (OVS) software on a Solaris 2.x system.

Topics covered in this chapter are:

Caution:

To provide optimum real-time performance and scalability, install OVS software on its own server computer. Installing OVS on a server computer used by other server software-such as a web server or database-may adversely affect the number of concurrent video streams that can reliably be provided.

Task 1: Mounting the Product Distribution CD-ROM

The Oracle Product Installation CD-ROM package is in RockRidge format:

Note

Under Solaris 2.x, the Solaris Volume Management software is installed by default. If you are using the Solaris Volume Management software, the CD-ROM is mounted automatically onto /cdrom/ovs and you can skip this section.

  1. Place the CD-ROM in the CD-ROM drive.
  2. Log in as the user root and create a directory for mounting the CD-ROM drive. This is referred to as the mount point directory. For example, cdrom:
    # cd /
    # mkdir cdrom
  3. Mount the CD-ROM drive on the mount point directory using -r to mount it as read-only and exit the root account.
    # mount options device_name mount_point_directory
    
The CD-ROM is now mounted.
Example
This example mounts the CD-ROM manually on /cdrom, without using Solaris Volume Management software:
# cd
# mkdir /cdrom
# mount -r -F hsfs device_name /cdrom
# exit

Task 2: Starting the Oracle Installer

Caution

Ensure that you are not logged in as the user root when you start the Oracle Installer.

  1. Mount the CD-ROM (see previous section).
  2. Log in as the user oracle and change to the orainst directory on the
    CD-ROM:
    % cd mount_point_directory/ovs/solaris/orainst
    
  3. Start the Oracle Installer with the command ./orainst:
    % ./orainst
    
The Oracle Installer will start. For information on answering Oracle Installer prompts, see Task 3: Responding to Oracle Installer Prompts below.

Task 3: Responding to Oracle Installer Prompts

This section describes the Oracle Installer prompts you see when installing OVS. Each prompt is displayed in its own window, and most prompts have defaults which you can accept by pressing [Return].

Note

The the Oracle Installer used to install OVS is a modified version of the standard Installer. The on-line help function is disabled with this release.

ORACLE_HOME Locator
  1. The Oracle Installer displays the value of the ORACLE_HOME environment variable. If you have not established ORACLE_HOME, do so now. Ensure that you wish to install OVS software here and select OK.
Note
The Oracle Installer used with OVS is a modified version of the standard Installer. Entering the ORACLE_HOME path here does not assign permissions to the directory or create the ORACLE_HOME environment variable. Perform these tasks as specified in the "Pre-Installation Tasks for the Oracle Video Server" chapter.
Installation Log Files
  1. During a first installation, the Oracle Installer creates a default log file called install.log located in the directory $ORACLE_HOME/orainst. During subsequent Oracle Installer sessions, you can choose to either append the log actions to the existing log file or create a new one.
README.FIRST File
  1. The Oracle Installer displays a README.FIRST file with last-minute product updates. Read this file for any changes relevant to your installation.
Skip README file
  1. You can specify to skip the README.FIRST file during subsequent installations.
Location of the Installation Log File
  1. This screen reports the directory that install.log will be written to.
Oracle Products to be Installed
  1. The Product available window lists the products distributed with the current release. These are:
    • Oracle Media Net (OMN)
    • OVS
OVS is selected by default. Select Install to install both OVS and OMN software. Both items must be installed.

Oracle Media Net Parameters

Note

Ensure that you use the same IP address and port number you used in Task 6: Setting Environment Variables in the "Pre-Installation Tasks for the Oracle Video Server" chapter earlier in this guide.

Specify the IP Address
  1. Specify the IP address or DNS alias of the OMN address server:
    xxx.xxx.xxx.xxx
    
Specify the UDP Port Number
  1. Specify a unique port number for the OMN address server. you must select a port number between 1024 and 65535. The default port number is 5000.
Select Message Logging Levels
  1. Select a message logging level from those listed, in order of descending importance, in Table 4-1. Selecting a higher logging level writes more information to the log file, but may affect the performance of the server as more processing power is used to track logging events.
    Table 4-1: Message Logging Levels

    1  

    Emergency  

    2  

    Action must be taken  

    3  

    Critical  

    4  

    Error, operation unsuccessful  

    5  

    Warning, operation completed  

    6  

    Normal but significant (default)  

    7  

    Informative message  

Oracle Media Data Store Parameters

The Oracle Media Data Store (MDS) parameters determine the characteristics of your MDS volume. These parameters are used to create a configuration file, called voltab, which defines the MDS volumes that OVS can access. Before continuing in this section, ensure that you have a list of all hard disks with SCSI address used by the MDS. For information on this, refer to the "System Planning for the Oracle Video Server" chapter of the Oracle Video Server Administrator's Guide for your server platform.

Ordering of Disks

The order in which the MDS disks are specified is important as it affects both the performance and reliability of OVS. The MDS issues reads and writes in units of RAID sets. Disks in a RAID set should be on different SCSI buses for improved load balancing and reliability. For this reason it is best to order disks so they alternate across different SCSI buses.

The media data store process (mdsdirsrv) produces an ordered list of disks from the shorthand notation (see the example on page 4-6) by expanding it from left to right. Each successive disk in the resulting list is on a different SCSI chain. This order ensures that RAID sets always span SCSI chains before going down the disks on a chain. Provided the number of SCSI chains equals or exceeds raidsize, each disk in a RAID set is guaranteed to be on a different chain and each disk on a chain is guaranteed to be part of a different RAID set. In the event of a SCSI bus failure, which leaves all disks on the failed SCSI chain inaccessible, data from each disk can be reconstructed from the other disks in its RAID set, all of which are located on working SCSI chains.

Note

The Oracle Installer allows the creation of only one MDS volume at initial installation. To add additional volumes, you must modify the voltab file accordingly (as discussed in the "Oracle Video Server Components Reference" chapter of the Oracle Video Server Administrator's Guide).

Name the Oracle Media Data Store
  1. Enter a name for your first MDS volume. Volume names can be from 1 to 32 characters long. The default name is video.
Number of Disk Chains to be Used
  1. Specify the number of disk chains to be used by the MDS volume. This number corresponds to the number of SCSI controllers that are controlling the MDS volume's disks. The default is one.
Number of Disks to be Used
  1. Specify the total number of hard disks used by the MDS volume to store video content. The default is one.
Note
The number of disks should not include disks being used as spare disks. Disk sparing is an optional feature that allows data from a failed disk to be rebuilt to a spare without interrupting video delivery from OVS.
Specifying Hard Disk Addresses
  1. List all disks to be used by the MDS volume in any one of the following ways:
    • individual numbers:
      /dev/rdsk/c0t0d0s6,/dev/rdsk/c1t0d0s6
      
    • lists of numbers delimited by commas:
      /dev/rdsk/c{0,1,2,3}t{2,3,4,5,6}d0s{6}
      
    • ranges of numbers using hyphens to span from lowest to highest digits (shorthand notation):
      /dev/rdsk/c{0-3}t{0-4}d0s{6}
      
    • list of disk names contained by braces and delimited by commas:
      {/dev/rdsk/c0t0d0s6,/dev/rdsk/c1t0d0s6,/dev/rdsk/c2t0d0s6,
      /dev/rdsk/c3t0d0s6,/dev/rdsk/c0t1d0s6}
Example
This example notation specifies a volume containing twelve disks, with a raidsize of 4, using four SCSI controllers:
/dev/rdsk/c{0-3}t{0-2}s6
The mdsdirsrv process expands the shorthand to a list of twelve devices on four SCSI chains:
/dev/rdsk/c0t0d0s6
/dev/rdsk/c1t0d0s6
/dev/rdsk/c2t0d0s6
/dev/rdsk/c3t0d0s6
/dev/rdsk/c0t1d0s6
/dev/rdsk/c1t1d0s6
/dev/rdsk/c2t1d0s6
/dev/rdsk/c3t1d0s6
/dev/rdsk/c0t2d0s6
/dev/rdsk/c1t2d0s6
/dev/rdsk/c2t2d0s6
/dev/rdsk/c3t2d0s6
Figure 4-1 shows the physical layout of the above expansion. The disks are read in numerical order (i.e. Disk 1, Disk 2, Disk 3, Disk 4, Disk 5, and so on).

Figure 4-1: MDS Volume showing disk layout

Figure 4-1 also depicts a spare disk, which is used in the event of a disk failure in the MDS volume. If the volume is RAID protected, the data from a failed disk can be rebuilt from the remaining disks to the spare disk. The spare disk then takes the place of the failed disk until the failed unit can be replaced.

Stripe Width
  1. Specify the stripe width to be used by the MDS volume. The default is 32K.
Note
Unless you are experienced in configuring striped volumes, and are sure your server has the required memory to make use of a greater stripe width, use the default value of 32K.
RAID Protection
  1. Select either parity (RAID) protection or non-parity for the MDS volume. Parity protection is the default setting and is strongly recommended. If you do not use parity protection and a disk or SCSI controller fails, the server will fail to deliver video. If a disk fails, the data would also be lost.
Caution
If you are only using one disk for your volume, you cannot use parity protection.
Select the Raidsize
  1. Select the raidsize of the MDS volume, the number of disks in each
    RAID set. The example given in Figure 4-1 has a raidsize of four.
Spare Disk
  1. If applicable, specify a spare disk for the MDS volume. Disk sparing is an optional feature that allows data from a failed disk to be rebuilt to a spare without interrupting your OVS service.
Example
This example specifies the fourth disk located on SCSI controller three as the spare disk (see Figure 4-1):
spares=/dev/rdsk/c3t3d0s6
The Voltab File
  1. Once you have entered your volume specification, the Oracle Installer confirms your configuration information and explains that you must use the mdsvstat utility to obtain the proper maxbw parameter:
    This is your volume configuration:
    video striped,width=32k,raidsize=4 spares=/dev/rdsk/c3t3d0s6 \
    /dev/rdsk/c{0-3}t{0-3}d0s6 You need to run mdsvstat to obtain the proper volume bandwidth, maxbw parameter, in order to use the volume as a real-time volume.
maxbw is the sustained bandwidth of the MDS volume in Mbps; without a maxbw value your volume cannot provide real-time delivery of video. To obtain the maxbw value for your volume, follow the steps in the section Enabling Real-Time Video Delivery of the "Post-Installation Tasks for the Oracle Video Server" chapter.
If the volume specification is correct, continue with the installation. Should you need to alter your configuration, select CANCEL to terminate the installation and begin the process again.

Specifying Concurrent Video Streams

Next, the Installer asks for the number of concurrent video streams to be provided by the video pump, which depends on both the I/O capabilities of your MDS volume and the processing power of your server. Carefully read the section The Number of Video Streams to be Delivered in the "System Planning for the Oracle Video Server" chapter before specifying the number of video streams.

Number of Video Streams
  1. Specify the number of video streams for the first video pump. Ensure that your hardware configuration can support the number of video streams specified.
Note
If more video streams are required, you can start one instance of the video pump for each processor your server contains (minus one to run OVS and the server operating system). For more information, refer to the The Video Pump in the "Oracle Video Server Components Reference" chapter of the Oracle Video Server Administrator's Guide.

Initializing the Oracle Media Data Store

  1. You may choose to have the Oracle Installer initialize the MDS volume for you. Before you can operate OVS, the MDS must be initialized. This process writes information from the voltab file created by the Oracle Installer to each of the disks in the MDS volume. Before selecting Yes for this option, ensure that:
    • The MDS volume configuration displayed in Step 18 is accurate.
    • The disks to be initialized are free of any necessary data or have been appropriately backed up. The initialization process will erase any data the disks contain.
    • Any previously installed OVS or OMN processes are not running.
Note
Before initializing the MDS, ensure that you have set both appropriate disk permissions and partitioned your disks as documented in the sections Task 4: Setting Disk Permissions and Task 5: Partitioning the MDS Disk Drives of Chapter 3, "Pre-Installation Tasks for the Oracle Video Server."
Caution
If you wish to modify the MDS volume in any way after installation of the OVS software, select No. For information on initializing the MDS volume after software installation, refer to Task 4: Initializing the Oracle Media Data Store later in this chapter.
  1. Selecting Yes to Step 20 causes a confirmation screen to appear. If you are certain that you wish to initialize the MDS volume at this time select Yes to confirm the initialization process. Choosing No displays a window informing you that the MDS initialization process has been terminated and returns you to the next installation step.
If you choose to initialize the MDS, a screen will appear informing you of the progress of the initialization. The Oracle Installer will inform you when the MDS volume is successfully initialized.
Note
Should the MDS initialization fail, refer to the files mdsvolinit.log, mnstart.log, and mnstop.log in the \tmp directory. These log files will alert you to any problems encountered by either the OMN startup process or the MDS initialization process.

Sample Video Content

  1. The Oracle Installer allows you to install sample video content files. We recommend that you use these files to test your system once installation is completed. The MPEG-1 encoded files require 80 MB of disk space.

Installation Completed

  1. Acknowledge this screen by selecting OK, and the Oracle Installer returns you to the Product Installation screen. Exit the Oracle Installer by pressing [Ctrl-X].

The Installed Directories

The following directories will appear under ORACLE_HOME:

.....$ORACLE_HOME/
..........bin/
..........mn30/
.............../admin
.............../log
.............../mesg
..........orainst/
..........vs21/
.............../admin
.............../demo
.............../doc
.............../log
.............../mesg
..........lib/

Configuration Files

The OVS installation creates the following configuration files:

Table 4-2: OVS Configuration Files
Configuration File   Location and Purpose  

ovsstart  

$ORACLE_HOME/vs21/admin

Shell script that starts the OVS processes.  

ovsstop  

$ORACLE_HOME/vs21/admin

Shell script that stops the OVS processes.  

mnstart  

$ORACLE_HOME/mn30/admin

Shell script that starts the OMN processes.  

mnstop  

$ORACLE_HOME/mn30/admin

Shell script that stops the OMN processes.  

voltab  

$ORACLE_HOME/vs21/admin

A description of each disk drive in the Oracle Media Data Store (MDS).  

Task 4: Initializing the Oracle Media Data Store

Note

This task assumes that you chose not to initialize the Oracle Media Data Store (MDS) during software installation (Step 20 on page 4-9). If you initialized the MDS volume at that time you may skip this task and proceed to Chapter 5, "Post-Installation Tasks for the Oracle Video Server."

Before you can operate the OVS, the MDS must be initialized. This process writes information from the voltab file (created during the installation process) to each of the MDS volume's disks.

Note

Before initializing the MDS, ensure that you have set both appropriate disk permissions and partitioned your disks as documented in the sections Task 4: Setting Disk Permissions and Task 5: Partitioning the MDS Disk Drives of
Chapter 3, "Pre-Installation Tasks for the Oracle Video Server."

To create additional MDS volumes, edit the voltab file to include additional entries for each volume you wish to add (For information on creating voltab file entries, refer to the "Oracle Video Server Components Reference" chapter of the Oracle Video Server Administrator's Guide.) You will need to initialize these volumes as well.

Perform these steps to initialize the Oracle Media Data Store:

Ensure that the Environment Variables Have Been Set

  1. Ensure that the ORACLE_HOME, OMN_ADDR, OMS_BIN, LD_LIBRARY_PATH, and PATH environment variables are set and in the .login file. For information on defining these environment variables, refer to the pre-installation chapter of this guide.
Example
To check the value of an environment variable use the echo command:
% echo $ORACLE_HOME
/home/oracle

Start Oracle Media Net

To initialize the MDS volume, you must first start OMN. OMN allows communication to take place among the OVS components so that the mdsvolinit utility can write to the MDS volume.

To start OMN:

  1. Log in as the oracle software owner and change to the directory $ORACLE_HOME/mn30/admin.
    % cd $ORACLE_HOME/mn30/admin
    
  2. Execute the script mnstart.
    % ./mnstart
    
The following OMN components will start:

Initialize the Oracle Media Data Store

  1. Initializing the Oracle Media Data Store (MDS) volume defines it with the values created for the voltab file at installation.
Initialize the MDS with the mdsvolinit utility using the -s, -t, and -f command line options as shown below:
    % mdsvolinit -s -t -f $ORACLE_HOME/vs21/admin/voltab video
    
    This command writes information from the voltab file to the MDS disks, this allows the media data store process (mdsdirsrv) to access the disks as an MDS volume set.
    Caution
    Never use mdsvolinit with these command line options unless you are creating a new MDS volume. Doing so will erase all data contained in the MDS volume.
    For more information on using mdsvolinit, refer to the "Media Data Store Utilities" chapter of the Oracle Video Server Utilities User's Guide (online only). For information on the voltab file, refer to the "Oracle Video Server Components" chapter of the Oracle Video Server Administrator's Guide.

    Stop Oracle Media Net

    1. Execute the script mnstop. This stops all Media Net components.
      % ./mnstop
      

    The MDS volume is now initialized and ready to store video content. For information on loading the Oracle provided demonstration content, refer to the section Enabling Real-Time Video Delivery of the "Post-Installation Tasks for the Oracle Video Server" chapter.




    Prev

    Next
    Oracle
    Copyright © 1997 Oracle Corporation.

    All Rights Reserved.

    Library

    Product

    Contents

    Index