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





    Video Server Toolkit 1.2

    which includes


    VST 1.2 online documentation



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



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



     Video Server Toolkit Developer's Guide (online version)



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


    VST 1.2 man pages


     VST 1.2 base man pages


     VST 1.2 man pages for enhanced FTP daemon


     VST 1.2 release notes


     VST 1.2 base applications man pages

    which includes


    Video Server Toolkit 1.2 software



     VST 1.2 base software



     VST 1.2 clip-mirroring module



     VST 1.2 Diaquest deck-control module



     VST 1.2 DIVO video module



     VST 1.2 Viewgraphics DVB/MPEG module



     VST 1.2 configuration files for IRIS FailSafe 1.2



     VST 1.2 File System Import Monitor (FSmon)



     VST 1.2 enhanced FTP daemon



     VST 1.2 Horita time-code input module




     VST 1.2 Miranda Little Red time-code input module




     VST 1.2 Louth VDCP control module



     VST 1.2 MPEG-2 tools



     VST 1.2 O2 digital video option module


     VST 1.2 Sony protocol module



     VST 1.2 StudioCentral 2.0 archive interface


     VST base applications



     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
    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




Commands and the VST executable vvtr


Clip cache


Configuration files


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


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


Clip indices (MPEG and vframe formats)


Files used during installation


Perl modules


Core and shared libraries


External interface device/control/format modules