Chapter 3. Installing Video Server Toolkit

This chapter provides a step-by-step description of installing the Video Server Toolkit (VST) software in the following sections:

Preparing for Installation

Before you install VST, make sure you have the materials required for the installation and that your workstation meets all the VST requirements. Follow these procedures:

  1. To install VST, you need the following CDs:

    • Video Server Toolkit CD

    • IRIX 6.5.4


    Note: VST was tested for compatibility with specific hardware and software configurations. Refer to the VST release notes for the configurations supported for this release.


  2. The product release notes contain the latest information for the software required to use VST, such as required patches. To read the release notes from the CD included with the product, become superuser and enter the following command:

    # /CDROM/CDgrelnotes 
    

  3. Before installing VST, install the patches required for VST, as specified in the release notes. Use Software Manager or the inst program to install any required patches.

  4. To install VST over a network, you must be successfully connected to a network. For more information about connecting to a network, consult your system administrator.

Installing VST

Once your server is properly configured, use the following procedure for installing VST over a network or from a local CD.

  1. Become a superuser by entering the following command:

    % su 
    

  2. Make sure that the sysadmdesktop.sw subsystem is present. This subsystem is included in the IRIX distribution.

  3. Start the installation program and identify the source of the VST image, as follows:

    # inst -f servername:distribution_directory 
    

    For example, if you are installing over the network, use a line similar to the following:

    # inst -f host1 :dist/vst/dist 
    

    Or, if you are installing from a CD, use

    # inst -f cdHost:/CDROM/dist 
    

    Or, if you are installing from a local CD, use

    # inst -f /CDROM/dist

  4. List the subsystems to install as follows:

    Inst> l 
    

    This command lists all the subsytems to install; Table 3-1 summarizes them.

    Table 3-1. VST Default and Optional Subsystems

    Systems and Subsystems

    Default

    Description

    vst_eoe

    Yes

    Video Server Toolkit 1.2

    vst_eoe.books
    which includes

     

    VST 1.2 online documentation

     vst_eoe.books.AdminGuide

     

     Video Server Toolkit Installation and Administration Guide  (this manual, online version)

     vst_eoe.books.AdminGuideHTML

     

     Video Server Toolkit HTML Installation and Administration Guide (online version)

     vst_eoe.books.DevelGuide

     

     Video Server Toolkit Developer's Guide (online version)

     vst_eoe.books.DevelGuideHTML

     

     Video Server Toolkit HTML Developer's Guide (online version)

    vst_eoe.man
    which includes

    Yes

    VST 1.2 man pages

     vst_eoe.man.base

     

     VST 1.2 base man pages

     vst_eoe.man.ftpd

     

     VST 1.2 man pages for enhanced FTP daemon

     vst_eoe.man.relnotes

     

     VST 1.2 release notes

     vst_eoe.man.tools

     

     VST 1.2 base applications man pages

    vst_eoe.sw
    which includes

     

    Video Server Toolkit 1.2 software

     vst_eoe.sw.base

     

     VST 1.2 base software

     vst_eoe.sw.clipmirror

     

     VST 1.2 clip-mirroring module

     vst_eoe.sw.diaquest

     

     VST 1.2 Diaquest deck-control module

     vst_eoe.sw.divo

     

     VST 1.2 DIVO video module

     vst_eoe.sw.dvb-vg

     

     VST 1.2 Viewgraphics DVB/MPEG module

     vst_eoe.sw.failsafe

     

     VST 1.2 configuration files for IRIS FailSafe 1.2

     vst_eoe.sw.fsmon

    Yes

     VST 1.2 File System Import Monitor (FSmon)

     vst_eoe.sw.ftpd

    Yes

     VST 1.2 enhanced FTP daemon

     vst_eoe.sw.horita

     

     VST 1.2 Horita time-code input module

     

     vst_eoe.sw.little-red

     

     VST 1.2 Miranda Little Red time-code input module

     

     vst_eoe.sw.louth

     

     VST 1.2 Louth VDCP control module

     vst_eoe.sw.mpeg

     

     VST 1.2 MPEG-2 tools

     vst_eoe.sw.o2video

     

     VST 1.2 O2 digital video option module

     vst_eoe.sw.sony

     

     VST 1.2 Sony protocol module

     vst_eoe.sw.studiocentral

     

     VST 1.2 StudioCentral 2.0 archive interface

     vst_eoe.sw.tools

    Yes

     VST base applications

     vst_eoe.sw.vela

     

     VST Vela SCSI MPEG-2 decoder module

     


  5. Mark for installation any optional VST related software you might need. For example, if you are using a DIVO board, or the DVB-ASI, Louth, MPEG, Sony, or Vela protocols, install one or more of the following options, as appropriate:

    Inst> i vst_eoe.sw.divo
    Inst> i vst_eoe.sw.dvb-vg
    Inst> i vst_eoe.sw.louth
    Inst> i vst_eoe.sw.mpeg
    Inst> i vst_eoe.sw.sony
    Inst> i vst_eoe.sw.vela
    

  6. Initiate the installation, as follows:

    Inst> go
    

  7. Quit the installation program, as follows:

    Inst> quit
    

  8. To run a secondary server that takes over VST operations when the primary server fails, repeat all preceding steps for the secondary server(s). Following instructions in Chapter 5, “Configuring for Redundancy,” install IRIS FailSafe or configure the secondary server(s) for clip mirroring.

