Define environment variables for the login or create a script to define the variables. Following is an example of how to set these variables. Keep in mind names and locations will be specific for your installation. For example:
# Unset up environment variables ORACLE_SID=
ORACLE_BASE= ORACLE_HOME= NLS_LANG=
PATH=`echo $PATH | cut -d. -f1` # Set up environment variables ORACLE_SID=KANA ORACLE_BASE=/export/home/local/oracle ORACLE_HOME=${ORACLE_BASE}/product/Orahome10g NLS_LANG=AMERICAN_AMERICA.UTF8 PATH=${PATH}.:${ORACLE_HOME}/bin LD_LIBRARY_PATH=/usr/X/lib:/usr/openwin/lib:/usr/dt/ lib:${ORACLE_HOME}/lib
export ORACLE_BASE ORACLE_SID ORACLE_HOME NLS_LANG ORA_NLS33 PATH LD_LIBRARY_PATH
# Set up aliases
alias ora="ps -ef | grep ora_ | grep -v grep" alias lsnr="ps -ef | grep tnslsnr | grep -v grep" alias exprt="cd ${ORACLE_ADMIN}/exp && ls -l" alias imprt="cd ${ORACLE_ADMIN}/imp && ls -l"
alias pfile="vi ${ORACLE_ADMIN}/pfile/init${ORACLE_SID}.ora" alias bdump="cd ${ORACLE_ADMIN}/bdump && ls -l"
alias udump="cd ${ORACLE_ADMIN}/udump && ls -l" alias alert="tail -100 ${ORACLE_ADMIN}/bdump/ alert_${ORACLE_SID}.log"
Step 2: Prepare the AIX Host Server
To install and run the KANA Response Application Server on AIX, you must have the following:
• An account with root privileges
• Database instance name and user account (user name and password) of the database you plan to use with KANA Response
• Database server name, port number, and connection pool size information of the database you plan to use with KANA Response. • Oracle client installed and configured with a proper TNSnames alias.
Confirm the Oracle client and alias work by connecting to the database instance thru SQLPlus.
• A minimum of 512 MB of memory for use by the KANA Response Application host server.
Install KANA Response Application Server
When you install the KANA Response Application Server, the following information is required:
• Installation Root Directory – This is the top-level directory where the KANA Response Application Server would be installed. By default, the installer places the installation under the directory /opt. You can specify another directory, such as /usr/local/.
• Package Directory – The location where the contents of the KANA Response Application Server tar file was extracted.
• KANA Application Server Node name – The name of the computer on which you are installing the KANA Response Application Server. • Log file directory – The directory where the KANA Response
Application Server writes all log files during normal server operation. By default, the installer creates the following directory structure: /kana/response/shareddir/logs.
• Locallog directory – The directory where the KANA Response Application Server writes all log files during server node startup and shutdown. By default, the installer creates the following directory structure:
/kana/response/locallog.
Step 3: Install KANA Response Application Server
All examples in the instructions use the Bourne shell. If you use a different shell (or command line interpreter), refer to its documentation for the correct syntax.
To install KANA Response Application Server on AIX:
1 Log in as root on the system where the KANA Response Application Server would be installed. (You must have root access in order to use the KANA Response Application Server installation script).
2 Create a temp directory where you could download the KANA Server distribution files.
3 Download the KANA Response Application Server AIX tar file into the temp directory you created.
4 Gain root access either by logging in as root or by using su.
5 Copy the AIX installer tar file to a temporary directory.
6 Extract the files from the tar file. The command to extract the tar file is:
% tar -xvf kanaserver_sol9.1.0.xxx.tar
where xxx is the build number.
After extracting the KANA Response Application Server tar file, you can check the version and build number of the KANA Response Application Server by typing the following:
% ./pkginst
The version number and build number are displayed in the banner.
7 To install the KANA Response Application Server, type:
% ./pkginst add
8 On the KANA Response Application Server license agreement dialog, press the space bar to scroll to the bottom. Press y.
9 Choose the installation directory. Press ENTER to accept the default installation directory displayed in brackets or type the name of a new directory.
10 Verify the location of the KANA Response Application Server package (where you downloaded and extracted the AIX server tar file). You can Press ENTERto accept the default location, or type the name of a new package directory.
11 When prompted, enter the appropriate values for your node name, shared directory location, a locallog location, for example. The default values that appear in brackets on your screen may be different than the default values that appear in brackets below:
KANA Server Node Name [KANA]?
Shared directory [/opt/kana/response/shareddir]? Local Log directory [/opt/kana/response/locallog]?
The Local Log File Directory should be installed locally, but if you are configuring multiple nodes, KANA recommends installing the System Shared Directory on a server other than your Response Application Server hosts. All nodes require access to the System Shared Directory — this directory contains all the configuration information for your nodes. If you install the System Shared Directory on one of your Response Application Server hosts and that server goes down or is
Edit the System Configuration File
taken offline, the other nodes in the KANA Response cluster will become unresponsive.
12 At this point, if you are prompted to “select packages to process”, type q and press <Enter>.
13 The user will be prompted to “Enter Oracle Mode Supported. If it is 9i or less, enter 32 or 64, entering the value as appropriate. If the
operating system is 64 bit, enter 64 or else 32.
14 When the installation is complete, the following message appears:
Installation completed successfully.
Check the AIX Directory Structure
Under <kana_home> are several directories: bin, db, jre, lib, locallog, and shareddir.
bin Contains control scripts and log files for the KANA Response Application Server.
db Contains database Archive and ArchiveView scripts.
jre Location of the Java Runtime Environment (for example 1.5.0). lib Contains the KANA classes (kana.zip) and third-party Java
classes, such as JDBC classes, jgl.zip, and oro.zip.
locallog Log files created during server startup and shutdown are written here. Also, the locallog directory is a failover logging location if shareddir were to become unavailable.
shareddir Server log files written under normal operation are written here. The majority of KANA Response Application Server logging is here.
Step 4: Edit the System Configuration File
Before you could start the KANA Response Server, you must edit the System Configuration File (config.xml). By default, the config.xml file is located in:
/opt/kana/response/shareddir
For the parameters you enter to establish the structure and connectivity for the KANA Response system, refer to “Editing the System
Step 5: Edit the setkanaenv File
If you have installed the Instant Client Package, before you can start the KANA Response Server, you must edit the environment file setkanaenv. By default, the setkanaenv file is located in:
/opt/kana/response/bin
Once you locate the file, modify the class path for ojdbc6.jar.
Example:
From: /usr/lib/oracle/11.2/client64/jdbc/lib/ojdbc6.jar To: /usr/lib/oracle/11.2/client64/lib/ojdbc6.jar
No changes are needed if Oracle Database 10g Client Release is installed.
Installing KANA Response Application Server on Solaris with Oracle