--------------------------------------------------------------------------- Multimedia Services for Digital UNIX Installation Guide --------------------------------------------------------------------------- Order Number: AA-Q66GH-TE July 1996 The Multimedia Services for Digital UNIX Installation Guide describes how to install the Multimedia Services for Digital UNIX (MMS) Run-time environment and the Developer's Kit on DEC 3000 and AlphaStation workstations running the Digital UNIX operating system. Revision/Update This document supersedes the Information: Multimedia Services for Digital UNIX Installation Guide, Version 2.1. Operating System: Digital UNIX Version 3.2 and above, up to and including V4.0 Software Product MMS for Digital UNIX Version 2.2 Version: Digital Equipment Corporation Maynard, Massachusetts July 1996 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraphs (c)(l)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. (c) Digital Equipment Corporation 1993, 1996. All rights reserved. The following are trademarks of Digital Equipment Corporation: Alpha, AlphaStation, AXP, Bookreader, CDA, DDIF, DEC, Digital UNIX, DECpresent, DECspin, DECvoice, DECwrite, Digital, Livelink, NAS, PowerStorm, TURBOchannel, VAX, and the DIGITAL logo. The following are third-party trademarks: Microsoft is a registered trademark and Windows and Windows NT are trademarks of Microsoft Corporation. OSF and OSF/1 are registered trademarks of the Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems Incorporated. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. All other trademarks and registered trademarks are the property of their respective holders. This document is available on CD-ROM. Preface About this Guide This guide describes how to install the Multimedia Services for the Digital UNIX (MMS) run-time environment and the developer's kit on DEC 3000 and AlphaStation workstations running the Digital UNIX operating system. make the same as the abstractKeep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Multimedia Services for Digital UNIX, if necessary. Difference between MMS and MME -- The three-letter acronym, MMS (Multimedia Services) is used in this guide as an abbreviation of the product name. MMS is also used in the developer's license PAK name. MME (Multimedia Extensions) is the prefix used in all product subset names. Purpose and Audience This guide is intended for system managers and others who install Multimedia Services for Digital UNIX. The release notes are intended for all users of Multimedia Services for Digital UNIX. See Section 2.2 for more information about the release notes. This guide's organization is listed below: Chapter Description Chapter 1 Quick Install Chapter 2 Preparing for Installation Chapter 3 Installing MMS Chapter 4 Running the Installation Verification Procedure Chapter 5 Operating System Upgrade Warning Chapter 6 Microsoft Sound Board Installation and Configuration Details Chapter 7 Subset Listings Chapter 8 Sample Listings Chapter 9 Files Installed on Your System Conventions This guide uses the following conventions: Convention Explanation % The percent sign is the default user prompt. # The number sign is the default superuser prompt. boldface text Boldface text indicates user input in interactive examples. filesystem Monospaced typeface indicates the exact name of a command, routine, partition, path name, directory, or file. This typeface is also used in interactive examples and other screen displays. UPPERCASE and The Digital UNIX operating system is lowercase case sensitive, which means that it differentiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. [y] Brackets enclose the default response in a prompt. For example, [y] means that the default response is yes. Output Text The output of a command is displayed in this color font. Unless otherwise noted, press Return or Enter after entering commands or responses to command prompts. On-line Help Multimedia Services on-line help is accessible in two forms: * Reference Pages --Invoke Reference Page help from the UNIX command line with the man command. * HTML Hypertext -- Start Netscape hypertext help by launching Netscape and loading install_guide.html. This file can be found at /usr/opt/MME220/html_docs/install_guide.html. This file is available only if the MMEDOC220 subset is installed. Software Distribution Multimedia Services for Digital UNIX is distributed in several ways: * Digital UNIX Software Product Library CD-ROM (SPL) * Digital UNIX Associated Products CD-ROM with the Digital UNIX Operating System (DUAP) Note Not all versions of Multimedia Services for Digital UNIX are shipped with the DUAP CD-ROM. Refer to the Digital UNIX documentation to find out which release of Multimedia Services for Digital UNIX is shipped with the DUAP. * Factory Installed Software (FIS) Use the bill of materials (BOM) to check the contents of your Multimedia Services for Digital UNIX software distribution kit. In addition to this guide, the software distribution kit includes a: * CD-ROM optical disc for systems with optical disc drives * CD-ROM booklet and CD-ROM "Read Before Using" letter If your software distribution kit is damaged or incomplete, contact your Digital representative. Multimedia Services for Digital UNIX Documentation In addition to this guide, the Multimedia Services for Digital UNIX documentation set includes: * Multimedia Services for Digital UNIX Release Notes This document contains information which became available too late to be included in the offical product documentation. It is important to read this guide throughly before attempting to install or use MMS. need put the real reason for the release notes here. pickup from chapter 1 section on release notes. * Multimedia Services for Digital UNIX Application User's Guide This guide contains instructions for using the applications included in the Multimedia Services for Digital UNIX run-time environment. The run-time environment is bundled at no charge with all Alpha workstations running the Digital UNIX operating system. * Multimedia Services for Digital UNIX Programmer's Guide This guide contains information about using the Multimedia Services for Digital UNIX application programming interface (API) to develop applications that use multimedia features. * Multimedia Services for Digital UNIX Software Product Description (SPD) expand definition of what the SPD isThe Software Product Description is a synopsis of this product's features and functionality. It contains a complete listing of hardware requirements. The following table lists all the MMS documentation and its location. Documentation availability might vary based on what subsets you have installed. Table 1 -- Complete Listing of MMS Documentation (Titles and Locations) When MMERT220 is installed: This file contain links to all of the files below that are installed. HTML Index: To view the online documentation with a web browser, you can load the file: /usr/opt/MMERT220/html_docs/MultimediaServices.html When MMERELNOTES220 is installed: Release Notes: /usr/opt/MME220/ascii_docs/release_notes.txt /usr/opt/MME220/ps_docs/release_notes.ps /usr/opt/MME220/html_docs/release_notes.html Cover Letter: /usr/opt/MME220/ascii_docs/cover_letter.txt /usr/opt/MME220/ps_docs/cover_letter.ps /usr/opt/MME220/html_docs/cover_letter.html SPD: /usr/opt/MME220/ascii_docs/spd.txt /usr/opt/MME220/ps_docs/spd.ps When MMEDOC220 is installed: Installation Guide: /usr/opt/MME220/ps_docs/install_guide.ps.Z /usr/opt/MME220/html_docs/install_guide.html Application User's /usr/opt/MME220/ps_docs/runtime_guide.ps.Z Guide: /usr/opt/MME220/html_docs/runtime_guide.html When MMEDOCHW220 is installed: Hardware Owner's /usr/opt/MME220/ps_docs/AlphaStation200SoundCard_OwnersGuide.ps.Z Guides: /usr/opt/MME220/ps_docs/AlphaStationSoundCard_PBXJA_OwnersGuide.ps.Z /usr/opt/MME220/ps_docs/FullVideoSupreme_AV301_AV321_OwnersGuide.ps.Z /usr/opt/MME220/ps_docs/FullVideo_AV201_OwnersGuide.ps.Z /usr/opt/MME220/ps_docs/SoundAndMotion_J300_OwnersGuide.ps.Z When MMEDOCDEV220 is installed: Programmer's Guide: /usr/opt/MME220/ps_docs/prog_guide.ps.Z /usr/opt/MME220/book_docs/prog_guide.decw_book When the Software Product Library CD is mounted on /cdrom: Release Notes: /cdrom/mme220/documentation/mme220_relnotes.ps /cdrom/mme220/documentation/mme220_relnotes.txt Installation Guide: /cdrom/mme220/documentation/mme220_iguide.ps Cover Letter: /cdrom/mme220/documentation/mme220_cover.ps /cdrom/mme220/documentation/mme220_cover.txt SPD: /cdrom/mme220/documentation/mme220_spd.ps /cdrom/mme220/documentation/mme220_spd.txt When the Online Documentation Library CD is mounted on /cdrom: Programmer's Guide: /cdrom/decw_book When the Associated Products CD is mounted on /cdrom: Release Notes: /cdrom/DOCUMENTATION/POSTSCRIPT/MME220_RELNOTES.ps /cdrom/DOCUMENTATION/TEXT/MME220_RELNOTES.txt /cdrom/DOCUMENTATION/HTML/MME220_RELNOTES.html Installation Guide: /cdrom/DOCUMENTATION/POSTSCRIPT/MME220_IGUIDE.ps SPD: /cdrom/DOCUMENTATION/POSTSCRIPT/MME220_SPD.ps /cdrom/DOCUMENTATION/TEXT/MME220_SPD.txt Application User's /cdrom/DOCUMENTATION/Multimedia_Services/POSTSCRIPT/runtime_guide.ps Guide: If the MMEMANRT subset is installed, online descriptions of the installed applet programs can be found in the Digital UNIX Reference Pages, Section 1, using the man(1) command. For an overview of all the man pages in this subset, enter the following command: %man mms If the MMEMANDEV subset is installed, online descriptions of the function calls can be found in the Digital UNIX Reference Pages, Section 3, using the man(1) command. For an overview of all the man pages in this subset, enter the following command: %man mmsdev --------------------------------------------------------------------------- Master Table of Contents --------------------------------------------------------------------------- Frontmatter Chapter 1 - Quick Install Chapter 2 - Preparing for Installation o About This Chapter o Accessing the Release Notes o Registering the Software License o Requirements + Disk-Space Requirements o Installation Considerations + Configuring the Product for a Particular Installation + Installing from Media or Using RIS + Backing Up Your System Disk Chapter 3 - Installing Multimedia Services for Digital UNIX o About This Chapter o Deleting Multimedia Services for Digital UNIX from Your System o Installing Multimedia Services for Digital UNIX + Installing from the CD-ROM Distribution Media + Installing from the RIS Distribution Area o Preliminary Messages + Development Kit Requirements Missing + CDE Not Installed + Operating System Version Mismatch + Different Version of MMS Installed + License Not Installed o Selecting Subsets o Pre-Loading Messages + MMS and CDE Interaction Problems + C++ Runtime Library Requirements o Monitoring Displays During the Subset Loading Process o Configuration Phase Messages + Automatically Starting MMESERVER Daemon + Running the Installation Verification Procedure o Messages for Device-Support Subsets + Device-Support Subset Installation Confirmation + Selecting a Kernel Configuration File + Hardware Bus Validation + Rebuilding the Kernel + Inadequate Disk Space for New Kernel o System Files Modified + Magic File + Mailcap File Chapter 4 - Running the Installation Verification Procedure Chapter 5 - Operating System Upgrade Warning Chapter 6 - Microsoft Sound Board Installation and Configuration Details o About This Chapter o EISA Bus + EISA Bus Information + Microsoft Sound Board Configurations + Known Problems + Installing an EISA Bus Driver o ISA Bus + ISA Bus Information + Installing the MSB Driver on ISA Bus Machines + ISA Configuration Utility Chapter 7 - Installed Subsets o About this chapter o Products and Distributions o Documentation Subsets o Run-time Kit Subsets o Hardware-Option Subsets (for PCI/EISA/ISA bus machines) o Hardware-Option Subsets (for TURBOchannel bus machines) o Development Kit Subsets Chapter 8 - Sample Listings o About This Chapter o Sample Installation Dialog o Sample Deinstallation Dialog o Sample Installation Verification Procedure (IVP) Chapter 9 - Files Installed on Your System o About This Chapter o Installed Files o Files Installed by the MMEDEV220 Subset o Files Installed by the MMEDOC220 Subset o Files Installed by the MMEDOCDEV220 Subset o Files Installed by the MMEDOCFT220 Subset o Files Installed by the MMEDOCHW220 Subset o Files Installed by the MMEDRVAV201220 Subset o Files Installed by the MMEDRVAV300220 Subset o Files Installed by the MMEDRVAV3X1220 Subset o Files Installed by the MMEDRVBBA220 Subset o Files Installed by the MMEDRVMSB220 Subset o Files Installed by the MMEMANDEV220 Subset o Files Installed by the MMEMANRT220 Subset o Files Installed by the MMERELNOTES220 Subset o Files Installed by the MMERT220 Subset o Files Installed by the MMERTCDE220 Subset o Files Installed by the MMERTSMPLDAT220 Subset --------------------------------------------------------------------------- Chapter 1 - MMS Quick Install --------------------------------------------------------------------------- Please read the rest of this guide carefully before you begin installation, if * You have never installed a setld kit * You have never rebuilt a kernel The installation procedure has been written in such a way that just by picking the default responses, it is possible to successfully install MMS. The development subset, MMEDEV220 requires the license PAK MMS-DK to be installed and loaded. Refer to Section 2.3 for instructions on how to register license PAKs. Use this command, # /usr/sbin/setld -l . MME*220 to install the MMS kit from the distribution media. This command will attempt to install all subsets appropriate for your machine's hardware and software configuration. Select the default responses. Pay careful attention to the output messages in case any problems are encountered by the installation procedure. --------------------------------------------------------------------------- Chapter 2 -- Preparing for Installation --------------------------------------------------------------------------- 2.1 About This Chapter Before starting the installation procedure in Chapter 3, complete the preinstallation tasks explained in this chapter. This chapter provides the following information to make your installation run smoothly: * Accessing the Release Notes * Registering the Software License * Hardware, Software, and Subsets Requirements o Disk-Space Requirements * Installation Considerations o Configuring the Product for a Particular Installation o Installing from Media or Using RIS o Backing Up Your System Disk Note You must login as root or become superuser to install the Multimedia Services for Digital UNIX software and register the license PAK. 2.2 Accessing the Release Notes Multimedia Services for Digital UNIX is delivered with release notes. This document contains information that became available too late to be included in the official product documentation. It is important to read this throughly before attempting to install or use MMS. See Table 1 in the Preface for more information about the various locations where you can find the release notes. 2.3 Registering the Software License The subsets in the Runtime product do not require a license PAK. You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use Multimedia Services for Digital UNIX Development Kit on a newly licensed node. The License PAK, MMS-DK might be shipped with the kit if you ordered the licenses and media together; otherwise, they are shipped separately to a location specified on your license order. To register a license with the Digital UNIX operating system Installing Task/Location Action Result Register 1. Log in as root. At LMF displays a blank template license via LMF the superuser prompt, and invokes an editor to allow at the UNIX edit an empty PAK you to edit the template. LMF command line template with the lmf invokes the editor that is register command as defined by your EDITOR follows, and include environment variable. If the all the information on environment variable is your License PAK: undefined, LMF invokes the vi editor. # lmf register You must enter the license information from the PAK accurately. 2. When you finish LMF copies it into the license entering the license Database. If the license data data and you are sure is incorrect, you can reenter it is correct, exit the editor and correct all from the editor. mistakes. Load the 3. After you register For complete information on license into your license, use the using the License Management the kernel following commands to Facility, see the Guide to copy the license Software License Management and details from the the lmf(8) manpage. license database (LDB) to the kernel cache: # lmf load 0 MMS-DK 2.4 Requirements Installing Multimedia Services for Digital UNIX takes approximately 15 minutes, depending on your type of media and system configuration. Check for the following requirements. Hardware To install Multimedia Services for Digital UNIX, you need the following hardware: 1. Software distribution device (if installing from media) Locate the CD-ROM drive for the CD-ROM software distribution media. The CD booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media. 2. See the Multimedia Services for Digital UNIX Software Product Description (SPD) for additional hardware requirements. Software Multimedia Services for Digital UNIX Version 2.2 requires the Digital UNIX operating system V3.2 or above, up to and including V4.0. Future Multimedia Services for Digital UNIX releases might require higher versions. Subsets You must choose the Multimedia Services for Digital UNIX subsets that you want to load. See Chapter 7 for a complete listing of each subset and its requirements. Some subsets will not install or function properly depending on your machine's specific hardware and software configuration. 2.4.1 Disk-Space Requirements Table 2-2 lists the disk space requirements for loading Multimedia Services for Digital UNIX software subsets. These requirements apply to the disks where you load the Multimedia Services for Digital UNIX subsets. Table 2-2 -- Multimedia Services for Digital UNIX Disk Space Requirements (in Kilobytes) Category Subset / /usr /var Development MMEDEV220 0 1536 0 MMEMANDEV220 0 870 0 subtotals Runtime MMEMANRT220 0 137 0 MMERT220 9 8044 0 MMERTCDE220 62 153 0 MMERTSMPLDAT220 0 6214 0 subtotals PCI/EISA/ISA MMEDRVAV201220 29 426 0 MMEDRVAV3X1220 28 752 0 MMEDRVMSB220 28 416 0 subtotals TURBOchannel MMEDRVAV300220 35 1025 0 MMEDRVBBA220 0 143 0 subtotals Documentation MMEDOC220 6 1244 0 MMEDOCDEV220 2 2732 0 MMEDOCHW220 2 1872 0 MMERELNOTES220 2 930 0 subtotals Totals Using these disk space requirements, total the values for the subsets you will load in each directory. Compare the space required for subsets with the free space currently on the disks where Multimedia Services for Digital UNIX files will reside. To check the current amount of free space for a directory path, log in to the system where you will install Multimedia Services for Digital UNIX. To check the total space and the free space for the directories where Multimedia Services for Digital UNIX will reside, enter the df command. For example: # df -k /usr Filesystem 1024-blocks Used Avail Capacity Mounted on /dev/rz0e: 577143 266656 252772 51% /usr The display shows there are 252,772 kilobytes available. This free space must accommodate the subset requirements listed in Table 2-2 . 2.5 Installation Considerations Before you install Multimedia Services for Digital UNIX you should consider the following. * Configuring the product for a particular installation * Installation from CD or RIS distribution area * Backing up your system disk 2.5.1 Configuring the Product for a Particular Installation MMS contains a daemon program, mmeserver, which can be configured as follows. The mmeserver uses the system.ini all file names should be in Courier fontfile to load the drivers at startup. An alternate file can be specified at the time of mmeserver startup for any of the following reasons: * Installations might not be interested in any of the audio or video drivers * The Software JPEG CODEC might be preferred over other codecs * The built-in audio might be preferred over other audio devices To create an alternate file, copy the /var/mme/system.ini file into another file and make the changes to that new file. This file can be specified as the one to use during mmeserver startup by modifying the appropriate line in the startup script /sbin/init.d/mmeserver. Note Simultaneous audio and video (video capture, video playback, codec) operations on the Sound and Motion J300 option card are not supported on DEC 3000 Models 300, 300X, and 300LX. Enabling both of these components can crash or hang the system, thus requiring a system reboot. Three separate configuration files are created for DEC 3000 Model 300 systems during installation. The configuration files can be found in /var/mme. By default, only the video portion of the Sound and Motion J300 option is enabled. If a particular installation requires a different configuration, the appropriate file must be specified in the startup script. Refer to the /var/mme/system.ini(4) reference page for information about the file. 2.5.2 Installing from Media or Using RIS Someone from your site must perform at least one Multimedia Services for Digital UNIX installation from the distribution media. Your site system manager can then decide whether to make a Multimedia Services for Digital UNIX distribution kit available on line so that subsequent installations of Multimedia Services for Digital UNIX can use the Remote Installation Services (RIS). For information on loading Multimedia Services for Digital UNIX subsets to an RIS distribution area, see the Guide to Sharing Software on a Local Area Network. If you expect to use Multimedia Services for Digital UNIX subsets from the RIS area of a remote system for installation on your local system, first check with your site system manager to ensure the following: * A Multimedia Services for Digital UNIX network kit is available for use. * Your system is registered as an RIS client. If Multimedia Services for Digital UNIX subsets are available to you on an RIS server system, you must know the name of that system. For more information about installing Multimedia Services for Digital UNIX from an RIS distribution area, see Section 3.3.2. 2.5.3 Backing Up Your System Disk Digital recommends that you back up your system disk before installing any software. For information about backing up your system disk, see the Digital UNIX system documentation. --------------------------------------------------------------------------- Chapter 4 - Running the Installation Verification Procedure --------------------------------------------------------------------------- This chapter explains what you need to do after the installation to make Multimedia Services for Digital UNIX ready for use. You can run the Installation Verification Procedure (IVP) during the installation, or you can run the IVP independently after installing Multimedia Services for Digital UNIX to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access Multimedia Services for Digital UNIX. If you are not installing any device support subsets, you are prompted at the end of the installation as to whether you want to run the IVP. If you install any of the device support subsets, you will not be prompted to run the IVP. Device support subsets require that a new kernel be booted, and because the IVP may depend on these subsets, you must reboot your system before running the IVP. You will need to run the IVP separately from the installation, as noted below, so that the device support subsets can be tested by the IVP. The Multimedia Services for Digital UNIX IVP verifies the installation as follows: * If the mmeserver is not already running, an attempt to start the server is made. If the server is not running one second after the attempt to start it, then the IVP fails. * A program (/usr/sbin/mme_ivp_audio_devices) to access all waveIn devices and all waveOut devices is run. For the devices that are found, the device numbers assigned to those devices and the names of the devices are listed. * At the option of the user, a program (/usr/sbin/mme_ivp_audio_play) to play audio on a user-specified device is run. If the program encounters any errors, then the IVP fails. * A similar verification of the video devices is done by running mme_ivp_video, which first lists the devices and then plays a preselected video clip on the X Display. When running the IVP, the superuser must have access to the X Display. The Multimedia Services Run-Time Sample Data subset must be installed. * If none of the previous errors has occurred, then the IVP succeeds. To run the IVP after an installation, enter the following command: # /usr/sbin/setld -v MMERT220 For a sample Multimedia Services for Digital UNIX IVP, see Section 8.4. If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem. --------------------------------------------------------------------------- Chapter 3 — Installing Multimedia Services for Digital UNIX --------------------------------------------------------------------------- 3.1 About This Chapter This chapter gives you step-by-step procedure for installing Multimedia Services for Digital UNIX. The installation for MMS contains the following steps: * Deleting MMS from your system * Installing MMS * Preliminary Messages * Selecting Subsets * Pre-loading Messages * Monitoring Displays During the Subset Loading Process * Configuration Phase Messages * Messages for Device-Support Subsets * System Files Modified Before you start the installation, read Chapter 2. Note You can interrupt the installation procedure at any point. However, if you do, the installation might not be left in a useful state. You should remove all the subsets you installed and reinstall them. The installation procedure allows you to use an existing kernel configuration file and update it for any Multimedia Services driver. If you have any questions about rebuilding the kernel or kernel configuration files, refer to the Digital UNIX (formerly DEC OSF/1) System Administration manual or see your system administrator. Note You must login in as root or become superuser to install Multimedia Services for Digital UNIX software and to register the license PAK. 3.2 Deleting Multimedia Services for Digital UNIX from Your System If you must remove a version of Multimedia Services for Digital UNIX from your system, delete each subset that you previously installed. To delete subsets, do the following: 1. Enter the following form of the setld command to delete all of the installed subsets of Multimedia Services: # setld -d `setld -i | grep MME | grep installed | awk '{print $1} '` Note If you are immediately reinstalling one or more of the Multimedia Services device drivers, you will not need to rebuild the kernel during deinstallation. See Section 8.3 for an sample listing of a deinstallation of Multimedia Services. 3.3 Installing Multimedia Services for Digital UNIX You can either install MMS from the CD-ROM distribution media or a RIS distribution area. 3.3.1 Installing from the CD-ROM Distribution Media The following procedure loads Multimedia Services for Digital UNIX files onto your system. The procedure works for the following products: * Digital UNIX Software Product Library (SPL) * Digital UNIX Associated Products (shipped with the Digital UNIX operating system) (DUAP) Installing Multimedia Services for Digital UNIX from CD-ROM: Task/Location Action Result Locate the 1. If you have the SPL, appropriate consult the Digital CD-ROM and UNIX Alpha Software determine the Product Library Master user Index to determine distribution which CD-ROM contains list the MMS product. -- or -- If you have the Digital UNIX operating system distribution media, the MMS product is located on the Volume I of the DUAP CD-ROM. 2. Insert CD-ROM. (Make sure to use the caddy if required.) UNIX Command 3. Use the following The following example shows Line file command to find output similar to what the file the device name for the command returns. Note that the CD-ROM drive line for the CD-ROM drive includes an item starting with RRD. # file /dev/rrz*c | grep RRD file /dev/rrz4c: character special (8/4098) SCSI #0 RRD44 disk #32 (SCSI ID #4) (SCSI LUN #0) offline 4. If necessary, create a directory that will be the mount point for the CD-ROM, using a command in the following format: # mkdir /mount-point For example: # mkdir /cdrom 5. Mount the CD-ROM using the -r option to indicate that the CD-ROM is read only. Use a command in the following format: # mount -r /dev/rzunit_numberc /mount-point Where: unit-number is a variable that represents your disk-drive unit number mount-point is the mount point that was just created For example: # mount -r /dev/rz4c /cdrom 6. Enter a setld command This requests the load function (-l) and identifies the directory in the mounted file system where Multimedia Services for Digital UNIX subsets are located. For the Digital # /usr/sbin/setld -l /cdrom/mme220/kit UNIX Software Product Library -- or -- For the Digital # /usr/sbin/setld -l UNIX Associated /cdrom/ALPHA/Multimedia_Services Products The installation procedure now displays the names of Multimedia Services for Digital UNIX subsets and asks you to specify the subsets you want to load. 3.3.2 Installing from the RIS Distribution Area If you are installing Multimedia Services for Digital UNIX subsets that reside in an /etc/ris RIS distribution area on a remote system, take the following steps: To Install Multimedia Services for Digital UNIX from the RIS Distribution Area Task/Location Action Result Load the subsets 1. Enter a setld -l Requests the load function (-l command. For example, option) and identifies the if you are loading system where the Multimedia Multimedia Services for Services for Digital UNIX Digital UNIX subsets subsets are located. from an RIS distribution area on node axpmme, enter the following: # /usr/sbin/setld -l axpmme The installation procedure now displays the names of Multimedia Services for Digital UNIX subsets and asks you to specify the subsets you want to load. 3.4 Preliminary Messages The following messages might appear before you are presented with a list of subsets available for installation. 3.4.1 Development Kit Requirements Missing The Multimedia Services for Digital UNIX Development Kit contains some sample code that requires the X Window Software Development subset to be installed. If you do not have this subset installed, the following warning will appear: Advisory: In order to build the Makefiles and some of the sample code in the Multimedia Services for Digital UNIX Development Kit V2.2 you need to have the OSFCMPLRS Compiler Back End Software Development subset and the OSFXDEV X Window Software Development subset from the BASE OS installed. The Multimedia Services for Digital UNIX Development Kit V2.2 subset does not require the OSFCMPLRS or OSFXDEV subsets for installation purposes. The Development kit will still install, but you will only be able to build the sample code if you install the Software Development subsets, and you will only be able to build some of the video samples if you install the X Window Software Development subset from the Digital UNIX distribution. 3.4.2 CDE Not Installed The Multimedia Services for Digital UNIX CDE Integration subset requires CDE to be installed. Minimum CDE support has varied between operating system releases so the required CDE subset might be one of three possible subsets: OSFCDEDT, CDEART, or CDEMIN. One of these must be installed before installing the MMERTCDE220 subset. If these are not installed, the following message will appear and the MMERTCDE220 subset will not appear on the menu of installable subsets: The Multimedia Services for Digital UNIX CDE Integration V2.2 requires the existence of one of the following uninstalled CDE Desktop for Digital UNIX subsets(s): OSFCDEDT CDEART CDEMIN Please install one of these subsets before installing the MMERTCDE220 subset. The MMERTCDE subset will not appear in the menu of installable subsets. 3.4.3 Operating System Version Mismatch All of the subsets require a minimum version of the operating system. Some subsets might require a higher version due to hardware support and features supported in later versions. If the subset requires a higher version of operating system than you have installed, the following message will be displayed: The Multimedia Services for Digital UNIX Development V2.2 requires that the following operating system be installed: Digital UNIX Version 3.0 or later Please install one of these operating system versions before installing the MMERT220 subset. If the minimum operating system requirements are not met, the subset cannot be installed and will not appear on the menu of available subsets. Some subsets might not be validated against later releases of the operating system, particularly if the Multimedia Services kit is much older than the operating system you have installed. If this is the case, the following warning is displayed: The Multimedia Services for Digital UNIX Runtime V2.2 might not be fully supported on Digital UNIX versions following Digital UNIX V4.0 Install the MMERT subset at your own risk. 3.4.4 Different Version of MMS Installed If you currently have Multimedia Services installed, setld will not allow you to install a new version. However, if you do not have all of the Multimedia Services subsets installed, or there are new subsets in the current release, then setld will attempt to install all of the subsets not currently installed. When setld does this, the Multimedia Services installation will detect that portions of an older Multimedia Services kit are installed and will display the following message: A different version of Multimedia Services for Digital UNIX already exists. You must deinstall the following subset(s) before installing Microsoft Sound Board Device Support V2.2: MMERT200 MMEDEV200 You will then be asked if you want to delete these older subsets now. Would you like to deinstall these subsets now? (y/n) [y]: If you choose yes, the installation procedure will remove the old subsets and display the following status: *** Beginning deinstallation of MMEDEV200 MMERT200 *** Deleting "Multimedia Services for Digital UNIX Runtime V2.0" (MMERT200). Deleting "Multimedia Services for Digital UNIX Development V2.0" (MMEDEV200). *** Done with deinstallation of MMEDEV200 MMERT200 *** If you choose not to deinstall the subsets now, the following message will be displayed: You must deinstall the following subset(s) before installing Microsoft Sound Board Device Support V2.2: MMERT200 MMEDEV200 You might do so by issuing the command # setld -d MMERT200 MMEDEV200 The MMEDRVMSB subset will not appear in the menu of installable subsets. Some of the subset names have changed between releases.The setld utility does not understand this change but the Multimedia Services installation procedure does. For instance, you might already have MMEDRVPCI200 installed and the new name for this subset is MMEDRVAV3X1220. The Multimedia Services installation procedure detects this condition and will display the following message: The MMEDRVPCI200 subset is already installed. Deinstall the subset to re-install the subset MMEDRVAV3X1220 FullVideo Supreme (AV321/AV301) Device Support V2.2. The procedure then continues as in the previous example to ask you if you want to delete the existing subset or not. Finally, if a previous installation left a subset installed in a corrupted state, the setld utility will simply attempt to install the new subset. The Multimedia Services installation procedure cannot install over a corrupted subset. The following message will be displayed: The MMERT subset is already installed in a corrupted state. Deinstall the subset to re-install the subset MMERT220 Multimedia Services for Digital UNIX Runtime V2.2. The procedure then continues as in the previous example to ask you if you want to delete the existing subset or not. 3.4.5 License Not Installed Some subsets require LMF licenses before installation. If the licenses are not currently installed, the following message is displayed: Multimedia Services for Digital UNIX Development Kit requires a license. This product will not be installed without a license. Refer to the LMF guide for installing a license for this subset before installation of the MMEDEV220 subset. The product name for the required license is MMS-DK or MMS-DK-USER. 3.5 Selecting Subsets You must specify which Multimedia Services for Digital UNIX subsets you want to load. The subsets listed below are optional: There might 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 for Digital UNIX Development Man Pages V2.2 2)Multimedia Services for Digital UNIX Development V2.2 - Documentation Kit: 3)Multimedia Services for Digital UNIX Documentation V2.2 4)Multimedia Services for Digital UNIX Release Notes V2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: 5)FullVideo Basic (AV201) Device Support V2.2 6)FullVideo Supreme (AV321/AV301) Device Support V2.2 7)Microsoft Sound Board Device Support V2.2 - Hardware Option Support for TURBOchannel Bus Machines: 8)Base Board Audio Device Support V2.2 9)Sound and Motion (J300) Device Support V2.2 - Run-Time Kit: 10)Multimedia Services for Digital UNIX UNIX CDE Integration V2.2 11)Multimedia Services for Digital UNIX Runtime Man Pages V2.2 12)Multimedia Services for Digital UNIX Runtime V2.2 13)Multimedia Services for Digital UNIX Sample Data V2.2 Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): Or you might choose one of the following options: 14)ALL of the above 15)CANCEL selections and redisplay menus 16)EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 14 Next, the procedure lets you verify your choice. For example, if you enter 14 in response to the previous prompt, you will see the following display: You are installing the following optional subsets: - Development Kit: Multimedia Services for Digital UNIX Development Man Pages V2.2 Multimedia Services for Digital UNIX Development V2.2 - Documentation Kit: Multimedia Services for Digital UNIX Documentation V2.2 Multimedia Services for Digital UNIX Release Notes V2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: FullVideo Basic (AV201) Device Support V2.2 FullVideo Supreme (AV321/AV301) Device Support V2.2 Microsoft Sound Board Device Support V2.2 - Hardware Option Support for TURBOchannel Bus Machines: Base Board Audio Device Support V2.2 Sound and Motion (J300) Device Support V2.2 - Run-Time Kit: Multimedia Services for Digital UNIX CDE Integration V2.2 Multimedia Services for Digital UNIX Runtime Man Pages V2.2 Multimedia Services for Digital UNIX Runtime V2.2 Multimedia Services for Digital UNIX Sample Data V2.2 Is this correct? (y/n): y If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed, and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. 3.6 Pre-Loading Messages This section describes the messages that might appear after the installation has selected the subsets to be installed. 3.6.1 MMS and CDE Interaction Problems When installing the MMERTCDE220 on Digital UNIX 4.0, the CDE desktop may not be properly updated to reflect the newly installed icons and actions. ***** The Multimedia Services for Digital UNIX CDE Integration V2.2 adds new application actions and a Multimedia Application Group to the CDE Desktop. These new items could not be automatically updated for the Desktop. Possible reasons are: + CDE is not properly installed + CDE dependencies are not properly installed + The installer does not currently have access to the X Display on this system To have the changes activated, you must log out of the current CDE session and login again. On installations with versions of Digital UNIX prior to V4.0 installed, a similar message may be displayed: ***** The Multimedia Services for Digital UNIX CDE Integration V2.1 adds new application actions and a Multimedia Application Group to the CDE Desktop. These new items could not be automatically updated for the Desktop due to deficiencies in the ADK for CDE. These problems have been resolved with the CDE Desktop shipped with Digital UNIX 4.0. To have the changes activated, you must log out of the current CDE session and log in again. In either case, the installer may have to log out and log back in again to have CDE updated. 3.6.2 C++ Runtime Library Requirements The MMERT subset has several applets that require the C++ Runtime Library. Without this library, the applets will not run. If you intend to use any of these applets, you should install the C++ Runtime Library. If the installation scripts detect that you do not have the C++ Runtime Library installed, you will see the following message: ***** Several Multimedia Services applets require the DEC C++ Runtime. You do not currently have the DEC C++ Runtime installed on your system. The Multimedia Services for Digital UNIX Runtime subset will still be installed but several applets might not run, i.e., you might see the following type of error indicating the C++ (libcxx.so) library cannot be loaded: 801:alphavcr: /sbin/loader: Fatal Error: cannot map libcxx.so Would you like instructions for loading the C++ Runtime? (y/n) [y]: If you answer y for more information, the following instructions will help guide your installation of the C++ Runtime Library. You can find the DEC C++ Runtime on the Digital UNIX (previously DEC OSF/1) operating system or on the Digital UNIX Software Product Library cdrom. The product is formally named "DEC C++ Runtime Library for DEC OSF/1 Systems". You must follow the instructions in the Digital UNIX or Software Product Library installation guide for mounting and accessing the 'C++ Runtime installation kit' but the following instructions might suffice: For the Digital UNIX cdrom: # mount -o ro /dev/rz?c /cdrom # cd /cdrom/ALPHA/DEC_C++_RTL # setld -l . CXXSHRDA??? For the Software Product Library cdrom # mount -o ro /dev/rz?c /cdrom # cd /cdrom/cxx??? # setld -l . CXXSHRDA??? where /dev/rz?c is the device name of your cdrom device (see the installation guide for instructions for determining this device name). 3.7 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected Multimedia Services for Digital UNIX subsets. The following example shows a display where Multimedia Services for Digital UNIX subsets are being loaded. A message similar to the following is displayed for each subset: Multimedia Services for Digital UNIX Release Notes V2.2 Copying from /usr/local/kit (disk) Verifying When you see the "Verifying" message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an Installation Verification Procedure (IVP) message. During the installation, if you get errors from the setld utility, see the Diagnostics section of the setld(8) reference page for an explanation of the errors and the appropriate actions to take. 3.8 Configuration Phase Messages The following messages are displayed during the configuration of the Multimedia Services for Digital UNIX kit. 3.8.1 Automatically Starting MMESERVER Daemon The Multimedia Services server can be run as a daemon on your system and can be started automatically at boot time. The installation procedure asks if you wish to enable this automatic startup as follows: Configuring "Multimedia Services for Digital UNIX Runtime V2.2" (MMERT220) Do you want to enable scripts that automatically start the Multimedia Services for Digital UNIX Runtime mmeserver daemon every time the system is booted? (y/n) [y]: If you answer yes, the installation procedure will display: Multimedia Services for Digital UNIX Runtime mmeserver daemon will be started automatically every time the system is booted. If you answer no, the installation procedure will display instructions as to how to enable this feature at a later time. The Multimedia Services for Digital UNIX Runtime mmeserver daemon will NOT be started automatically every time the system is booted. To automatically start the product, reconfigure this subset by issuing the following command as superuser: # /usr/sbin/setld -c MMERT220 INSTALL 3.8.2 Running the Installation Verification Procedure If you are currently running an mmeserver process, the installation script will ask if you want to stop the server process. This is recommended because the previous server version will be running, not the newly installed version. There is an mmeserver daemon running. Do you want to stop it? (y/n) [y]: If you are installing any device support subsets, the following message will be displayed: 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.2 now. The IVP for Multimedia Services for Digital UNIX Runtime V2.2 might be executed at a later time by issuing the command # setld -v MMERT220 If you are not installing any device support subsets, the following message will be displayed: You might request execution of the IVP for Multimedia Services for Digital UNIX Runtime V2.2 now. The IVP for Multimedia Services for Digital UNIX Runtime V2.2 might be executed at a later time by issuing the command: #setld -v MMERT220 Would you like to run the IVP for Multimedia Services for Digital UNIX Runtime V2.2 now? (y/n) [y] If you answer yes, then an installation verification procedure will be run. The installation verification is highly dependent on the subsets that you have installed and the multimedia hardware installed on your system. See Chapter 4 for more information. 3.9 Messages for Device-Support Subsets This section contains information on the messages displayed during the configuration phase of the device-support subsets. 3.9.1 Device-Support Subset Installation Confirmation During this phase of the installation procedure, if you have selected any device support subsets, you will be presented with the following information. The first subset displays the following: You have selected the installation of the FullVideo Basic AV201 Device Support. 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 (AlphaStation workstation). Do you wish to install the FullVideo Basic AV201 Device Support at this time? (y/n) [y]: The first part of this message identifies the subset currently being installed. The next two parts warn the installer that a kernel rebuild will be required. More information about rebuilding the kernel can be found in the Digital UNIX System Administration manual. However, the installation procedure will guide you to the best answers for most situations. Simply selecting the defaults should be what most installations require. The last part of this message identifies the bus requirements to support the hardware option. A later phase in the installation will prompt you for kernel configuration information and at that time the installation procedure will verify that your system or target system will support the hardware option. If you are unsure what bus your system has, allow the installation procedure to attempt to install the subset, and the installation procedure will later automatically deconfigure the subset if the system will not support the hardware option. After the first device support subset is installed, the other device support subsets will print out an abbreviated message containing only the first and last parts, such as: You have selected the installation of the FullVideo Supreme AV301/AV321 Device Support. DO NOT INSTALL this subset unless you will be running this kernel on a PCI system (AlphaStation workstation). Do you wish to install the FullVideo Supreme AV301/AV321 Device Support at this time? (y/n) [y]: 3.9.2 Selecting a Kernel Configuration File Once all of the device-support subsets are installed, you are asked the following questions during the configuration of the first device support subset: ***************************************************************** Preparing to Rebuild Kernel in order to complete installation. **************************************************************** Do you want to use an existing kernel configuration file? (y/n)[y]:Y Enter a name for the kernel configuration file. [CHONJI]:CHONJI You selected CHONJI, is this correct? (y/n) [y]:Y 3.9.3 Hardware Bus Validation Unless you are positive that you understand how to rebuild a kernel with a new configuration file, use an existing configuration file. After this, each device support subset is configured. Based on the machine and bus information in the configuration file you specified, the installation procedure for the device support subsets will determine if the subset can support your platform. If they cannot, the installation of that device support subset will be aborted, and a message similar to the following will be displayed: Configuring "Sound and Motion (J300) Device Support V2.2" (MMEDRVAV300220) No TURBOchannel bus specified in the config file. The Sound and Motion (J300) Device Support is only useful in a TURBOchannel machine kernel. Deleting subset MMEDRVAV300 Deleting "Sound and Motion (J300) Device Support V2.2" (MMEDRVAV300220). Otherwise, if the configuration was successful, a message similar to the following will be displayed: Configuring "FullVideo Supreme (AV321/AV301) Device Support V2.2" (MMEDRVAV3X1220) You have selected the FullVideo Supreme AV301/AV321 Device Support. 3.9.4 Rebuilding the Kernel Once all of the driver-support subsets are configured, you will be asked if you want to rebuild the kernel. Unless you are installing other layered products with kernel drivers, you should rebuild and install the new kernel at this point. There is no need to edit the configuration file, so you should simply answer no to that question. Once the build is finished, you will be presented with instructions for installing the new kernel and rebooting the system to run the new kernel. The following is an example of the installation output: You have selected one or more kernel drivers. In order to use these drivers you must rebuild your kernel. You might 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]: Y Copying /sys/conf/.product.list to CHONJI.list *** KERNEL CONFIGURATION AND BUILD PROCEDURE *** Saving /sys/conf/CHONJI as /sys/conf/CHONJI.bck Do you want to edit the configuration file? (y/n) [n]:N *** PERFORMING KERNEL BUILD *** Working....Wed Mar 6 13:05:44 EDT 1996 The new kernel is /sys/CHONJI/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/CHONJI/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" 3.9.5 Inadequate Disk Space for New Kernel If your root partition will be more than 95% full by following the installation instructions for a new kernel, including the space required to make a backup copy of your kernel named as /vmunix.save, then the installation procedure will recommend that you save a copy of the current kernel to a different partition. If you have other saved kernel copies in the root partition, you may optionally, at your discretion, remove those to make room for a copy of the current kernel. The installation procedure, if room is available, may suggest that you save the current kernel to the /usr partition. If your new kernel boot fails, you will have to boot the generic kernel (/genvmunix). To recover, copy the saved kernel from /usr back to the root partition, and then reboot your machine using the saved kernel. You can boot the generic kernel with the following command entered at the console prompt: >>> boot -fi genvmunix 3.10 System Files Modified Several operating system files are modified during the installation of Multimedia Services for Digital UNIX. The additions to all of the system files can be located in /usr/opt/MME220/system for your reference. Note If you do not wish to have some of these files installed, simply create a file with the following name format: .$SystemFile.NOMME where $SystemFile is the name of the file you do not want to modify. For instance, to prevent the modification of the mailcap file, you can issue the following command: # touch /usr/lib/netscape/.mailcap.NOMME # touch /usr/local/lib/netscape/.mailcap.NOMME 3.10.1 Magic File The magic file, /etc/magic, is used by the file command to identify files that have some sort of magic number. A magic number is any numeric or string constant that identifies the file containing the constant. MMS adds several multimedia and imaging tags to this file. Before adding these types, the command # file countdown-jpeg.avi would result in countdown-jpeg.avi: data With these types added, the same command will now report countdown-jpeg.avi: Microsoft RIFF (AVI format) 3.10.2 Mailcap File These files, /usr/lib/netscape/mailcap and /usr/local/lib/netscape/mailcap control the applications launched by netscape to handle the display of various data file formats. MMS adds default actions for file formats supported by MMS applications. If you already have a mailcap file (typically .mailcap in your $HOME directory), you might add these actions to your own file by appending the contents of /usr/opt/MME220/system/mailcap. --------------------------------------------------------------------------- Chapter 4 - Running the Installation Verification Procedure --------------------------------------------------------------------------- This chapter explains what you need to do after the installation to make Multimedia Services for Digital UNIX ready for use. You can run the Installation Verification Procedure (IVP) during the installation, or you can run the IVP independently after installing Multimedia Services for Digital UNIX to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access Multimedia Services for Digital UNIX. If you are not installing any device support subsets, you are prompted at the end of the installation as to whether you want to run the IVP. If you install any of the device support subsets, you will not be prompted to run the IVP. Device support subsets require that a new kernel be booted, and because the IVP may depend on these subsets, you must reboot your system before running the IVP. You will need to run the IVP separately from the installation, as noted below, so that the device support subsets can be tested by the IVP. The Multimedia Services for Digital UNIX IVP verifies the installation as follows: * If the mmeserver is not already running, an attempt to start the server is made. If the server is not running one second after the attempt to start it, then the IVP fails. * A program (/usr/sbin/mme_ivp_audio_devices) to access all waveIn devices and all waveOut devices is run. For the devices that are found, the device numbers assigned to those devices and the names of the devices are listed. * At the option of the user, a program (/usr/sbin/mme_ivp_audio_play) to play audio on a user-specified device is run. If the program encounters any errors, then the IVP fails. * A similar verification of the video devices is done by running mme_ivp_video, which first lists the devices and then plays a preselected video clip on the X Display. When running the IVP, the superuser must have access to the X Display. The Multimedia Services Run-Time Sample Data subset must be installed. * If none of the previous errors has occurred, then the IVP succeeds. To run the IVP after an installation, enter the following command: # /usr/sbin/setld -v MMERT220 For a sample Multimedia Services for Digital UNIX IVP, see Section 8.4. If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem. --------------------------------------------------------------------------- Chapter 5 -- Operating System Upgrade Warning --------------------------------------------------------------------------- Before doing an installupdate, you must remove all MMS subsets. Beginning with Digital UNIX V4.0, this will be a mandatory requirement imposed by installupdate. Previous versions of installupdate do not mandate the removal of MMS subsets. However, you must do so to ensure the stability of your installation. The reason for this requirement is that several MMS subsets might depend on specific implementation of the Digital UNIX operating system. These pieces of the operating system may change between operating system releases. As a result, these MMS subsets must be replaced if you upgrade your operating system with installupdate. Since many of the MMS pieces depend on all the versions being the same, all the MME subsets must be replaced during an installupdate. Once the installupdate is completed, you must reinstall the MMS subsets so that the correct binaries are installed. Refer to Section 3.2 for instructions on deleting all installed subsets. Make sure that you have Multimedia Services for Digital UNIX available on a distribution media before deleting the subsets and before performing an installupdate. If Multimedia Services for Digital UNIX was factory installed on your machine and you do not have a CD-ROM distribution, you will not be able to reinstall Multimedia Services for Digital UNIX after the installupdate. Also, before you remove the MME subsets and perform an installupdate, make sure that the version of Multimedia Services for Digital UNIX that you have supports the version of the Digital UNIX operating system to which you are upgrading. --------------------------------------------------------------------------- Chapter 6 -- Microsoft Sound Board Installation and Configuration Details --------------------------------------------------------------------------- 6.1 About This Chapter This chapter contains information on the installation and "configuration" of a Microsoft Sound Board module, and the ordering of the hardware installation, the hardware configuration, and the installation of the Multimedia Services Microsoft Sound Board subset. Due to the characteristics of ISA (Industry Standard Architecture), the operating system is unable to determine automatically which ISA modules are present in a workstation's ISA bus slots. A procedure known as "hardware configuration" is used to specify these ISA modules to the operating system. Refer to the following sections that correspond to whether the target workstation has an EISA (Extended Industrial Standard Architecture) bus or an ISA bus. 6.2 EISA Bus This section describes the following: * EISA Bus Information * Microsoft Sound Board Configurations * Known Problems * Installing an EISA Bus Driver 6.2.1 EISA Bus Information If your system has an EISA bus, run the EISA Configuration Utility (ECU), shipped on a 3.5-inch diskette, prior to rebuilding your kernel. The kernel rebuilding process uses the NVRAM information stored by the ECU when it creates the kernel configuration file. The ECU is invoked at the system console prompt ( >>> ) via the runecu command. The hardware documentation shipped with your system contains additional information about the ECU. The following section contains specific information and problems relating to the Microsoft Sound Board ECU configuration. 6.2.2 Microsoft Sound Board Configurations There are two versions of the Microsoft Sound Board ECU configuration file: !ISA2000.CFG and AISA2000.CFG. The !ISA2000.CFG file is used with systems running Digital UNIX V2.x; the AISA2000.CFG file is used with systems running Digital UNIX V3.0 or later. 6.2.3 Known Problems If your ECU diskette is a version prior to V1.5 and/or was shipped with Digital UNIX V2.x or earlier, your ECU diskette may not have the ECU configuration file AISA2000.CFG that corresponds to the Microsoft Sound Board. You may obtain the AISA2000.CFG file by issuing the command: # setld -c MMEDRVMSB220 ECU to invoke the Build ECU utility, which is included in this kit. This utility lets you add the Microsoft Sound Board ECU configuration file onto your Digital UNIX ECU diskette. 6.2.4 Installing an EISA Bus Driver This section describes the installation of a driver on an EISA bus machine after upgrading to a new Digital UNIX version or when adding the Microsoft Sound Board to your ECU configuration. 1. Install the MMEDRVMSB subset, rebuilding a new kernel. 2. Update your Digital UNIX ECU diskette (only necessary if obtained prior to Digital UNIX V3.0). See the previous section for instructions. 3. Shut down your system and run the ECU utility, adding the Microsoft Sound Board. 4. If the sound card is not installed, then turn the power off, install the sound card, and turn the power on again. 5. Boot the new kernel you built in step 1. 6.3 ISA Bus This section describes the following: * ISA Bus Information * Installing the MSB Driver on ISA Bus Machines * ISA Configuration Utility 6.3.1 ISA Bus Information If your system has an ISA bus, issue the isacfg command at the system console prompt ( >>> ) after rebuilding your kernel and shutting down the system. Information on the isacfg console command is provided with the hardware documentation shipped with your system. You can determine if the sound card is already configured by entering the console command isacfg -all or the console command show config. The sound card has the handle PCXBJ, and should also have values for the options iobase0, iobase1, irq0, dmachan0, and dmachan1. If your sound card is not configured, you usually can configure it by typing add_sound at the console prompt. This command provides default values for all the sound card configuration options. Alternatively, you can enter an entire isacfg command, such as: >>>isacfg -mk -slot 2 -dev 0 -etyp 1 -handle PCXBJ -iobase0 530 -iobase1 388 -enadev 1 -irq0 9 -dmachan0 0 -dmachan1 3 where, -handle Specifies a handle used by Digital UNIX (must be PCXBJ for the Microsoft Sound Board) -iobase0 Specifies the I/O port selected by the board jumper (choose from 0530, 0604, or 0E80) -iobase1 Specifies the midi I/O port (must always be 0388) -irq0 Specifies the interrupt request line (normally, choose from 7, 9, 10, or 11) -dmachan0 Specifies the first DMA channel to be used (choose from 0, 1, or 3) -dmachan1 Specifies the second DMA channel to be used (choose from 0, 1, or 3, but make it a different value than the value used for -dmachan0) Note The proper values for your machine may differ from the example above, depending upon the actual sound card that you have installed and whether you have to resolve conflicts with other cards installed in your system. Following entry of new isacfg information, use the >>>init command to store the configuration. 6.3.2 Installing the MSB Driver on ISA Bus Machines This section describes the steps to install the Microsoft Sound Board device driver on an ISA bus machine after upgrading to a new Digital UNIX version, or when adding the Microsoft Sound Board to your console configuration: 1. Install the MMEDRVMSB subset, rebuilding a new kernel. 2. Shut down and halt your system, and use appropriate console configuration commands (isacfg, add_sound, init) to add the Microsoft Sound Board to your hardware configuration. 3. If the sound card is not installed then turn the power off, install the sound card, and turn the power on again. 4. Boot the new kernel you built in step 1. 6.3.3 ISA Configuration Utility This section describes the ISA configuration utility. ISA devices are not capable of being probed for configuration information by the Digital UNIX or OpenVMS operating systems. Therefore, you must enter ISA option information manually using the ISA configuration utility (ISACFG). You should run this utility before installing a new ISA option module on Digital AlphaStation systems running either the Digital UNIX or OpenVMS operating systems. The syntax for the isacfg command is: isacfg [-all] [-dev ] [-dmachan{0-3} <#>] [-dmamode{0-3} <#>] [-enadev <#>] [-etyp <#>] [-handle(<)string(>)] [-init] [-iobase{0-5} <#>] [-irq{0-3} <#>] [-membase{0-2} <#>] [-memlen{0-2} <#>] [-mk] [-mod][-rm][-rombase <#>] [-romlen <#>] [-slot ] [-totdev <#>] where, [-all] Shows the entire configuration table. It overrides all other commands. [-dev ] Optional; defaults to 0 if not entered. On a multifunction or multiport adapter, this specifies the device on the adapter. [-dmachan{0-3} <#>] Allows you to specify up to four DMA channels for the device. [-dmamode{0-3} <#>] Allows you to specify the DMA type for -dmachan{0-3}. DMA modes are: 1-Block 2-Demand 4-Single 8-Cascade [-enadev <#>] Allows you to specify whether an entry is enabled or disabled. Disabled devices are not used in resource allocation calculations. The possible values are: 0-No (disabled) 1-Yes (enabled) [-etyp <#>] Defines an entry type for this entry. The # sign can be: 0-A cause for the entry to be deleted 1-Single option 2-Embedded multiport device 3-Multiport option device [-handle(<)string(>)] Binds a name to the driver (up to 15 characters). [-init] Initializes the configuration table to the default settings. [-iobase{0-5} <#>] Specifies up to six I/O base registers (in hexadecimal) for a particular device entry. [-irq{0-3} <#>] Allows you to assign up to four IRQ (interrupt request) channels to the device (use decimal IRQ levels). [-membase{0-2} <#>] Specifies up to three R/W (read/write) ISA memory regions. [-memlen{0-2} <#>] Specifies the length corresponding to -membase{0-2}. [-mk] Adds an entry to the table. [-mod] Modifies an entry in the table. [-rm] Deletes an entry from the table. [-rombase <#>] Specifies an address for ISA BIOS extended ROM. [-romlen <#>] Specifies length of ROM. [-slot ] Allows you to enter a unique slot number for each ISA adapter. You may assign the numbers in any order. The slot number does not relate to a physical ISA adapter position. Slot 0 is reserved for the local multiport adapter. [-totdev <#>] Is a placeholder that allows you to keep track of the total number of devices, specified by the # sign, at this slot. Modify this for your own use. --------------------------------------------------------------------------- Chapter 7 -- Subset Listings --------------------------------------------------------------------------- 7.1 About this Chapter This chapter provides a complete listing of all Multimedia Services for Digital UNIX subsets. They are categorized as follows: * Products and Distributions * Documentation Subsets * Run-time Kit Subsets * PCI/EISA/ISA Hardware-Option Subsets * TURBOchannel Hardware-Option Subsets * Development Kit Subsets 7.2 Products and Distribution Each of the subsets listed in Table 7-3 below might be included in one or more of the distribution media. See the Software Distribution section in the Preface for information on MMS distribution methods. Table 7-3 -- Multimedia Services for Digital UNIX. Subsets: Product and Distribution Category Subset Product Distribution Run Develop FIS SPL DUAP Time ment Documentation MMEDOC220 x x x x MMEDOCDEV220 x x MMEDOCHW220 x x x x MMERELNOTES220 x x x x TURBOchannel MMEDRVAV300220 x x x x MMEDRVBBA220 x 1 x x PCI/EISA/ISA MMEDRVAV3X1220 x x x x MMEDRVAV201220 x x x x MMEDRVMSB220 x x x x Development MMEMANDEV220 x x MMEDEV220 x x Runtime MMERT220 x x x x MMEMANRT220 x x x x MMERTCDE220 x 2 x x MMERTSMPLDAT220 x 3 x x 1 This subset might not be installed on every machine with factory-installed software (FISed). 2 MMERCDE is only available on the FIS distribution if CDE is part of the subset. 3 This subset might not be installed on every machine with factory-installed software (FISed). 7.3 Documentation Subset MMERELNOTES Multimedia Services for Digital UNIX Release Notes Description This subset contains the release notes for Multimedia Services for Digital UNIX.. If you want to read these notes before installing the entire product, choose to install this subset first. installation. This subset also contains copies of the Software Product Description (SPD) and a cover letter. Requirements None Distribution All MMEDOCDEV Multimedia Services for Digital UNIX Development Documentation Description This subset contains online versions of the Programmer's Guide. Requirements None Distribution SPL MMEDOC Multimedia Services for Digital UNIX Documentation Description This subset contains online versions of the Application User's Guide and the Installation Guide. Requirements None Distribution All MMEDOCHW Multimedia Services for Digital UNIX Hardware Option Documentation Description This subset contains online versions of several hardware option guides Requirements Only PostScript versions are available Distribution SPL, DUAP 7.4 Run-time Kit Subsets MMERT Multimedia Services for Digital UNIX. Description This subset contains the static and shared versions of the Multimedia Services for Digital UNIX run-time library, the multimedia server mmeserver, multimedia applets, and the server device libraries for the software video and audio codecs. It also includes audio and video capture and playback utilities. Requirements Several applets require the C++ Runtime Library to run. If you wish to use these applets, you will need to load the CXXSHRDA subset in Digital UNIX versions prior to V4.0. (See Section 3.6.2 for information on how to obtain the C++ Runtime Library.) The V4.0 version of Digital UNIX includes the C++ Runtime Library. Distribution All MMERTCDE Multimedia Services for Digital UNIX CDE Integration Description This subset contains the icons and action files to enable multimedia integration with the Common Desktop Environment (CDE). Requirements MMERT and one of the following CDE subsets: OSFCDEDT, CDEART, or CDEMIN Distribution All (Some FIS distributions do not include this subset if CDE is not factory installed.) MMEMANRT Multimedia Services for Digital UNIX Runtime Man Pages Description This subset contains the man pages for run-time applications and commands. Requirements OSFDCMT Document Preparation Tools Distribution All MMERTSMPLDAT Multimedia Services for Digital UNIX Sample Data Description This subset contains sample audio and video clips. Requirements MMERT Distribution SPL, DUAP, FIS (only with some FIS distributions. Not shipped on systems with small disks) 7.5 Hardware-Option Subsets (for PCI/EISA/ISA bus machines) MMEDRVAV201 FullVideo Basic (AV201) Device Support V2.2 Description This subset contains the device support files for the FullVideo Basic option module. Requirements MMERT, PCI bus machine. Installation of this subset requires a kernel rebuild. Distribution All MMEDRVAV3X1 FullVideo Supreme (AV321/AV301) Device Support Description This subset contains the device support files for the FullVideo Supreme and FullVideo Supreme JPEG option modules. Requirements MMERT, PCI bus machine. Installation of this subset requires a kernel rebuild. Distribution All MMEDRVMSB Microsoft Sound Board Device Support Description This subset contains the device support files for the Microsoft Sound Board multimedia option module. Requirements MMERT, ISA or EISA bus machine. Installation of this subset requires a kernel rebuild. Distribution All 7.6 Hardware-Option Subsets (for TURBOchannel bus machines) MMEDRVAV300 Sound and Motion (J300) Device Support Description This subset contains the device support files for the Sound and Motion option module. Requirements MMERT, TURBOchannel bus machine. Installation of this subset requires a kernel rebuild. Distribution All (only with some FIS distributions) MMEDRVBBA Base Board Audio Device Support Description This subset contains the device support files for the Base Board Audio module. Requirements MMERT, TURBOchannel bus machine. Installation of this subset does not require a kernel rebuild. Distribution All (only with some FIS distributions) 7.7 Development Kit Subsets MMEDEV Multimedia Services for Digital UNIX Development Description This subset contains the header files necessary to develop applications that incorporate multimedia features using the Multimedia Services application programming interface. The subset also includes sample code to demonstrate programming to the interfaces. Requirements MMERT, OSFCMPLRS, OSFXDEV. 1. In order to compile the sample code, the OSFCMPLRS Compiler Back End Software Development subset is required. 2. In order to build the Makefiles and some of the sample applications, the OSFXDEV X Window Software Development subset is required. Distribution SPL MMEMANDEV Multimedia Services for Digital UNIX. Development Man Pages Description This subset contains the man pages for MMS routines. Requirements OSFDCMT Document Preparation Tools Distribution SPL --------------------------------------------------------------------------- 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 V3.2C * Deinstallation of MMS on an AlphaStation system running Digital UNIX V3.2C * Installation verification procedure (IVP) for MMS on an AlphaStation system running Digital UNIX V3.2C 8.2 Sample Installation Dialog The following example shows an installation of MMS on an AlphaStation system running Digital UNIX V3.2C. # setld -l . Multimedia Services for Digital UNIX Copyright Digital Equipment Corporation 1993, 1996. 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 for Digital UNIX Development Man Pages T2.2 2) Multimedia Services for Digital UNIX Development T2.2 - Documentation Kit: 3) Multimedia Services for Digital UNIX Development Documentation T2.2 4) Multimedia Services for Digital UNIX Documentation T2.2 5) Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 6) Multimedia Services for Digital UNIX Release Notes T2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: 7) FullVideo Basic (AV201) Device Support T2.2 --- MORE TO FOLLOW --- Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): 8) FullVideo Supreme (AV321/AV301) Device Support T2.2 9) Microsoft Sound Board Device Support T2.2 - Hardware Option Support for TURBOchannel Bus Machines: 10) Base Board Audio Device Support T2.2 11) Sound and Motion (J300) Device Support T2.2 - Run-Time Kit: 12) Multimedia Services for Digital UNIX CDE Integration T2.2 13) Multimedia Services for Digital UNIX Runtime Man Pages T2.2 14) Multimedia Services for Digital UNIX Runtime T2.2 15) Multimedia Services for Digital UNIX Sample Data T2.2 Or you may choose one of the following options: 16) ALL of the above 17) CANCEL selections and redisplay menus 18) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 16 You are installing the following optional subsets: - Development Kit: Multimedia Services for Digital UNIX Development Man Pages T2.2 Multimedia Services for Digital UNIX Development T2.2 - Documentation Kit: Multimedia Services for Digital UNIX Development Documentation T2.2 Multimedia Services for Digital UNIX Documentation T2.2 Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 Multimedia Services for Digital UNIX Release Notes T2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: FullVideo Basic (AV201) Device Support T2.2 FullVideo Supreme (AV321/AV301) Device Support T2.2 Microsoft Sound Board Device Support T2.2 - Hardware Option Support for TURBOchannel Bus Machines: Base Board Audio Device Support T2.2 Sound and Motion (J300) Device Support T2.2 Press RETURN to display the next screen: - Run-Time Kit: Multimedia Services for Digital UNIX CDE Integration T2.2 Multimedia Services for Digital UNIX Runtime Man Pages T2.2 Multimedia Services for Digital UNIX Runtime T2.2 Multimedia Services for Digital UNIX Sample Data T2.2 Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. Multimedia Services for Digital UNIX Release Notes T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Runtime T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX CDE Integration T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Runtime Man Pages T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Sample Data T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the FullVideo Basic AV201 Device Support. 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 (AlphaStation workstation). Do you wish to install the FullVideo Basic AV201 Device Support at this time? (y/n) [y]: Y FullVideo Basic (AV201) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Sound and Motion (J300) Device Support. 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 at this time? (y/n) [y]: Y Sound and Motion (J300) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the FullVideo Supreme AV301/AV321 Device Support. DO NOT INSTALL this subset unless you will be running this kernel on a PCI system (AlphaStation workstation). Do you wish to install the FullVideo Supreme AV301/AV321 Device Support at this time? (y/n) [y]: Y FullVideo Supreme (AV321/AV301) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Microsoft Sound Board Device Support. 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 (AlphaStation workstation, DEC 2000 Model 300, or an AlphaServer system). Do you wish to install the Microsoft Sound Board Device Support at this time? (y/n) [y]: Y Microsoft Sound Board Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Base Board Audio Device Support. 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 at this time? (y/n) [y]: Y Base Board Audio Device Support T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development Man Pages T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development Documentation T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Documentation T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 Copying from . (disk) Verifying Configuring "Multimedia Services for Digital UNIX Release Notes T2.2" (MMERELNOTES220) ***** You have installed multimedia playback accelerators for your current graphics device. You will need to restart the X server for these changes to take affect. You can do this by logging out and logging back in after you have completed the installation. Press RETURN to continue Configuring "Multimedia Services for Digital UNIX Runtime T2.2" (MMERT220) Do you want to enable scripts that automatically start the Multimedia Services for Digital UNIX Runtime T2.2 server every time the system is booted? (y/n) [y]: Y Multimedia Services for Digital UNIX Runtime T2.2 server 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 T2.2 now. The IVP for Multimedia Services for Digital UNIX Runtime T2.2 may be executed at a later time by issuing the command # setld -v MMERT220 Press RETURN to continue Configuring "Multimedia Services for Digital UNIX CDE Integration T2.2" (MMERTCDE220) ***** The Multimedia Services for Digital UNIX CDE Integration T2.2 adds new application actions and a Multimedia Application Group to the CDE Desktop. These new items could not be automatically updated for the Desktop due to deficiencies in the ADK for CDE. These problems have been resolved with the CDE Desktop shipped with Digital UNIX 4.0. To have the changes activated, you must log out of the current CDE session and log in again. Press RETURN to continue Configuring "Multimedia Services for Digital UNIX Runtime Man Pages T2.2" (MMEMANRT220) Configuring "Multimedia Services for Digital UNIX Sample Data T2.2" (MMERTSMPLDAT220) Configuring "FullVideo Basic (AV201) Device Support T2.2" (MMEDRVAV201220) ********************************************************************* * Preparing to Rebuild Kernel in order to complete installation. ********************************************************************* Do you want to use an existing kernel configuration file? (y/n) [y]: Y Enter a name for the kernel configuration file. [CHONJI]: CHONJI You selected CHONJI, is this correct? (y/n) [y]: Y You have selected the FullVideo Basic AV201 Device Support. Configuring "Sound and Motion (J300) Device Support T2.2" (MMEDRVAV300220) ***** No TURBOchannel bus specified in the config file. The Sound and Motion (J300) Device Support is only useful in a TURBOchannel machine kernel. Deleting subset MMEDRVAV300220 Deleting "Sound and Motion (J300) Device Support T2.2" (MMEDRVAV300220). Configuring "FullVideo Supreme (AV321/AV301) Device Support T2.2" (MMEDRVAV3X1220) You have selected the FullVideo Supreme AV301/AV321 Device Support. Configuring "Microsoft Sound Board Device Support T2.2" (MMEDRVMSB220) ***** 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 EISA bus. You may press "E" for additional EISA bus hardware configuration information. 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]: y You have selected the Microsoft Sound Board Device Support. ********************************************************************* * 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]: Y Copying /sys/conf/.product.list to CHONJI.list *** KERNEL CONFIGURATION AND BUILD PROCEDURE *** Saving /sys/conf/CHONJI as /sys/conf/CHONJI.bck Do you want to edit the configuration file? (y/n) [n]: *** PERFORMING KERNEL BUILD *** Working....Tue May 7 02:33:10 EDT 1996 The new kernel is /sys/CHONJI/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/CHONJI/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 T2.2" (MMEDRVBBA220) Configuring "Multimedia Services for Digital UNIX Development T2.2" (MMEDEV220) Configuring "Multimedia Services for Digital UNIX Development Man Pages T2.2" (MMEMANDEV220) Configuring "Multimedia Services for Digital UNIX Development Documentation T2.2" (MMEDOCDEV220) Configuring "Multimedia Services for Digital UNIX Documentation T2.2" (MMEDOC220) Configuring "Multimedia Services for Digital UNIX Hardware Option Documentation T2.2" (MMEDOCHW220) 8.3 Sample Deinstallation Dialog The following example shows a deinstallation of MMS on an AlphaStation system running Digital UNIX V3.2C. setld -d `setld -i | grep MME | grep installed | awk 'print $1'` Deleting "Multimedia Services for Digital UNIX Hardware Option Documentation T2.2" (MMEDOCHW220). Deleting "Multimedia Services for Digital UNIX Documentation T2.2" (MMEDOC220). Deleting "Multimedia Services for Digital UNIX Development Documentation T2.2" (MMEDOCDEV220). Deleting "Multimedia Services for Digital UNIX Development Man Pages T2.2" (MMEMANDEV220). Deleting "Multimedia Services for Digital UNIX Development T2.2" (MMEDEV220). Deleting "Base Board Audio Device Support T2.2" (MMEDRVBBA220). Deleting "Microsoft Sound Board Device Support T2.2" (MMEDRVMSB220). You have deleted the Microsoft Sound Board Device Support. ***** 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]: N Deleting "FullVideo Supreme (AV321/AV301) Device Support T2.2" (MMEDRVAV3X1220). You have deleted the FullVideo Supreme AV301/AV321 Device Support. ***** 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]: N Deleting "FullVideo Basic (AV201) Device Support T2.2" (MMEDRVAV201220). You have deleted the FullVideo Basic AV201 Device Support. ***** 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]: N Deleting "Multimedia Services for Digital UNIX Sample Data T2.2" (MMERTSMPLDAT220). Deleting "Multimedia Services for Digital UNIX Runtime Man Pages T2.2" (MMEMANRT220). Deleting "Multimedia Services for Digital UNIX CDE Integration T2.2" (MMERTCDE220). Deleting "Multimedia Services for Digital UNIX Runtime T2.2" (MMERT220). Deleting "Multimedia Services for Digital UNIX Release Notes T2.2" (MMERELNOTES220). 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 V3.2C. # /usr/sbin/mme_ivp Multimedia Services for Digital UNIX T2.2 Installation Verification Procedure Copyright Digital Equipment Corporation 1993, 1996. 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. Would you like to play a short clip on the Wave Out Device? (y/n) [y]: y 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]: y Please specify a device number [1]: Device number selected is 1 mme_ivp_video: Setting colormap to private to use non-default visual. mme_ivp_video: Decompressor selected: J321 device input format: MJPG 24-bit output format: DYUV 16-bit MM Extension: DECMmPixelYUV16_GIB mme_ivp_video: Visual selected: 8-bit TrueColor mme_ivp_video: Colormap selected: Private Colormap Multimedia Services for Digital UNIX T2.2 IVP SUCCEEDED --------------------------------------------------------------------------- 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 V3.2C * Deinstallation of MMS on an AlphaStation system running Digital UNIX V3.2C * Installation verification procedure (IVP) for MMS on an AlphaStation system running Digital UNIX V3.2C 8.2 Sample Installation Dialog The following example shows an installation of MMS on an AlphaStation system running Digital UNIX V3.2C. # setld -l . Multimedia Services for Digital UNIX Copyright Digital Equipment Corporation 1993, 1996. 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 for Digital UNIX Development Man Pages T2.2 2) Multimedia Services for Digital UNIX Development T2.2 - Documentation Kit: 3) Multimedia Services for Digital UNIX Development Documentation T2.2 4) Multimedia Services for Digital UNIX Documentation T2.2 5) Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 6) Multimedia Services for Digital UNIX Release Notes T2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: 7) FullVideo Basic (AV201) Device Support T2.2 --- MORE TO FOLLOW --- Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): 8) FullVideo Supreme (AV321/AV301) Device Support T2.2 9) Microsoft Sound Board Device Support T2.2 - Hardware Option Support for TURBOchannel Bus Machines: 10) Base Board Audio Device Support T2.2 11) Sound and Motion (J300) Device Support T2.2 - Run-Time Kit: 12) Multimedia Services for Digital UNIX CDE Integration T2.2 13) Multimedia Services for Digital UNIX Runtime Man Pages T2.2 14) Multimedia Services for Digital UNIX Runtime T2.2 15) Multimedia Services for Digital UNIX Sample Data T2.2 Or you may choose one of the following options: 16) ALL of the above 17) CANCEL selections and redisplay menus 18) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 16 You are installing the following optional subsets: - Development Kit: Multimedia Services for Digital UNIX Development Man Pages T2.2 Multimedia Services for Digital UNIX Development T2.2 - Documentation Kit: Multimedia Services for Digital UNIX Development Documentation T2.2 Multimedia Services for Digital UNIX Documentation T2.2 Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 Multimedia Services for Digital UNIX Release Notes T2.2 - Hardware Option Support for PCI/EISA/ISA Bus Machines: FullVideo Basic (AV201) Device Support T2.2 FullVideo Supreme (AV321/AV301) Device Support T2.2 Microsoft Sound Board Device Support T2.2 - Hardware Option Support for TURBOchannel Bus Machines: Base Board Audio Device Support T2.2 Sound and Motion (J300) Device Support T2.2 Press RETURN to display the next screen: - Run-Time Kit: Multimedia Services for Digital UNIX CDE Integration T2.2 Multimedia Services for Digital UNIX Runtime Man Pages T2.2 Multimedia Services for Digital UNIX Runtime T2.2 Multimedia Services for Digital UNIX Sample Data T2.2 Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. Multimedia Services for Digital UNIX Release Notes T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Runtime T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX CDE Integration T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Runtime Man Pages T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Sample Data T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the FullVideo Basic AV201 Device Support. 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 (AlphaStation workstation). Do you wish to install the FullVideo Basic AV201 Device Support at this time? (y/n) [y]: Y FullVideo Basic (AV201) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Sound and Motion (J300) Device Support. 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 at this time? (y/n) [y]: Y Sound and Motion (J300) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the FullVideo Supreme AV301/AV321 Device Support. DO NOT INSTALL this subset unless you will be running this kernel on a PCI system (AlphaStation workstation). Do you wish to install the FullVideo Supreme AV301/AV321 Device Support at this time? (y/n) [y]: Y FullVideo Supreme (AV321/AV301) Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Microsoft Sound Board Device Support. 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 (AlphaStation workstation, DEC 2000 Model 300, or an AlphaServer system). Do you wish to install the Microsoft Sound Board Device Support at this time? (y/n) [y]: Y Microsoft Sound Board Device Support T2.2 Copying from . (disk) Verifying ***** You have selected the installation of the Base Board Audio Device Support. 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 at this time? (y/n) [y]: Y Base Board Audio Device Support T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development Man Pages T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Development Documentation T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Documentation T2.2 Copying from . (disk) Verifying Multimedia Services for Digital UNIX Hardware Option Documentation T2.2 Copying from . (disk) Verifying Configuring "Multimedia Services for Digital UNIX Release Notes T2.2" (MMERELNOTES220) ***** You have installed multimedia playback accelerators for your current graphics device. You will need to restart the X server for these changes to take affect. You can do this by logging out and logging back in after you have completed the installation. Press RETURN to continue Configuring "Multimedia Services for Digital UNIX Runtime T2.2" (MMERT220) Do you want to enable scripts that automatically start the Multimedia Services for Digital UNIX Runtime T2.2 server every time the system is booted? (y/n) [y]: Y Multimedia Services for Digital UNIX Runtime T2.2 server 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 T2.2 now. The IVP for Multimedia Services for Digital UNIX Runtime T2.2 may be executed at a later time by issuing the command # setld -v MMERT220 Press RETURN to continue Configuring "Multimedia Services for Digital UNIX CDE Integration T2.2" (MMERTCDE220) ***** The Multimedia Services for Digital UNIX CDE Integration T2.2 adds new application actions and a Multimedia Application Group to the CDE Desktop. These new items could not be automatically updated for the Desktop due to deficiencies in the ADK for CDE. These problems have been resolved with the CDE Desktop shipped with Digital UNIX 4.0. To have the changes activated, you must log out of the current CDE session and log in again. Press RETURN to continue Configuring "Multimedia Services for Digital UNIX Runtime Man Pages T2.2" (MMEMANRT220) Configuring "Multimedia Services for Digital UNIX Sample Data T2.2" (MMERTSMPLDAT220) Configuring "FullVideo Basic (AV201) Device Support T2.2" (MMEDRVAV201220) ********************************************************************* * Preparing to Rebuild Kernel in order to complete installation. ********************************************************************* Do you want to use an existing kernel configuration file? (y/n) [y]: Y Enter a name for the kernel configuration file. [CHONJI]: CHONJI You selected CHONJI, is this correct? (y/n) [y]: Y You have selected the FullVideo Basic AV201 Device Support. Configuring "Sound and Motion (J300) Device Support T2.2" (MMEDRVAV300220) ***** No TURBOchannel bus specified in the config file. The Sound and Motion (J300) Device Support is only useful in a TURBOchannel machine kernel. Deleting subset MMEDRVAV300220 Deleting "Sound and Motion (J300) Device Support T2.2" (MMEDRVAV300220). Configuring "FullVideo Supreme (AV321/AV301) Device Support T2.2" (MMEDRVAV3X1220) You have selected the FullVideo Supreme AV301/AV321 Device Support. Configuring "Microsoft Sound Board Device Support T2.2" (MMEDRVMSB220) ***** 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 EISA bus. You may press "E" for additional EISA bus hardware configuration information. 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]: y You have selected the Microsoft Sound Board Device Support. ********************************************************************* * 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]: Y Copying /sys/conf/.product.list to CHONJI.list *** KERNEL CONFIGURATION AND BUILD PROCEDURE *** Saving /sys/conf/CHONJI as /sys/conf/CHONJI.bck Do you want to edit the configuration file? (y/n) [n]: *** PERFORMING KERNEL BUILD *** Working....Tue May 7 02:33:10 EDT 1996 The new kernel is /sys/CHONJI/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/CHONJI/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 T2.2" (MMEDRVBBA220) Configuring "Multimedia Services for Digital UNIX Development T2.2" (MMEDEV220) Configuring "Multimedia Services for Digital UNIX Development Man Pages T2.2" (MMEMANDEV220) Configuring "Multimedia Services for Digital UNIX Development Documentation T2.2" (MMEDOCDEV220) Configuring "Multimedia Services for Digital UNIX Documentation T2.2" (MMEDOC220) Configuring "Multimedia Services for Digital UNIX Hardware Option Documentation T2.2" (MMEDOCHW220) 8.3 Sample Deinstallation Dialog The following example shows a deinstallation of MMS on an AlphaStation system running Digital UNIX V3.2C. setld -d `setld -i | grep MME | grep installed | awk 'print $1'` Deleting "Multimedia Services for Digital UNIX Hardware Option Documentation T2.2" (MMEDOCHW220). Deleting "Multimedia Services for Digital UNIX Documentation T2.2" (MMEDOC220). Deleting "Multimedia Services for Digital UNIX Development Documentation T2.2" (MMEDOCDEV220). Deleting "Multimedia Services for Digital UNIX Development Man Pages T2.2" (MMEMANDEV220). Deleting "Multimedia Services for Digital UNIX Development T2.2" (MMEDEV220). Deleting "Base Board Audio Device Support T2.2" (MMEDRVBBA220). Deleting "Microsoft Sound Board Device Support T2.2" (MMEDRVMSB220). You have deleted the Microsoft Sound Board Device Support. ***** 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]: N Deleting "FullVideo Supreme (AV321/AV301) Device Support T2.2" (MMEDRVAV3X1220). You have deleted the FullVideo Supreme AV301/AV321 Device Support. ***** 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]: N Deleting "FullVideo Basic (AV201) Device Support T2.2" (MMEDRVAV201220). You have deleted the FullVideo Basic AV201 Device Support. ***** 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]: N Deleting "Multimedia Services for Digital UNIX Sample Data T2.2" (MMERTSMPLDAT220). Deleting "Multimedia Services for Digital UNIX Runtime Man Pages T2.2" (MMEMANRT220). Deleting "Multimedia Services for Digital UNIX CDE Integration T2.2" (MMERTCDE220). Deleting "Multimedia Services for Digital UNIX Runtime T2.2" (MMERT220). Deleting "Multimedia Services for Digital UNIX Release Notes T2.2" (MMERELNOTES220). 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 V3.2C. # /usr/sbin/mme_ivp Multimedia Services for Digital UNIX T2.2 Installation Verification Procedure Copyright Digital Equipment Corporation 1993, 1996. 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. Would you like to play a short clip on the Wave Out Device? (y/n) [y]: y 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]: y Please specify a device number [1]: Device number selected is 1 mme_ivp_video: Setting colormap to private to use non-default visual. mme_ivp_video: Decompressor selected: J321 device input format: MJPG 24-bit output format: DYUV 16-bit MM Extension: DECMmPixelYUV16_GIB mme_ivp_video: Visual selected: 8-bit TrueColor mme_ivp_video: Colormap selected: Private Colormap Multimedia Services for Digital UNIX T2.2 IVP SUCCEEDED