Confirming the Installation

To confirm the successful installation of VST, complete the following steps:

  1. Start VST by entering the following command as a superuser:

    # /usr/vtr/bin/vtrstart 
    


    Note: On an O2 workstation, the VST window is displayed.


  2. To see if VST started, enter

    # /usr/vtr/bin/vtrstat 
    

    (The utility vtrstat is described in “vtrstat” in Chapter 8.) If VST is running, the response is as follows:

    Video server on hostname is running.
    

  3. Verify the media ports are supported by entering

    # /usr/vtr/bin/vtrstat -ports 
    

    vtrstat lists the supported ports; for example:

    #  Port    Type    Description
    ----------------------------------------------------------
    0  dq_0    Deck    Diaqusest Deck Control
    1  DIVO_0  Video   SGI XT-DIVO Digital Video Option
    2  DIVO_1  Video   SGI XT-DIVO Digital Video Option
    3  DIVO_3  Video   SGI XT-DIVO Digital Video Option
    4  DIVO_4  Video   SGI XT-DIVO Digital Video Option
    5  DIVO_5  Video   SGI XT-DIVO Digital Video Option
    6  DIVO_6  Video   SGI XT-DIVO Digital Video Option
    7  DIVO_7  Video   SGI XT-DIVO Digital Video Option
    

You can also confirm the installation by examining the server log for startup messages: the contents of the /usr/vtr and /var/adm/vtr/logs directories:

# more /usr/vtr/adm/logs/vtrlog

Logging begins with output like the following:

I 22-10:46:31.484095  55938 ---- LOGGING STARTS ----
I 22-10:46:31.484885  55938 VCP-Recorder starting
I 22-10:46:35.979391  55938 System:
I 22-10:46:35.979682  55938   Platform: Origin 200 GIGAchannel (hostname=oo7 serial=690d416b)
I 22-10:46:35.979809  55938   Processors: 2x225MHz R10000 (IP27)
I 22-10:46:35.979970  55938   Secondary Cache: 2 Mbytes
I 22-10:46:35.980128  55938   Memory: 512 Mbytes
I 22-10:46:35.980261  55938 Video devices:
I 22-10:46:35.980377  55938   DIVO_DVC_0 (module=1/GIGAchannel slot=12 serial=HTM962 part=030-1387-001E)
I 22-10:46:35.980501  55938     DVCPRO_CODEC (serial=HTM769 part=030-1388-001B)
I 22-10:46:35.980756  55938     DVCPRO_CODEC (serial=HTM802 part=030-1388-001B)
I 22-10:46:35.981005  55938   DIVO_DVC_1 (module=1/GIGAchannel slot=13 serial=HTM970 part=030-1387-001E)
I 22-10:46:35.981181  55938     DVCPRO_CODEC (serial=HTM789 part=030-1388-001B)
I 22-10:46:35.981586  55938     DVCPRO_CODEC (serial=HTM810 part=030-1388-001B)
I 22-10:46:35.981718  55938   DIVO_DVC_2 (module=1/GIGAchannel slot=14 serial=HJH608 part=030-1387-001E)
I 22-10:46:35.981844  55938     DVCPRO_CODEC (serial=HJH541 part=030-1388-001B)
I 22-10:46:35.981964  55938     DVCPRO_CODEC (serial=HJH546 part=030-1388-001B)
I 22-10:46:35.982120  55938   DIVO_DVC_3 (module=1/GIGAchannel slot=15 serial=HJH287 part=030-1387-001E)
I 22-10:46:35.982346  55938     DVCPRO_CODEC (serial=HJH644 part=030-1388-001B)
I 22-10:46:35.982479  55938     DVCPRO_CODEC (serial=HJH553 part=030-1388-001B)
I 22-10:46:35.982599  55938 Audio devices:
I 22-10:46:35.982713  55938   RAD1 (module=1/GIGAchannel pci=2)
I 22-10:46:35.982830  55938   RAD2 (module=1/O200 pci=5)
I 22-10:46:35.982948  55938   RAD3 (module=1/O200 pci=6)
I 22-10:46:35.983206  55938   RAD4 (module=1/O200 pci=7)

The crash directory contains crash files for the VST executable vvtr.

Table 3-2 describes directories in /usr/vtr.

Table 3-2. /usr/vtr Subdirectories

Subdirectory

Description

bin/*

Commands and the VST executable vvtr

clips/*

Clip cache

config/*

Configuration files

data/*

Files in this directory are static data or image files used by various VST components

images/*

The directory in which still images are created when the MediaCache VTR Control Protocol (MVCP) CIMG command is executed (this command is explained in the Video Server Toolkit Developer's Guide

index/*

Clip indices (MPEG and vframe formats)

install/

Files used during installation

lib/perl

Perl modules

lib32/*.so

Core and shared libraries

lib32/modules/*.so

External interface device/control/format modules