Running silent installations on Linux

You can install Nuance Speech Suite silently with the -s option. The silent option allows you to install using a script, for example. You do not need to stop or restart services, which the installer does automatically during the installation.

Before you begin:

  • You must know which components you intend to install on this host. You do not need to install every component on every host. See Deployment architecture decisions.
  • You must ensure that each host has the necessary capacity for the components. See Required hardware and memory.
  • You must prepare the host with required software and configuration. See Configure hosts.
  • Recommended. If installing Management Station, ensure this host uses static IP addresses. (If you install it on hosts with dynamic IP addresses, ensure that your network can resolve the hostnames. For example, using ping.)
  • Recommended. If you are reinstalling Management Station and you do not want to reuse your existing databases, use the drop database command to remove them. Do this before running the Speech Suite installer.

You can change to the Nuance_Speech_Suite-version directory and enter ./setup.sh -h for a list of all options.

Note: If the syntax contains errors, such as incorrect format or invalid values, the installation might switch from silent to standard or not complete successfully.

Required options

These options are required: -f (license), -c (Connector/J), -j (Java), -o (Tomcat), and -V (language, voice, and data pack location), -H (database host:port pair), -Q (MySQL user), -W (MySQL password), -G (database name).

For example:

> ./setup.sh -s -f "/tmp/downloads/nuance.lic" -c "/tmp/downloads/mysql-connector-j-version.jar" -j "/usr/java/version" -o "/tmp/downloads/apache-tomcat-version" -V "/tmp/downloads" -H "MySQLHost:3306" -Q "ms" -W "msp" -G "mserver"

If enabling audit logging and creating the audit database, these options are also required: -A (database name), -B (database username), -S (database password). For example:

-A mserver_audit -B ms -S MyPass123!

If the installation fails on configuring the Management Station database, possible reasons and solutions include:

  • You failed to create the database user account (required on Windows only) using a fully qualified domain name. For example, did you specify hostname instead of hostname.domain.com? Try specifying a fully qualified domain name or IP address. The IP address must be resolvable, for example, using ping.
  • You specified an IP address for the Management Station host during the installation and it may not have been resolvable. Use static IP addresses on Management Station host if possible. If using a dynamic IP address, make sure the hostname is resolvable (for example, by testing with ping).

These options are required: -f (license), -j (Java), and -V (language, voice, and data pack location).

For example:

> ./setup.sh -s -f "/tmp/downloads/nuance.lic" -j "/usr/java/version" -V "/tmp/downloads"

If running Speech Suite components on different hosts, instead of running all components on the same host (the default), the -I option is required. For example, to install Nuance speech software (NSS), such as Vocalizer and Recognizer, only:

> ./setup.sh -s -f "Nuance license location" -j "/usr/java/version" -V "language, voice, dataPack location" -I "NSS"

Sourcing environment variables

After the installation has completed successfully, you must complete these steps:

  1. Open a new session to source environment variables.

  2. Change to /usr/local/Nuance/Speech Server/server and run the command: . ./SETUP-env.sh to finish sourcing remaining environment variables.

  3. Continue to one of the following topics:

All silent installation options

Here are all options for a silent installation. Values containing spaces must be enclosed in quotes (" ").

Option

Default

Description

Common

-h

Not applicable

Displays this usage information.

-I

All

Comma-separated list of Nuance speech products to install. For example, NLM,NMS,NSS.

  • All = All Nuance speech products (default)
  • NLM = Nuance License Manager
  • NMS = Nuance Management Station
  • NSS = Nuance speech software

-R

Not applicable

Removes all product installation packages (rpms), including language and voice, and a partial installation.

-U

Not applicable

Forces an in-place upgrade of the Nuance Speech Suite.

-s

Not applicable

Installs the Nuance Speech Suite silently (no prompts). You can use this with -R and -U.

-p

/usr/local

Installation path to Nuance directory.

-L

/tmp/nuance-speech-suite.log

Installation log output.

License Manager

-f

No default

Path and filename of license file.

Management Station

-l

27000@localhost

Address of the host running the License Manager.

-j

No default

64-bit Java JDK or JRE location.

-o No default Apache Tomcat location.

-c

No default

Full path and filename of the Connector/J JAR file. For example, mysql-connector.jar.
-H localhost:3306 Machine name or IP address where the Management Station database resides and the reserved port.

-Q

ms

Username for Management Station database (mserver) user account.

-W

msp

Password for Management Station database (mserver) user account. For MySQL, your password policy might require a secure password for the Speech Suite installation to complete successfully. If you are using Management Station and you change the MySQL user account password after installing Speech Suite, you must update Management Station with the new password. See Changing database passwords in Management Station .

Note: The Management Station installation has character restrictions for database passwords. See the list of unsupported characters in Create a MySQL user account. If the password contains $, type \ before each one to escape them. For example, you type password MyPa$$123$ as MyPa\$\$123\$

-A

mserver_audit

Creates an audit database and enables audit logging, which records all user actions in the Management Station.

-B

ms

Audit database username.

-S

msp

Audit database password.

Note: The Management Station installation has character restrictions for database passwords. See the list of unsupported characters in Create a MySQL user account. If the password contains $, type \ before each one to escape them. For example, you type password MyPa$$123$ as MyPa\$\$123\$
-G mserver Name of the Management Station database.

Nuance speech software

-m

localhost:8080

Comma-separated list of Management Station addresses.

-V

None

Directory containing the extracted language packages for Recognizer, voice packages for Vocalizer, and data packs for Krypton and Natural Language Engine (specifically for NTpE). Speech Suite recursively scans the specified directory for the installation executables.