Title Page Preface Chapter 1 Chapter 2 Chapter 3 Chapter 4 Appendix A Appendix B



Chapter 1:
Installing DECtalk Software

This chapter covers the preinstallation, installation and post installation tasks required to install DECtalk Software on your system. Topics include:



Preinstallation Tasks

This section covers the tasks you must perform before installing DECtalk Software. Topics include:

  • Accessing the release notes (see Accessing the Release Notes, page 12)

  • Checking installation procedure requirements (see Installation Procedure Requirements, page 18)

  • Hardware requirements (see Hardware Requirements, page 18)

  • Checking current disk space (see Checking Current Disk Space, page 19)

  • Accessing the Release Notes

    DECtalk Software provides release notes. The release notes contain information about changes to DECtalk Software for Digital UNIX. Digital strongly recommends that you read these release notes before using the product. See the Compact Disc User's Guide shipped with your media for instructions about how to access the release notes prior to the software installation.

    The release notes for DECtalk Software are in the following files after the DTKRTRELNOTES420 subset is installed:

    /usr/opt/DTKRT420/docs/ascii/release_notes_rt.txt
    /usr/opt/DTKRT420/docs/postscript/release_notes_rt.ps

    Use the following command to read the release notes for DECtalk Software after the DTKRTRELNOT420 subset is installed:

    # more /usr/opt/DTKRT420/docs/ascii/release_notes_rt.txt

    You can also print either file.


    Registering Your Software Licenses

    DECtalk Software includes support for the License Management Facility (LMF). You must register your license product authorization keys (License PAKs) in the license database (LDB) in order to use DECtalk Software on a newly licensed system. The License PAKs is 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.

    Note

    You must have superuser privileges to install the DECtalk Software and to register the license PAK.

    If you are installing DECtalk Software as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.

    To register a license under the Digital UNIX operating system:

    Log in as root.

    At the superuser prompt, edit an empty PAK template with the lmf register) command as follows, and include all the information on your License PAK:

    # lmf register
    LMF displays a blank template and invokes an editor to allow you to edit the template. LMF invokes the editor that is defined by your EDITOR environment variable. If the environment variable is undefined, LMF invokes the vi editor.

    You must enter the license information from the PAK accurately.

    When you finish entering the license data, exit from the editor. If the license data is correct, LMF copies it into the license Database. If the license data is incorrect, you may reenter the editor and correct mistakes.

    Alternatively, you can create a command script enclosing the license information (the license information is in the cover letter with this kit) found between

    lmf register - << ENDLMF
    and

    ENDLMF
    Execute this script as root.

    After you register your license, use the following commands to copy the license details from the license database (LDB) to the kernel cache:

    # lmf load 0 DECTALK-SW
    For complete information on using the License Management Facility, see the Guide to Software License Management and the lmf reference page.


    Checking the Software Distribution Kit

    Use the bill of materials (BOM) to check the contents of your DECtalk Software software distribution kit.

    In addition to this guide, the software distribution kit includes the following:

    CD-ROM optical disc for systems with optical disc drives

    CD-ROM booklet

    If your software distribution kit is damaged or incomplete, contact your Digital representative.

    Directories and files included in the distribution kit are listed in the following screen display.

    /usr/opt/DTKRT420/decface/bin:
    DECFace.ini DECface* decface.gif

    /usr/opt/DTKRT420/decface/docs/ascii:
    decface.txt

    /usr/opt/DTKRT420/decface/facedata/modelbase:
    betty.eyes harry.eyes rita.eyes
    betty.face.indices harry.face.indices rita.face.indices
    betty.face.polyline harry.face.polyline rita.face.polyline
    betty.muscles harry.muscles rita.muscles
    betty.teeth.indices harry.teeth.indices rita.teeth.indices
    betty.teeth.polyline harry.teeth.polyline rita.teeth.polyline
    dennis.eyes kit.eyes ursula.eyes
    dennis.face.indices kit.face.indices ursula.face.indices
    dennis.face.polyline kit.face.polyline ursula.face.polyline
    dennis.muscles kit.muscles ursula.muscles
    dennis.teeth.indices kit.teeth.indices ursula.teeth.indices
    dennis.teeth.polyline kit.teeth.polyline ursula.teeth.polyline
    frank.eyes paul.eyes wendy.eyes
    frank.face.indices paul.face.indices wendy.face.indices
    frank.face.polyline paul.face.polyline wendy.face.polyline
    frank.muscles paul.muscles wendy.muscles
    frank.teeth.indices paul.teeth.indices wendy.teeth.indices
    frank.teeth.polyline paul.teeth.polyline wendy.teeth.polyline

    /usr/opt/DTKRT420/decface/facedata/texture_images:
    betty.face.ppm frank.teeth.ppm paul.face.ppm ursula.teeth.ppm
    betty.teeth.ppm harry.face.ppm paul.teeth.ppm wendy.face.ppm
    dennis.face.ppm harry.teeth.ppm rita.face.ppm wendy.teeth.ppm
    dennis.teeth.ppm kit.face.ppm rita.teeth.ppm
    frank.face.ppm kit.teeth.ppm ursula.face.ppm

    /usr/opt/DTKRT420/decface/visemes/whole_visemes:
    PH.00 PH.08 PH.16 PH.24 PH.32 PH.40 PH.48 PH.56 PH.64 PH.72
    PH.01 PH.09 PH.17 PH.25 PH.33 PH.41 PH.49 PH.57 PH.65 PH.73
    PH.02 PH.10 PH.18 PH.26 PH.34 PH.42 PH.50 PH.58 PH.66 PH.74
    PH.03 PH.11 PH.19 PH.27 PH.35 PH.43 PH.51 PH.59 PH.67 PH.75
    PH.04 PH.12 PH.20 PH.28 PH.36 PH.44 PH.52 PH.60 PH.68 PH.76
    PH.05 PH.13 PH.21 PH.29 PH.37 PH.45 PH.53 PH.61 PH.69
    PH.06 PH.14 PH.22 PH.30 PH.38 PH.46 PH.54 PH.62 PH.70
    PH.07 PH.15 PH.23 PH.31 PH.39 PH.47 PH.55 PH.63 PH.71

    /usr/opt/DTKRT420/docs/ascii:
    dtk420_release_notes_rt.txt filelist_rt.txt
    dtk420_start_guide.txt

    /usr/opt/DTKRT420/docs/html:
    dtk420_start_guide.html

    dt_3.html      dt_u2111.gif   dt_u313.gif    rainbowl.gif
    dt_4.html      dt_u2112.gif   dt_u314.gif    redball.gif
    dectalk.gif    dt_a.html      dt_u2113.gif   dt_u315.gif
    dt_1.html      dt_b.html      dt_u311.gif    dt_u316.gif
    dt_2.html      dt_u.html      dt_u312.gif    pinkball.gif
    run_toc.html
    /usr/opt/DTKRT420/docs/man/man1:
    DECface.1 dectalk.1 mailtalk.1 speak.1
    aclock.1 emacspeak.1 say.1 windict.1

    /usr/opt/DTKRT420/docs/postscript:
    dtk420_release_notes_rt.ps dtk420_start_guide.ps


    /usr/opt/DTKRT420/emacspeak/Macros:
    HELP emacspeak-ispell.el
    Makefile emacspeak-keymap.el
    dtk-macros.el emacspeak-kotl.el
    dtk-mme* emacspeak-load-path.def
    dtk-sh.el emacspeak-oo-browser.el
    dtk-spatial.el emacspeak-outline.el
    dtk-speak.el emacspeak-perl.el
    dtk-voices.el emacspeak-redefine.el
    emacspeak-advice.el emacspeak-replace.el
    emacspeak-auctex.el emacspeak-setup.def
    emacspeak-bbdb.el emacspeak-sounds.el
    emacspeak-c.el emacspeak-speak.el
    emacspeak-calc.el emacspeak-tabulate.el
    emacspeak-calendar.el emacspeak-tcl.el
    emacspeak-compile.el emacspeak-tempo.el
    emacspeak-dired.el emacspeak-vm.el
    emacspeak-dmacro.el emacspeak-w3.el
    emacspeak-ediff.el emacspeak-wrolo.el
    emacspeak-eterm.el emacspeak.def
    emacspeak-fix-interactive.el emacspeak.el
    emacspeak-folding.el html-voice.el
    emacspeak-gnus.el play.def
    emacspeak-hyperbole.el voice-lock.el
    emacspeak-info.el w3-util.el

    /usr/opt/DTKRT420/emacspeak/docs/ascii:
    emacspeak-README.txt

    /usr/opt/DTKRT420/emacspeak/docs/postscript:
    emacspeak.ps

    /usr/opt/DTKRT420/etc/dt/appconfig/appmanager/C/Multimedia:
    dtk_decface* dtk_speak* dtk_windict*

    /usr/opt/DTKRT420/etc/dt/appconfig/icons/C:
    dtk_decface.l.bm dtk_decface.t.bm dtk_speak.s.bm dtk_windict.m.bm
    dtk_decface.l.pm dtk_decface.t.pm dtk_speak.s.pm dtk_windict.m.pm
    dtk_decface.m.bm dtk_speak.l.bm dtk_speak.t.bm dtk_windict.s.bm
    dtk_decface.m.pm dtk_speak.l.pm dtk_speak.t.pm dtk_windict.s.pm
    dtk_decface.s.bm dtk_speak.m.bm dtk_windict.l.bm dtk_windict.t.bm
    dtk_decface.s.pm dtk_speak.m.pm dtk_windict.l.pm dtk_windict.t.pm

    /usr/opt/DTKRT420/etc/dt/appconfig/types/C:
    dtk_decface.dt dtk_speak.dt dtk_windict.dt

    /usr/opt/DTKRT420/examples/dtk/dtsamples:
    aclock* demo.txt mailtalk.ini say* user.dic
    birthday.txt mailtalk* noglass.txt startup.txt user.tab

    /usr/opt/DTKRT420/examples/dtk/speak:
    bitmaps/ speak* speak.uid

    /usr/opt/DTKRT420/examples/dtk/speak/bitmaps:
    bet16a.gif dtk.gif har16b.gif pau16b.gif urs16b.gif
    bet16b.gif fra16a.gif kid16a.gif rit16a.gif wen16a.gif
    den16a.gif fra16b.gif kid16b.gif rit16b.gif wen16b.gif
    den16b.gif har16a.gif pau16a.gif urs16a.gif windict.gif

    /usr/opt/DTKRT420/ivp:
    DTKRT420.ivp

    /usr/opt/DTKRT420/lib/X11/help:
    dtk420_start.decw_book dtk420_start.decw_bookshelf

    /usr/opt/DTKRT420/lib/dtk:
    dectalk.dic

    /usr/opt/DTKRT420/share/man/man1:
    DECface.1dtk dectalk.1dtk mailtalk.1dtk speak.1dtk
    aclock.1dtk emacspeak.1dtk say.1dtk windict.1dtk

    /usr/opt/DTKRT420/shlib:
    libtts.so* libttsmme.so*

    /usr/opt/DTKRT420/tools:
    dumpdict* userdict* windict* windict.uid

    Installation Procedure Requirements

    This section discusses the requirements for installing DECtalk Software.

    Installing DECtalk Software takes approximately 5 minutes, depending on your type of media and system configuration.


    Hardware Requirements

    To install DECtalk Software, you need the following:

    Software distribution device (if installing from media)

    Locate the 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.

    Terminal

    You can use either a hardcopy or video terminal to communicate with the operating system and respond to the prompts from the installation procedure.

    See the DECtalk Software for Digital UNIX Software Product Description (SPD) for additional hardware requirements.


    Software Requirements

    DECtalk Software for Digital UNIX Version 4.2A requires the Digital UNIX operating system Version 3.x or 4.0.

    Checking Current Disk Space

    To check the current amount of free space for a directory path, log in to the system where you will install DECtalk Software. You can check which directories are mounted and their locations by viewing the /etc/fstab file. For example:

    # more /etc/fstab
    /dev/rz3a / ufs rw 1 1
    /dev/rz3g /usr ufs rw 1 2
    /dev/rz3b swap1 ufs sw 0 2

    The display indicates that /usr mounted on /dev/rz3g is the only mount point that affects where DECtalk Software files will reside; the system has only one local disk drive, and the /usr/opt file system resides in the g partition of the disk on that drive.

    To check the total space and the free space for the directories where DECtalk Software will reside, enter the df command. Given the previous display of the /etc/fstab) file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system. For example:

    # df /usr
    Filesystem 512-blocks Used Avail Capacity Mounted on
    /dev/rz3a 79608 45648 25998 64% /
    /dev/rz3g 1482190 921846 412124 69% /usr

    This display shows that there are 412124 kbytes free. This free space must accommodate the subsets that you opt to install. If you choose to install all the subsets in the DECtalk Software Runtime kit you will need approximately 15Mbytes of free disk space. Of this, the two unsupported subsets use:

  • DECface 10 Mbytes

  • Emacspeak 1 Mbyte

  • Increasing Disk Space by Using Alternative Disks

    The DECtalk Software installation procedure creates and loads files into the subordinate directory:

    /usr/opt/DTKRT420

    If any of the previously listed directories already exists, the installation procedure uses it.

    If you find that there is insufficient disk space for the DECtalk Software subsets and you know that you have additional space on alternative disks or disk partitions for your system, perform the following steps before installing DECtalk Software:

    Log in as superuser.

    Create the following directory:

    /usr/opt/DTKRT420)

    Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space.

    Enter the mount -a command so that the new mount points take effect.


    Installation Tasks

    This section covers the tasks you must perform to install DECtalk Software.

    Topics include:

    Using the CD-ROM consolidated distribution media (see Using the CD-ROM Consolidated Distribution Media, page 21)

    Responding to installation procedure prompts (see Starting the Installation Procedure, page 22)

    Selecting subsets (see Selecting Subsets, page 23)

    Using a RIS distribution area (see Using an RIS Distribution Area, page 21)

    Starting the installation procedure (see Starting the Installation Procedure, page 22)

    Stopping the installation (see Stopping the Installation, page 29)


    Using the CD-ROM Consolidated Distribution Media

    The following procedure loads DECtalk Software files onto a disk belonging to the system where you perform the installation. When DECtalk Software is run, its executable images are mapped into memory on your system.

    To install DECtalk Software from CD-ROM media:

    Mount the media on the appropriate disk drive.

    Log in as superuser login name root to the system where you will install DECtalk Software.

    Make sure that you are at the root (/) directory by entering the following command:

    # cd /
    Specify the /cdrom directory to be the mount point for the distribution file system on the drive. If your drive is rz4c, enter the following command:

    # mount -dr /dev/rz4c /cdrom
    Enter a setld) command that requests the load function -l and identifies the directory in the mounted file system where DECtalk Software subsets are located. For example, if the directory location for these subsets is /cdrom/DTK420/kit, enter the following command:

    # /usr/sbin/setld -l /cdrom/DTK420/kit

    The installation procedure now displays the names of DECtalk Software subsets and asks you to specify the subsets you want to load.

    See Starting the Installation Procedure, page 22 to continue the installation.


    Using an RIS Distribution Area

    If you are installing DECtalk Software subsets that reside in an /etc/ris RIS distribution area on a remote system, take the following steps:

    Log in as superuser login name root to the system where you will install DECtalk Software.

    Make sure that you are at the root directory (/) by entering the following command:

    # cd /
    Enter a setld command that requests the load function (-l) option and identifies the system where the DECtalk Software subsets are located. For example, if you are loading DECtalk Software subsets from a RIS distribution area on node axpmme, enter the following:

    /usr/bin/setld -l axpmme

    RIS now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load.

    See Starting the Installation Procedure on page 22 to continue the installation.


    Starting the Installation Procedure

    Before starting the installation procedure, log in as a superuser and verify that you are at the root directory. Check to see if there are any previously installed DECtalk Software subsets by entering the following command:

    % su root
    # cd /
    # /usr/sbin/setld -i | grep DTK

    Deinstall any installed subsets with the prefix DTK by entering the following command:


    # cd /
    # /usr/sbin/setld -d (name of subset)

    To start the installation procedure, enter the following command:

    # /usr/sbin/setld -l /dev/rmt0h

    Then, respond to the installation procedure prompts as described in Selecting Subsets on page 23.


    Selecting Subsets

    The following section presents a complete installation procedure, including all messages that are displayed on your screen during the installation.

    You must specify which DECtalk Software subsets you want to load. If you specify more than one number at the prompt, separate each number with a space, not a comma.


    # /usr/sbin/setld -l /cdrom/DTK420/kit

    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.

    1) DECface, A Talking Articulated Face - Sample Program (unsupported).
    2) DECtalk Software V4.2A for Digital UNIX CDE Integration.
    3) DECtalk Software V4.2A for Digital UNIX Release Notes.
    4) DECtalk Software V4.2A for Digital UNIX Runtime Kit.
    5) DECtalk Software V4.2A for Digital UNIX Runtime Users Guide.
    6) Emacspeak, Speech Enabled Emacs - Sample Program (unsupported).

    Or you may choose one of the following options:

    7) ALL of the above
    8) CANCEL selections and redisplay menus
    9) EXIT without installing any subsets

    Enter your choices or press RETURN to redisplay menus.

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

    Next, the script lets you verify your choice. For example, if you enter 7 in response to the previous prompt, you will see the following display:

    You are installing the following optional subsets:

    DECface, A Talking Articulated Face - Sample Program.

    DECtalk Software V4.2A for Digital UNIX CDE Integration.

    DECtalk Software V4.2A for Digital UNIX Release Notes.

    DECtalk Software V4.2A for Digital UNIX Runtime Kit.

    DECtalk Software V4.2A for Digital UNIX Runtime Users Guide.

    Emacspeak, Speech Enabled Emacs - Sample Program.


    Is this correct? (y/n):

    If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is displayed again and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. After you respond to this question, the rest of the installation proceedes automatically and all the selected subsets are loaded. A sample of the rest of the installation script is listed below.

    Checking file system space required to install selected subsets:

    File system space checked OK.

    6 subset(s) will be installed.

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

    ***********************************************************************
    * *
    * DECtalk Software Application Services V4.2A *
    * Runtime Subset *
    * *
    * Copyright(c)Digital Equipment Corporation, 1996 All Rights Reserved *
    * *
    * Unpublished rights reserved under the copyright laws of the United *
    * States. The software contained on this media is proprietary to *
    * and embodies the confidential technology of Digital Equipment *
    * Corporation. Possession, use, duplication or dissemination of the *
    * software and media is authorized only pursuant to a valid written *
    * license from Digital Equipment Corporation. *
    * *
    * RESTRICTED RIGHTS LEGEND 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. *
    * *
    ***********************************************************************

    DECtalk Software V4.2A for Digital UNIX Runtime Kit.
    Copying from . (disk)
    Verifying

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

    DECtalk Software V4.2A for Digital UNIX Runtime Users Guide.
    Copying from . (disk)
    Verifying

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

    DECtalk Software V4.2A for Digital UNIX Release Notes.
    Copying from . (disk)
    Verifying

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

    ***********************************************************************
    * *
    * DECtalk Software Application Services V4.2A *
    * DECface Subset *
    * *
    * Copyright(c)Digital Equipment Corporation, 1996 All Rights *
    * Reserved *
    * *
    * Unpublished rights reserved under the copyright laws of the United *
    * States. The software contained on this media is proprietary to *
    * and embodies the confidential technology of Digital Equipment *
    * Corporation. Possession, use, duplication or dissemination of the *
    * software and media is authorized only pursuant to a valid written *
    * license from Digital Equipment Corporation. *
    * *
    * RESTRICTED RIGHTS LEGEND 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. *
    * *
    ***********************************************************************


    DECface, A Talking Articulated Face - Sample Program.
    Copying from . (disk)
    Verifying

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

    ***********************************************************************
    * *
    * DECtalk Software Application Services V4.2A *
    * Emacspeak Subset *
    * *
    * Copyright(c)Digital Equipment Corporation, 1996 All Rights *
    * Reserved *
    * *
    * Unpublished rights reserved under the copyright laws of the United *
    * States. The software contained on this media is proprietary to *
    * and embodies the confidential technology of Digital Equipment *
    * Corporation. Possession, use, duplication or dissemination of the *
    * software and media is authorized only pursuant to a valid written *
    * license from Digital Equipment Corporation. *
    * *
    * RESTRICTED RIGHTS LEGEND 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. *
    * *
    ***********************************************************************

    Emacspeak, Speech Enabled Emacs - Sample Program.
    Copying from . (disk)
    Verifying

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

    DECtalk Software V4.2A for Digital UNIX CDE Integration.
    Copying from . (disk)
    Verifying

    6 of 6 subset(s) installed successfully.


    ***********************************************************************

    DECtalk Software V4.2A runtime subset (DTKRT420) installation completed
    successfully.

    To verify that the kit installed properly please run the Installation
    Verification Program by typing:

    /usr/sbin/setld -v DTKRT420

    ***********************************************************************


    Configuring "DECtalk Software V4.2A for Digital UNIX Runtime Kit." (DTKRT420)

    ***********************************************************************

    DECtalk Software V4.2A runtime documentation subset (DTKRTDOC420)
    installation completed successfully. This installation puts the the
    DECtalk Software runtime documents in html format in the
    following directory /usr/opt/DTKRT420/docs/html.
    You can use the Netscape™ browser to view the documents. Start by opening the file:
    /usr/opt/DTKRT420/docs/html/DtkUsersGuide.html

    ***********************************************************************


    Configuring "DECtalk Software V4.2A for Digital UNIX Runtime Users Guide." (DTKRTDOC420)

    **************************************************************************<>
    DECtalk Software V4.2A runtime release notes subset (DTKRTRELNOT420)
    installation completed successfully. This installation put DECtalk
    Software development subset release notes in the following directories:

    /usr/opt/DTKRT420/docs/ascii and
    /usr/opt/DTKRT420/docs/postscript

    **************************************************************************<>

    Configuring "DECtalk Software V4.2A for Digital UNIX Release Notes." (DTKRTRELNOT420)

    ***********************************************************************

    DECtalk Software V4.2A runtime subset (DTKDFCRT420) installation
    completed successfully.

    To run the program, at the command prompt please type:
    DECface

    An introduction to the application is located in:
    /usr/opt/DTKRT420/decface/docs/ascii

    To access man pages, please install the subset DTKRTDOC420.scp
    and type:
    man 1 DECface

    ***********************************************************************


    Configuring "DECface, A Talking Articulated Face - Sample Program." (DTKDFCRT420)

    ***********************************************************************

    DECtalk Software V4.2A runtime subset (DTKEMSRT420) installation
    completed successfully.

    To run the program, please refer to the emacspeak-README.txt file
    in:
    /usr/opt/DTKRT420/emacspeak/docs/ascii

    ***********************************************************************


    Configuring "Emacspeak, Speech Enabled Emacs - Sample Program." (DTKEMSRT420)


    **************************************************************************<>
    DECtalk Software V4.2A CDE Integration subset (DTKRTCDE420) installation
    completed successfully.

    **************************************************************************<>

    Configuring "DECtalk Software V4.2A for Digital UNIX CDE Integration." (DTKRTCDE420)
    #


    Stopping the Installation

    To stop the installation procedure at any time, enter Ctrl/C. Then, interactively delete the files created by the installation up to the point where you stopped the installation. The directories and files created during the DECtalk Software installation are listed in the following file:

    /usr/opt/DTKRT420/docs/ascii/filelist.txt
    If you encounter any failures during installation, see Reporting Problems, page 32.

    You may interrupt the installation procedure at any point. However, if you do, the installation may not be left in a useful state. Remove all the subsets you installed and reinstall them.


    Post-Installation Tasks

    This section explains what you need to do after the installation to make DECtalk Software ready for use. Topics include:

  • Running the installation verification procedure (see Running the Installation Verification Procedure , page 30)

  • Deleting DECtalk Software from your system (see Deleting DECtalk Software from Your System, page 30)

  • Displaying documentation from the CD-ROM distribution disk. (see Displaying Documentation from the CD-ROM Distribution Disc, page 31)

  • Solving problems during product installation (see Correcting Problems During Product Installation , page 31)

  • Failures during product use. (see Reporting Problems, page 32)

  • Running the Installation Verification Procedure

    You can run the Installation Verification Procedure (IVP) during the installation or you can run the IVP independently after installing DECtalk Software 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 DECtalk Software.

    To run the IVP command:

    % su root
    #/usr/sbin/setld -v DTKRT420

    The DECtalk Software IVP verifies the installation as follows:

    A check for a valid LMF license is made. If no license is found, the IVP fails because the software cannot be tested.

    DECtalk Software requires that the Multimedia Software for Digital UNIX server mmeserver be up and running. If the mmeserver is not already running then the IVP fails. Start the server and try again. To start the server follow the sequence shown below:

    % su root
    # mmeserver&


    Deleting DECtalk Software from Your System

    If you must remove a version of DECtalk Software from your system, delete each subset that you previously installed.

    For example to delete a subset, do the following:

    Log in as superuser login name root, as follows:

    % su root
    Verify that you are at the root directory (/) by entering the following command:

    # cd /
    Enter the following form of the setld) commands:

    # setld -i | grep DTK
    Look for the word installed in the listing produced, and then delete the installed subsets. For example:

    # setld -d DTKRT420 DTKDEV420


    Displaying Documentation from the CD-ROM Distribution Disc

    The DECtalk Software documentation is provided on the Digital UNIX Layered Products Online Documentation CD-ROM in Bookreader (.decw_book) file format. You can display the Bookreader files on your workstation using the DECwindows Bookreader application. For information on accessing and displaying these files, see the Digital UNIX Layered Products Disc User's Guide.

    Correcting Problems During Product Installation

    If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, a message similar to the following is displayed:

    There is not enough space for subset SUBSET_NAME
    SUBSET_DESCRIPTION (SUBSET_NAME) will not be loaded.
    where:

    SUBSET_NAME is the name of the subset
    SUBSET_DESCRIPTION is the description of the subset
    For example, DTKRTRELNOT420 is a subset name and DECtalk Software for Digital UNIX Release Notes V4.2A is a subset description.

    Errors can occur during the installation if any of the following conditions exist:

    1. Operating system version is incorrect.

    2. Prerequisite software version is incorrect.

    3. Disk space is insufficient.

    4. System parameter values for successful installation are insufficient.

    For descriptions of error messages generated by these conditions, see the Digital UNIX documentation on system messages, recovery procedures, and software installation.


    Reporting Problems

    If an error occurs while DECtalk Software is in use and you believe the error is caused by a problem with the product, take one of the following actions:

    If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following:

    1. The name and version number of the operating system you are using

    2. The version number of DECtalk Software you are using

    3. The hardware system you are using (such as a model number)

    4. A brief description of the problem (one sentence, if possible)

    5. How critical the problem is

    6. If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR).

    7. If you do not have any type of software services support agreement and you purchased DECtalk Software within the past year, you can submit an SPR if you think the problem is caused by a software error.

      When you submit an SPR, take the following steps:

    8. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the DECtalk Software being used. Explain the problem with specific examples.

    9. Reduce the problem to its elements.

    10. Remember to include listings of any command files, include files, relevant data files, and so forth.

    11. Provide a listing of the program.

      If the program is longer than 50 lines, submit a copy of it on machine-readable media (floppy diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application.

      For information about submitting media, see the tar(1) reference page.

    12. Report only one problem per SPR. This will facilitate a faster response.

    13. Mail the SPR package to Digital.

      If the problem is related to DECtalk Software documentation, you can do one of the following:

    14. Report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe).

    15. Fill out the Reader's Comments form (located at the back of the document that contains the error) and send the form to Digital. Be sure to include the action and page number where the error occurs.