This section has the steps you need to take to install Tomcat on UNIX. Check “Supported KANA Response Application Server and Database Configurations” on page 19 for the correct version.
➤
To install the Tomcat server on UNIX, download the respective binaries for your type of UNIX and follow these steps:1 Download the Tomcat x.x.xx tar file from: http://tomcat.apache.org/.
2 Copy the tar file to the UNIX box in the directory, for example, “/usr/ local”.
3 Decompress and untar the file by executing the commands, using the correct version number:
gzip –d apache-tomcat-x.x.xx.tar.gz tar –xvf apache-tomcat-x.x.xx.tar
4 Provide the JAVA home path and the JRE path in the catalina.sh properties file.
5 Change the directory to /usr/local/apache-tomcat-x.x.xx/bin and execute the command:
./startup.sh
6 Test Tomcat by loading the following URL in a web browser: http://servername:8080/
To change the Tomcat port, edit the server.xml in tomcat-home/conf folder.
Install the KANA Response Web Server on UNIX Platforms (Solaris, AIX or Linux)
Step 2: Install the KANA Response Web Server on
UNIX Platforms (Solaris, AIX or Linux)
AIXSolaris and Liux platforms are available with Response 10 R4.
If you have questions about supported platforms, please contact Support:
• Visit www.kana.com and browse to Support
• Call (866) 753–KANA • email [email protected]
See the KANA Reports Installation and Configuration Guide for the prerequisites for installing the Web Server and KANA Reports.
➤
Once Apache and Tomcat are installed and the connector isconfigured, follow these steps to install the KANA Response Web Server on UNIX:
1 Extract KanaResponseWebServerUnix_<version no>.zip file to the appropriate directory.
For example, /usr/kana/KANAResponseWebServer
Create directories if required, which will result in the following web archive files: KANAForms.war KANAMessageClose.war KANAResponseWebServer.war KANAProxy.war ResponseStart.war
2 Copy and extract KANAResponseWebServer.war file from the current directory to the folder that will be the KANA Response Web server virtual directory.
cp KANAResponseWebServer.war /usr/kana/KANAResponseWebServer/ jar -xvf KANAResponseWebServer.war
3 Next, run the configure.sh script from the KANAResponseWebServer directory and answer the questions that follow:
Enter the Response Web Server URL http://<server-name>/virtual name Enter the Host Name
<host server name> Enter the Port Number 2656
Enter the Partition Name <partition name>
Enter the Display Name <display name>
Use secure sockets(default:false, true)
The virtual directory needs to be added manually in the Apache configuration files instructions.
During the installation of the Response Web server in UNIX, after performing ./configure .sh, it is necessary to manually add the virtual directory under the virtual host in the Apache conf files.
To do this, copy and paste these lines in <apache_home>/conf/httpd.conf and httpd-std.conf files before starting the service:
<Directory "/usr/kana/KANAResponseWebServer/download" > AllowOverride None
Options All Order allow,deny Allow from all jnlp
DirectoryIndex default.htm </Directory>
Alias /KANADownload "/usr/kana/KANAResponseWebServer/ download"
<Directory "/usr/kana/KANAResponseWebServer" > AllowOverride None
Options All Order allow,deny Allow from all
DirectoryIndex default.htm </Directory>
Alias /<Virtual Directory> "/usr/kana/KANAResponseWebServer" NOTE: "/usr/kana/KANAResponseWebServer/" is the Response Web Server home directory. Your home directory may be different.
Install the KANA Response Web Server on Windows
Step 3: Install the KANA Response Web Server on
Windows
Once the Web Server prerequisites are met, you can install the KANA Response Web Server.
To install the KANA Response Web Server:
1 Log on to the KANA Response Web Server host using an account with Administrator permissions.
2 Open a Windows Explorer window and navigate to the directory where you downloaded the KANA Response Web Server executable file.
3 Double-click KANAWebClient_9.x to launch the KANA Response Web Server installer.
4 Click Next on the Welcome dialog.
5 Click Yes to accept the license agreement.
6 On the Web Server Selection dialog, select the web server that you are using and click Next.
7 From Components Dialog select Select Componentsand click Next.
Note: Proxy servlet, Forms web application, Classify and
IQMessageClose installations are optional and have their own
prerequisites. You can re-run the KANA Response Web Server installer at a later time to install these features.
– For proxy servlet installation instructions, refer to “Configuring a Proxy Servlet” on page 183.
– For Forms installation instructions, refer to the KANA Response Forms Guide.
– For the Classify component instructions, refer to the KANA Classify Guide.
– For IQMessageClose installation instructions, refer to the KANA ResponseIQ Integration Guide.
8 Select the access mode from the Access Mode Dialog and click Next.
Appendix , Client Access Modes has more information on the different access modes available for Response.
Note:By default the Applet check box and Webstart check box are selected. If required to change the access mode clear the check box for the mode that is not required. To access the applet mode, go to:
http://<servername>/virtual name/Responseapplet.htm
9 In the Choose Destination Location dialog, choose the installation path for the KANA Response Web Server files and click Next. To choose a non-default installation folder, click the Browse button and perform one of the following:
• Select a mapped network drive from the Drive menu and select a folder from the Directories list.
• In the Path field, type a local or mapped network path. For example, D:\Program Files\KANA\KANA Response Web Server • In the Path field, type a UNC (Universal Naming Convention) path
to a shared directory on a network server. For example, \\Kanaweb\Program Files\KANA\KANA Response Web Server
10 Enter the Web Server Root URL and click Next. Use the fully-qualified domain name or IP address.
11 Enter the port used by your web server. For example, IIS uses port 80 by default.
12 Click Next to start copying files.
13 When prompted to set up a server connection, click Yes.
14 Enter a Share name for the server connection and click Next. This Share name is used to configure your web server and becomes part of the URL used to access Response.
For example, if the name of the host server is kanaweb and you enter KanaWebServer as your Web Share name, users can open a browser window and navigate to http://kanaweb.yourcompany.com/ KanaWebServer to access the Response applications.
Install the KANA Response Web Server on Windows
15 Enter a Web display name and click Next. Response users will select this name from the Servers menu when logging in to Response.
16 Enter the name of your primary KANA Response Application Server node and click Next.
17 In the Partition name for server connections dialog, enter the name of your Response database and click Next.
18 Enter the port used by the KANA Response Application Server and click Next. KANA recommends using the 2656 default port setting. Information about changing this number and the restrictions, can be found on page 105.
19 When prompted to create more server connections, click Yes if you have multiple nodes or partitions. Click No if you are setting up an environment with only one node and one partition.
20 Click Finish to complete the Response Web Server installation.
21 Restart the host server.