Các đặc tính của E-Speak Gatewway

Features

The e-speak Gateway Usage interface supports all the critical features of e-speak using a document-based interface:
• Vocabulary definition
• Service registration
• Service lookup
• Service invocation (synchronous interactions only)
• Client login session handling
• User account creation and management
• Service URL lookup (HTTP post)
This section describes Apache/Jserv and Tomcat installation and setup.

Conventions
This section follows these conventions:
• <installation_directory> is the e-speak installation directory
• <APACHE> is the Apache installation directory
• <JSERV> is the Apache JServ installation directory
• <JDK> is the JDK installation directory
• <JSDK> is the Java™ Servlet Development Kit installation directory
• <TOMCAT> is the Tomcat installation directory
Changes in Webmacro.properties
1 Open the file:
<installation_directory>/extern/webmacro/Webmacro.properties
2 Change the TemplatePath to point to:
<installation_directory>/config/htdocs/templates
For example, for Windows NT, the line should be <installation_directory>/
config/htdocs/. Substitute the actual installation directory path for
<installation_directory>. The template files are used for internally generating
XML messages and for HTML page templates.
Changes in WebAccess.xml
1 Open the configuration file:
<installation_directory>\extern\webmacro\webaccess .xml
This file contains the settings used to set the password, expiration time,
hostname, web proxy name, and database connection information. You can also
use it to enable or disable the persistent message queue and debugging.
2 Locate <TokenManager>. Inside this is a <TokenPassword>, which is a key used
to encrypt the session tokens given to clients.
3 Change the <TokenPassword> as needed.
NOTE: To ensure security, each site should have a unique <TokenPassword>.

4 Locate <ExpireIntervalSecs> and make any necessary modifications. This
element sets the expiration interval for each token. The default setting is 14400
seconds.
5 Update the information for JDBC connection in the configuration file in:
• The name of the host running the Oracle database
• The user name and password
6 Locate <webServerInfo>.
7 Set the hostname to your hostname.
8 Locate <webProxyInfo>.
9 Set the hostname to your proxy.
Setting the Shell Environment for Unix and Linux™ Platforms

The following procedures describe how to make the required changes to the two
configuration files.
Changes in jserv.properties
1 Locate these sections in the jserv.properties file and ensure that the paths
are valid:
# The Java Virtual Machine interpreter.
wrapper.bin=<JDK>\122\bin\java.exe
# CLASSPATH environment value passed to the JVM
wrapper.classpath=<JSERV>\ApacheJServ.jar
wrapper.classpath=<JSDK>\lib\jsdk.jar
2 Add the following lines, as appropriate, for the path and classpath:
# PATH environment value passed to the JVM (to be added)
wrapper.path=<installation_directory>\lib
# Additional CLASSPATH to be added
wrapper.classpath=<installation_directory>\lib
wrapper.classpath=<installation_directory>\lib\es. jar
wrapper.classpath=<installation_directory>\extern\ webmacro\
webmacro.jar
wrapper.classpath=<installation_directory>\extern\ webmacro
wrapper.classpath=<installation_directory>\extern\ parser\xerces.jar
wrapper.classpath=<installation_directory>\extern\ cryptix\cryptix.jar
wrapper.classpath=<installation_directory>\extern\ cryptix
wrapper.classpath=<installation_directory>\extern\ ldap\ldapjdk.jar
wrapper.classpath=<installation_directory>\extern\ oraclelib\
816\classes12.zip
If you are using Linux™, add this line to the properties text:
wrapper.env=LD_LIBRARY_PATH=<installation_director y>/lib

Testing Gateway Usage Configuration When Using Apache/Jserv

NOTE: Before you begin this procedure, stop all JVMs.
1 Start the core:
cd <installation_directory>\bin.\espeak
2 Start the Apache server from the installation_directory>\config
directory. For example: cd <installation_directory>\config
“<APACHE>\Apache.exe” -d “<APACHE>” -s

NOTE: Use double quotes only if your <APACHE> has blanks in it. If you use a Windows NT® shortcut, modify the icons Start In property to <installation_directory>\config. You can also start the Apache server by copying these files from the <installation_directory>/
config directory to <APACHE> directory: espeak.cfg, securestore.bin, clientcerts.adr, and servicecerts.adr. You
can then start Apache the normal way.
3 Launch a web browser, such as Netscape Navigator or Microsoft InternetExplorer.
4 Point the browser to http://localhost. Depending on your configuration,you may need to use your actual hostname instead of localhost if the Loginscreen does not display.

Installing Tomcat on Windows NT®

NOTE: You must have Win32 tools, such as WinZip™, to extract the downloaded zip files.

To install Tomcat:
1 Download jakarta-tomcat.zip from http://jakarta.apache.org.
2 Unzip the file into a directory. The installation creates a new subdirectory jakarta-tomcat within the directory.

NOTE: For best results, do not include spaces in the directory name.
3 Rename jakarta-tomcat to tomcat.
4 Set a new system environment variable TOMCAT_HOME to point to the root directory of your Tomcat hierarchy. For example:
TOMCAT_HOME=c:\foo\tomcat

5 Set the system environment variable JAVA_HOME to point to the root directory of your JDK hierarchy. Tomcat requires JDK 1.2.2 or later version. For example, if your JDK 1.2.2 is installed under c:\pctools\jdk122\, set your JAVA_HOME variable to:
JAVA_HOME=c:\pctools\jdk122

6 Modify the PATH environment variable to include the e-speak libraries and webmacro files:
set
PATH=%PATH%;<installation_directory>\lib;<installa tion_directory>\
extern\webmacro
7 Modify the CLASSPATH to include all the jar files in the e-speak release:
CLASSPATH=.;<installation_directory>\lib;<installa tion_directory>\extern\cryptix;<installation_direc tory>\extern\cryptix\cryptix.jar;<installation_dir ectory>\extern\parser\xerces.jar;d:\pctools\javato ols\jsdk20\lib\jsdk.jar;<installation_directory>\e xtern\webmacro;<installa
tion_directory>\extern\webmacro\webmacro.jar;
d:\espeak\extern\ldap\ldapjdk.jar;<installation_di rectory>\extern\oracle-lib\816\classes12.zip

Verifying the Tomcat Installation
To verify the Tomcat installation, start and stop Tomcat from the
<installation_directory>\config directory using the scripts provided with the installation.

Starting Tomcat
To start Tomcat:
1 Navigate to <installation_directory>\config.
2 Enter the start or run command:
htdocs\tomcat start or
htdocs\tomcat run

You will see the message Starting tomcat and the classpath. Disregard the File not found message for the tomcat_users.xml file or the No webapps directory message.

Stopping Tomcat
To stop Tomcat, enter the stop command from the
<installation_directory>\config directory:
htdocs\tomcat stop

You will see the message Stop Tomcat and the classpath.