Installing EP in EAServer

You must install EP with EAServer 5.0. Install EAServer 5.0 before you install EP. If you already have EAServer 4.x installed, upgrade to EAServer 5.0, and then install EP.

To install EAServer, use the EAServer automated Install Shield package and follow the EAServer installation documentation. If you have problems or questions, see the EAServer installation documentation.

Before you start:

Verify that EAServer 5.0 is installed.

Install EAServer patches or EBFs. See the Enterprise Portal – Information Edition Release Bulletin for information.

Make sure JDK 1.4 is installed, as EP requires JDK 1.4.

Installing EP in EAServer

Typically you can use any account to install EP in EAServer. However, if you plan to use port 80 (HTTP) and port 443 (HTTPS), you must log in as root to install EP.

If you plan to use ports 80 (HTTP) and 443 (HTTPS), log in as root. Otherwise, skip this step.

Make sure EAServer is up and running before you proceed. Note the following assumptions

Server name – must be “Jaguar”
Default HTTP port – 8080
Default HTTPS port – 8081

Currently, these port numbers are required.

Make sure that EAserver has been started with the correct JDK version ($JAGUAR/bin/serverstart.sh -jdk14), by checking the Jaguar.log for the following:

Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: javaversion 1.4.
2_03Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: Java HotSpot(TM)
Client VM (version 1.4.2_03-b02, mixed mode)

Make sure no other Adaptive Server Anywhere instance is using port 4747.

From a terminal window, make sure the $SYBASE, $JAGUAR, and $JAVA_HOME environment variables are set. If not, set them; for example:

setenv SYBASE /opt/sybase
setenv JAGUAR $SYBASE/EAServer
setenv JAVA_HOME $SYBASE/shared/jdk1.4.0

The $SYBASE environment variable is set to the parent directory of $JAGUAR if $SYBASE is not set. You can also set $SYBASE to a JDK 1.4 installation, otherwise it is set to the JDK 1.4 version that is used by EAServer.

Using a zip utility, locate ep61EAS.tar.gz on the installation CD, and unzip its contents to $SYBASE.

Optionally, you can set the $JAGTOOL and $JAGTOOLARGS environment variables, which are supported by the setup.sh file. For example, if you are using a non-default IIOP port in EAServer, you can set the environment to:

setenv JAGTOOL $JAGUAR/bin/jagtool
setenv JAGTOOLARGS "-n 9100"

Go to $SYBASE/EP/scripts and execute:

setup.sh sybase.com csi

The csi argument is required.

This installs and configures EP, including:

Web components:
- onepage
- DiscussionForum
- InstantMessaging
- PortalExplorer
- CustView
EAServer package:
- csi-easerver

When the installation is complete, EAServer restarts, and Sybase ASA starts on port 4747.

Verify that EAserver restarted with the correct JDK version, by checking the Jaguar.log for the following:

Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: javaversion 1.4.
2_03Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: Java HotSpot(TM)
Client VM (version 1.4.2_03-b02, mixed mode)

If not, stop EAServer using standard procedures, and restart it by using $JAGUAR/bin/serverstart.sh -jdk14.

Verify that Adaptive Server Anywhere started correctly.

Start and stop scripts for Sybase ASA are in $SYBASE/EP:

startdb.sh – starts the ASA portaldatabase on port 4747
stopdatabase.sh – stops the ASA portaldatabase

Verify the EP installation by accessing Web Studio from a browser window and entering:

http://HOSTNAME.PORTALDOMAIN:port/onepage/index.html

For example:

http://lab2k.syabse.com:8080/onepage/index.html

See “Getting started with Portal Interface” and “Getting started with Web Studio” for information. Be sure to use port 8080 when running Enterprise Portal – Information Edition from EAServer.