This chapter covers the preinstallation, installation and post installation tasks required to install DECtalk Software on your system. Topics include:
The release notes for DECtalk Software are in the following files after the DTKDEVRELNOTES420 subset is installed:
/usr/opt/DTKDEV420/docs/ascii/release_notes_dev.txt
/usr/opt/DTKDEV420/docs/postscript/release_notes_dev.ps
Use the following command to read the release notes for DECtalk Software after the DTKDEVRELNOT420 subset is installed:
# more /usr/opt/DTKDEV420/docs/ascii/release_notes_dev.txt
You can also print either file.
Note
You must have the root 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.
In addition to this guide, the software distribution kit includes the following:
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/DTKDEV420/docs/ascii:
dtk420_prog_guide.txt filelist_dev.txt
dtk420_release_notes_dev.txt
/usr/opt/DTKDEV420/docs/html:
DtkDevGuide.html
dt_u.html
dt_11.html
dt_22.html
dt_33.html
dt_44.html
dt_55.html
dectalkR.gif
redball.gif
yellowball.gif
/usr/opt/DTKDEV420/docs/man/man3:
TextToSpeechAddBuffer.3 TextToSpeechPause.3
TextToSpeechCloseInMemory.3 TextToSpeechReset.3
TextToSpeechCloseLogFile.3 TextToSpeechResume.3
TextToSpeechCloseWaveOutFile.3 TextToSpeechReturnBuffer.3
TextToSpeechGetCaps.3 TextToSpeechSetLanguage.3
TextToSpeechGetLanguage.3 TextToSpeechSetRate.3
TextToSpeechGetRate.3 TextToSpeechSetSpeaker.3
TextToSpeechGetSpeaker.3 TextToSpeechShutdown.3
TextToSpeechGetStatus.3 TextToSpeechSpeak.3
TextToSpeechLoadUserDictionary.3 TextToSpeechStartup.3
TextToSpeechOpenInMemory.3 TextToSpeechSync.3
TextToSpeechOpenLogFile.3
TextToSpeechUnloadUserDictionary.3
TextToSpeechOpenWaveOutFile.3
/usr/opt/DTKDEV420/docs/postscript:
dtk420_prog_guide.ps dtk420_release_notes_dev.ps
/usr/opt/DTKDEV420/examples/dtk/dtsamples:
Imakefile aclock.c mailtalk.c xmsay.c
README.txt dtmemory.c say.c xmsay.uil
/usr/opt/DTKDEV420/include/dtk:
dtmmedefs.h dtmmiodefs.h engphon.h ttsapi.h
/usr/opt/DTKDEV420/share/man/man3:
TextToSpeechAddBuffer.3dtk TextToSpeechPause.3dtk
TextToSpeechCloseInMemory.3dtk TextToSpeechReset.3dtk
TextToSpeechCloseLogFile.3dtk TextToSpeechResume.3dtk
TextToSpeechCloseWaveOutFile.3dtk
TextToSpeechReturnBuffer.3dtk
TextToSpeechGetCaps.3dtk TextToSpeechSetLanguage.3dtk
TextToSpeechGetLanguage.3dtk TextToSpeechSetRate.3dtk
TextToSpeechGetRate.3dtk TextToSpeechSetSpeaker.3dtk
TextToSpeechGetSpeaker.3dtk TextToSpeechShutdown.3dtk
TextToSpeechGetStatus.3dtk TextToSpeechSpeak.3dtk
TextToSpeechLoadUserDictionary.3dtk TextToSpeechStartup.3dtk
TextToSpeechOpenInMemory.3dtk TextToSpeechSync.3dtk
TextToSpeechOpenLogFile.3dtk
TextToSpeechUnloadUserDictionary.3dtk
TextToSpeechOpenWaveOutFile.3dtk
This section discusses the requirements for installing DECtalk Software.
Installation Procedure Requirements
Installing DECtalk Software takes approximately 5 minutes, depending on your type of media and system configuration.
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.
You can use either a hardcopy or video terminal to communicate with the operating system and respond to the prompts from the installation procedure.
# 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 Development kit you will need approximately 2 Mbytes of free disk space.
/usr/opt/DTKDEV420
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:
Topics include:
To install DECtalk Software from CD-ROM media:
# cd /
# mount -dr /dev/rz4c /cdrom
# /usr/sbin/setld -l /cdrom/DTK420/kit
See Starting the Installation Procedure, page 22 to continue the installation.
# cd /
/usr/bin/setld -l axpmme
See Starting the Installation Procedure on page 22 to continue the installation.
% su root
# cd /
# /usr/sbin/setld -i | grep DTKDEV
# cd /
# /usr/sbin/setld -d (name of subset)
# /usr/sbin/setld -l /dev/rmt0h
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.
# setld -l .
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) DECtalk Software V4.2A for Digital UNIX Development Documentation.
2) DECtalk Software V4.2A for Digital UNIX Development Kit.
3) DECtalk Software V4.2A for Digital UNIX Release Notes.
4) DECtalk Software V4.2A for Digital UNIX Sample Programs.
Or you may choose one of the following options:
5) ALL of the above
6) CANCEL selections and redisplay menus
7) EXIT without installing any subsets
Enter your choices or press RETURN to redisplay menus.
Choices (for example, 1 2 4-6): 5
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:
DECtalk Software V4.2A for Digital UNIX Development Documentation.
DECtalk Software V4.2A for Digital UNIX Development Kit.
DECtalk Software V4.2A for Digital UNIX Release Notes.
DECtalk Software V4.2A for Digital UNIX Sample Programs.
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 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.
4 subset(s) will be installed.
Loading 1 of 4 subset(s)....
DECtalk Software V4.2A for Digital UNIX Development Documentation.
Copying from . (disk)
Verifying
Loading 2 of 4 subset(s)....
***********************************************************************
*
*
* DECtalk Software Application Services V4.2A *
* Development 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 Development Kit.
Copying from . (disk)
Verifying
Loading 3 of 4 subset(s)....
***********************************************************************
* *
* DECtalk Software Application Services V4.2A *
* Sample Programs Subset *
* *
* Copyright(c)Digital Equipment Corporation, 1995-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 Sample Programs.
Copying from . (disk)
Verifying
Loading 4 of 4 subset(s)....
DECtalk Software V4.2A for Digital UNIX Release Notes.
Copying from . (disk)
Verifying
4 of 4 subset(s) installed successfully.
***********************************************************************
DECtalk Software V4.2A development documentation subset (DTKDEVDOC420)
installation completed successfully. This installation puts the DECtalk
Software runtime documents in html format in the following directory
/usr/opt/DTKDEV420/docs/html.
You can use the Netscape browser to view the documents. Start by
opening the
file:
/usr/opt/DTKDEV420/docs/html/DtkDevGuide.html
***********************************************************************
Configuring "DECtalk Software V4.2A for Digital UNIX Development
Documentation." (DTKDEVDOC420)
**************************************************************************<>
DECtalk Software V4.2A development subset (DTKDEV420) installation
completed successfully.
**************************************************************************<>
Configuring "DECtalk Software V4.2A for Digital UNIX Development Kit."
(DTKDEV420)
**************************************************************************<>
DECtalk Software V4.2A sample program subset (DTKSAMP420) installation
completed successfully. This installation puts the sample programs in
the following directory:
/usr/examples/dtk/dtsamples
**************************************************************************<>
Configuring "DECtalk Software V4.2A for Digital UNIX Sample Programs."
(DTKSAMP420)
****************************************************************************
DECtalk Software V4.2A development release notes subset
(DTKDEVRELNOT420)
installation completed successfully. This installation put DECtalk
Software
development kit release notes in the following directories:
/usr/opt/DTKDEV420/docs/ascii and
/usr/opt/DTKDEV420/docs/postcript
****************************************************************************
Configuring "DECtalk Software V4.2A for Digital UNIX Release Notes."
(DTKDEVRELNOT420)
#
/usr/opt/DTKDEV420/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.
To run the IVP command:
#/usr/sbin/setld -v DTKRT420
% su root
# mmeserver&
For example to delete a subset, do the following:
% su root
# cd /
# setld -i | grep DTK
# setld -d DTKDEV420 DTKDEVDOC420
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, "DTKDEVRELNOT420" 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:
For descriptions of error messages generated by these conditions, see the Digital UNIX documentation on system messages, recovery procedures, and software installation.
When you submit an SPR, take the following steps:
For information about submitting media, see the tar(1) reference page.
If the problem is related to DECtalk Software documentation, you can do one of the following: