Chapter 8 —
Sample Listings

8.1 About This Chapter

> > This chapter provides sample listings for the following procedures:

> > - Installation of MMS on an AlphaStation system running DIGITAL UNIX V4.0
> > - Deinstallation of MMS on an AlphaStation system running DIGITAL UNIX V4.0
> > - Installation verification procedure (IVP) for MMS on an AlphaStation system running DIGITAL UNIX V4.0

8.2 Sample Installation Dialog

> The following example shows an installation of MMS on an AlphaStation system running DIGITAL UNIX V4.0.

    # setld -l .

    Multimedia Services V2.4 for DIGITAL UNIX

    Copyright Digital Equipment Corporation 1993, 1997. All rights reserved.

    Restricted Rights: Use, duplication, or disclosure by the U.S. Government is
    subject to restrictions as set forth in subparagraph (c) (1) (ii) of
    DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as
    applicable.

    This software is proprietary to and embodies the confidential technology of
    Digital Equipment Corporation.  Possession, use, or copying of this software
    and media is authorized only pursuant to a valid written license from Digital
    or an authorized sublicensor.

    Press RETURN to continue

    The subsets listed below are optional:

         There may be more optional subsets than can be presented on a single
         screen. If this is the case, you can choose subsets screen by screen
         or all at once on the last screen. All of the choices you make will
         be collected for your confirmation before any subsets are installed.

     - Development Kit:
         1) Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages
         2) Multimedia Services V2.4 for DIGITAL UNIX Development

     - Documentation Kit:
         3) Multimedia Services V2.4 for DIGITAL UNIX Development Documentation
         4) Multimedia Services V2.4 for DIGITAL UNIX Documentation
         5) Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation
         6) Multimedia Services V2.4 for DIGITAL UNIX Release Notes

     - Hardware Option Support for PCI/EISA/ISA Bus Machines:
         7) FullVideo Basic (AV201) Device Support V2.4
         8) FullVideo Supreme (AV321/AV301) Device Support V2.4
         9) Microsoft Sound Board Device Support V2.4
        10) Personal Workstation Audio (ES1888/7) Device Support V2.4

     - Hardware Option Support for TURBOchannel Bus Machines:
        11) Base Board Audio Device Support V2.4
        12) Sound and Motion (J300) Device Support V2.4

     - Run-Time Kit:
        13) Multimedia Services V2.4 for DIGITAL UNIX CDE Integration
        14) Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages
        15) Multimedia Services V2.4 for DIGITAL UNIX Runtime
        16) Multimedia Services V2.4 for DIGITAL UNIX Sample Data

    Or you may choose one of the following options:

        17) ALL of the above
        18) CANCEL selections and redisplay menus
        19) EXIT without installing any subsets

    Enter your choices or press RETURN to redisplay menus.

    Choices (for example, 1 2 4-6):

    The subsets listed below are optional:

         There may be more optional subsets than can be presented on a single
         screen. If this is the case, you can choose subsets screen by screen
         or all at once on the last screen. All of the choices you make will
         be collected for your confirmation before any subsets are installed.

     - Development Kit:
         1) Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages
         2) Multimedia Services V2.4 for DIGITAL UNIX Development

     - Documentation Kit:
         3) Multimedia Services V2.4 for DIGITAL UNIX Development Documentation
         4) Multimedia Services V2.4 for DIGITAL UNIX Documentation
         5) Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation
         6) Multimedia Services V2.4 for DIGITAL UNIX Release Notes

     - Hardware Option Support for PCI/EISA/ISA Bus Machines:
         7) FullVideo Basic (AV201) Device Support V2.4
         8) FullVideo Supreme (AV321/AV301) Device Support V2.4
         9) Microsoft Sound Board Device Support V2.4
        10) Personal Workstation Audio (ES1888/7) Device Support V2.4

     - Hardware Option Support for TURBOchannel Bus Machines:
        11) Base Board Audio Device Support V2.4
        12) Sound and Motion (J300) Device Support V2.4

     - Run-Time Kit:
        13) Multimedia Services V2.4 for DIGITAL UNIX CDE Integration
        14) Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages
        15) Multimedia Services V2.4 for DIGITAL UNIX Runtime
        16) Multimedia Services V2.4 for DIGITAL UNIX Sample Data

    Or you may choose one of the following options:

        17) ALL of the above
        18) CANCEL selections and redisplay menus
        19) EXIT without installing any subsets

    Enter your choices or press RETURN to redisplay menus.

    Choices (for example, 1 2 4-6): 17

    You are installing the following optional subsets:

     - Development Kit:
            Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages
            Multimedia Services V2.4 for DIGITAL UNIX Development

     - Documentation Kit:
            Multimedia Services V2.4 for DIGITAL UNIX Development Documentation
            Multimedia Services V2.4 for DIGITAL UNIX Documentation
            Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation
            Multimedia Services V2.4 for DIGITAL UNIX Release Notes

     - Hardware Option Support for PCI/EISA/ISA Bus Machines:
            FullVideo Basic (AV201) Device Support V2.4
            FullVideo Supreme (AV321/AV301) Device Support V2.4
            Microsoft Sound Board Device Support V2.4
            Personal Workstation Audio (ES1888/7) Device Support V2.4

     - Hardware Option Support for TURBOchannel Bus Machines:
            Base Board Audio Device Support V2.4
            Sound and Motion (J300) Device Support V2.4

     - Run-Time Kit:
            Multimedia Services V2.4 for DIGITAL UNIX CDE Integration
            Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages
            Multimedia Services V2.4 for DIGITAL UNIX Runtime
            Multimedia Services V2.4 for DIGITAL UNIX Sample Data

    Is this correct? (y/n): y

    Checking file system space required to install selected subsets:

    File system space checked OK.

    16 subset(s) will be installed.

    Loading 1 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Release Notes
       Copying from . (disk)
       Verifying

    Loading 2 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Runtime
       Copying from . (disk)
            Working....Tue Jun 10 08:15:31 EDT 1997
       Verifying

    Loading 3 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX CDE Integration
       Copying from . (disk)
       Verifying

    Loading 4 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages
       Copying from . (disk)
       Verifying

    Loading 5 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Sample Data
       Copying from . (disk)
       Verifying

    Loading 6 of 16 subset(s)....

    *****
         You have selected the installation of the
         FullVideo Basic AV201 Device Support V2.4.

         This involves rebuilding the DIGITAL UNIX kernel.  You will also
         be prompted to specify a kernel configuration file to use to
         rebuild the DIGITAL UNIX kernel.

         If you have questions about rebuilding the kernel or about kernel
         configuration files please refer to the DIGITAL UNIX Guide to System
         Administration.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a PCI system (Personal Workstation or AlphaStation).

    Do you wish to install the FullVideo Basic AV201 Device Support V2.4
    at this time? (y/n) [y]:

    FullVideo Basic (AV201) Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 7 of 16 subset(s)....

    *****
         You have selected the installation of the
         Sound and Motion (J300) Device Support V2.4.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a TURBOchannel system (DEC 3000 workstation).

    Do you wish to install the Sound and Motion (J300) Device Support V2.4
    at this time? (y/n) [y]:

    Sound and Motion (J300) Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 8 of 16 subset(s)....

    *****
         You have selected the installation of the
         FullVideo Supreme AV301/AV321 Device Support V2.4.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a PCI system (Personal Workstation or AlphaStation).

    Do you wish to install the FullVideo Supreme AV301/AV321 Device Support V2.4
    at this time? (y/n) [y]:

    FullVideo Supreme (AV321/AV301) Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 9 of 16 subset(s)....

    *****
         You have selected the installation of the
         Personal Workstation Audio (ES1888/7) Device Support V2.4.
         This device driver supports the Personal Workstation a series
         built-in audio device.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a EISA or ISA system (Personal Workstation).

    Do you wish to install the Personal Workstation Audio (ES1888/7) Device Support V2.4
    at this time? (y/n) [y]:

    Personal Workstation Audio (ES1888/7) Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 10 of 16 subset(s)....

    *****
         You have selected the installation of the
         Microsoft Sound Board Device Support V2.4.
         This device driver supports the Microsoft Sound Board,
         the AlphaStation Sound Card, the built-in audio hardware shipped
         with certain AlphaStation systems, as well as most ISA bus option
         sound cards which are compatible to the Microsoft Sound Board.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a EISA or ISA system (Personal Workstation, AlphaStation workstation,
         or DEC 2000 Model 300).

    Do you wish to install the Microsoft Sound Board Device Support V2.4
    at this time? (y/n) [y]:

    Microsoft Sound Board Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 11 of 16 subset(s)....

    *****
         You have selected the installation of the
         Base Board Audio Device Support V2.4.

         DO NOT INSTALL this subset unless you will be running this kernel
         on a TURBOchannel system (DEC 3000 workstation).

    Do you wish to install the Base Board Audio Device Support V2.4
    at this time? (y/n) [y]:

    Base Board Audio Device Support V2.4
       Copying from . (disk)
       Verifying

    Loading 12 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Development
       Copying from . (disk)
       Verifying

    Loading 13 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages
       Copying from . (disk)
       Verifying

    Loading 14 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Development Documentation
       Copying from . (disk)
       Verifying

    Loading 15 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Documentation
       Copying from . (disk)
       Verifying

    Loading 16 of 16 subset(s)....

    Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation
       Copying from . (disk)
       Verifying

    16 of 16 subset(s) installed successfully.

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Release Notes" (MMERELNOTES240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Runtime" (MMERT240)

    Do you want to enable scripts that automatically start the
    Multimedia Services V2.4 for DIGITAL UNIX Runtime
    mmeserver daemon every time the system is booted? (y/n) [y]:

    Multimedia Services V2.4 for DIGITAL UNIX Runtime
    mmeserver daemon will be started automatically every time the system is booted.

    *****
         Since you are installing one or more hardware device support subsets,
         you will not be able to run the IVP for Multimedia Services
         for DIGITAL UNIX Runtime V2.4 now.

         The IVP for Multimedia Services for DIGITAL UNIX Runtime V2.4
         may be executed at a later time by issuing the command
         # setld  -v MMERT240

    Press RETURN to continue

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX CDE Integration" (MMERTCDE240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages" (MMEMANRT240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Sample Data" (MMERTSMPLDAT240)

    Configuring "FullVideo Basic (AV201) Device Support V2.4" (MMEDRVAV201240)

    *********************************************************************
    * Preparing to Rebuild Kernel in order to complete installation.
    *********************************************************************

    Do you want to use an existing kernel configuration file? (y/n) [y]:

    Enter a name for the kernel configuration file. [TOBIN]:

    You selected TOBIN, is this correct? (y/n) [y]:

         You have selected the FullVideo Basic AV201 Device Support V2.4.

    Configuring "Sound and Motion (J300) Device Support V2.4" (MMEDRVAV300240)

    *****
         No TURBOchannel bus specified in the config file.
         The Sound and Motion (J300) Device Support V2.4 is only useful in a
         TURBOchannel machine kernel.

         Deleting subset MMEDRVAV300240

    Deleting "Sound and Motion (J300) Device Support V2.4" (MMEDRVAV300240).

    Configuring "FullVideo Supreme (AV321/AV301) Device Support V2.4" (MMEDRVAV3X1240)

         You have selected the FullVideo Supreme AV301/AV321 Device Support V2.4.

    Configuring "Personal Workstation Audio (ES1888/7) Device Support V2.4" (MMEDRVMMSESS240)

    Configuring "Microsoft Sound Board Device Support V2.4" (MMEDRVMSB240)

    *****
         It appears that your system is currently configured for a
         Microsoft Sound Board. We recommend that you simply
         continue with the installation to upgrade your drivers, unless:

         1. you have just upgraded your firmware
         2. you have just installed a new Microsoft Sound Board or plan to do so
         3. you have just changed the settings on the Microsoft Sound Board

         If any of these are true, you can find more information in the
         configuration information below. Otherwise, press Y below to
         continue with the installation.

         Your system appears to have an ISA bus.  You may press "I" for
         additional ISA bus hardware configuration information and then press "D"
         for additional detailed information about the console command isacfg.

    Select one of the following options:
         E     EISA bus hardware configuration information
         I     ISA bus hardware configuration information
         D     Detailed isacfg information
         Y     Yes, install the Microsoft Sound Board subset now
         N     No, do not install the Microsoft Sound Board subset now

    Do you wish to install the Microsoft Sound Board option module
    device driver at this time? (e/i/d/y/n) [y]:

         You have selected the Microsoft Sound Board Device Support V2.4.

    *********************************************************************
    *  Rebuilding the Kernel
    *********************************************************************

         You have selected one or more kernel drivers.
         In order to use these drivers you must rebuild your kernel.
         You may do so now, or at a later time. If for instance, you are
         installing other layered products with kernel drivers, you
         might choose to rebuild the kernel after installing those
         products.

    Do you wish to rebuild the kernel at this time? (y/n) [y]:
       Copying /sys/conf/.product.list to TOBIN.list

    *** KERNEL CONFIGURATION AND BUILD PROCEDURE ***

    Saving /sys/conf/TOBIN as /sys/conf/TOBIN.bck

    Do you want to edit the configuration file? (y/n) [n]:

    *** PERFORMING KERNEL BUILD ***
            Working....Tue Jun 10 08:19:10 EDT 1997
            Working....Tue Jun 10 08:21:11 EDT 1997

    The new kernel is /sys/TOBIN/vmunix

            1) Copy your old kernel from /vmunix to /vmunix.save

               # cp /vmunix /vmunix.save

            2) Move the new kernel to /vmunix

               # mv /usr/sys/TOBIN/vmunix /vmunix

            3) Shutdown and reboot your system, after
               giving proper warning to any other users.

               # /usr/sbin/shutdown -r +2 \
                 "Shutting down to use new kernel, rebooting immediately"

    Configuring "Base Board Audio Device Support V2.4" (MMEDRVBBA240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Development" (MMEDEV240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages" (MMEMANDEV240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Development Documentation" (MMEDOCDEV240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Documentation" (MMEDOC240)

    Configuring "Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation" (MMEDOCHW240)

8.3 Sample Deinstallation Dialog

> The following example shows a deinstallation of MMS on an AlphaStation system running DIGITAL UNIX V4.0.

    # setld -i d `setld -i | grep MME | grep installed | awk '{print $1}'`

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Hardware Option Documentation" (MMEDOCHW240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Documentation" (MMEDOC240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Development Documentation" (MMEDOCDEV240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Development Man Pages" (MMEMANDEV240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Development" (MMEDEV240).

    Deleting "Base Board Audio Device Support V2.4" (MMEDRVBBA240).

    Deleting "Microsoft Sound Board Device Support V2.4" (MMEDRVMSB240).

         You have deleted the Microsoft Sound Board Device Support V2.4.

    *****
         Since you are deleting one or more kernel subsets, the existing kernel
         is no longer valid.  You will be prompted to rebuild the kernel.
         You will also be prompted to specify a kernel configuration file
         to use to rebuild the DIGITAL UNIX kernel.

         If you have questions about rebuilding the kernel or about kernel
         configuration files please refer to the DIGITAL UNIX Guide to System
         Administration.

    Do you wish to rebuild the kernel at this time? (y/n) [n]:

    Deleting "Personal Workstation Audio (ES1888/7) Device Support V2.4" (MMEDRVMMSESS240).

    Deleting "FullVideo Supreme (AV321/AV301) Device Support V2.4" (MMEDRVAV3X1240).

         You have deleted the FullVideo Supreme AV301/AV321 Device Support V2.4.

    *****
         Since you are deleting one or more kernel subsets, the existing kernel
         is no longer valid.  You will be prompted to rebuild the kernel.
         You will also be prompted to specify a kernel configuration file
         to use to rebuild the DIGITAL UNIX kernel.

         If you have questions about rebuilding the kernel or about kernel
         configuration files please refer to the DIGITAL UNIX Guide to System
         Administration.

    Do you wish to rebuild the kernel at this time? (y/n) [n]:

    Deleting "FullVideo Basic (AV201) Device Support V2.4" (MMEDRVAV201240).

         You have deleted the FullVideo Basic AV201 Device Support V2.4.

    *****
         Since you are deleting one or more kernel subsets, the existing kernel
         is no longer valid.  You will be prompted to rebuild the kernel.
         You will also be prompted to specify a kernel configuration file
         to use to rebuild the DIGITAL UNIX kernel.

         If you have questions about rebuilding the kernel or about kernel
         configuration files please refer to the DIGITAL UNIX Guide to System
         Administration.

    Do you wish to rebuild the kernel at this time? (y/n) [n]:

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Sample Data" (MMERTSMPLDAT240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Runtime Man Pages" (MMEMANRT240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX CDE Integration" (MMERTCDE240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Runtime" (MMERT240).

    Deleting "Multimedia Services V2.4 for DIGITAL UNIX Release Notes" (MMERELNOTES240).

8.4 Sample Installation Verification Procedure (IVP)

> The following example shows an installation verification procedure (IVP) for MMS on an AlphaStation system running DIGITAL UNIX V4.0.

    # setld -v MMERT240

    Multimedia Services V2.4 for DIGITAL UNIX Runtime (MMERT240)
    Multimedia Services V2.4 for DIGITAL UNIX

    Installation Verification Procedure

    Copyright Digital Equipment Corporation 1993, 1997. All rights reserved.

    Restricted Rights: Use, duplication, or disclosure by the U.S. Government is
    subject to restrictions as set forth in subparagraph (c) (1) (ii) of
    DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as
    applicable.

    This software is proprietary to and embodies the confidential technology of
    Digital Equipment Corporation. Possession, use, or copying of this software
    and media is authorized only pursuant to a valid written license from Digital
    or an authorized sublicensor.

    Hit  to continue:
                                    Testing Audio
    ------------------------------------------------------------------------

    Accessing all Wave Out Devices:
    ===============================

    Device 0 is the Microsoft Sound Board device.
    Device 1 is the Personal Workstation Audio (ES1888/1887) device.

    Would you like to play a short clip on one of the Wave Out Devices? (y/n) [y]:

    Please specify a device number [0]:
    Device number selected is  0
    Playing...
    Playback Complete.
                                    Testing Video
    -----------------------------------------------------------------------
    Device Name: J321       ID: 1
    Device Name: SJPG       ID: 2

    Would you like to play a short video clip to the display device? (y/n) [y]:

    Please specify a device number [1]:
    Device number selected is  1
    mme_ivp_video: Decompressor: J321 device
              File Format: MJPG 24-bit
              Display Format: BITF 32-bit
    mme_ivp_video: Visual selected: 24-bit TrueColor

    Multimedia Services V2.4 for DIGITAL UNIX IVP SUCCEEDED