Installing Novell exteNd

CHAPTER 1

Preparing to Install exteNd 5

This chapter presents an overview of the Novell exteNd 5 product suite installation program. The installation program is self-documenting, but there are some decisions you need to make before you run the install. This chapter helps you make them.

Topics include:

Latest information For the latest information on hardware and software requirements, supported databases, and specific install issues, see the Release Notes.

About the installation program

The installation program is an Install Anywhere Wizard that is similar on all platforms. There are five options for installing the Novell exteNd suite:

Option	Description	Platform
Express	Installs all suite products and features using a default configuration Autoconfigures MySQL Deploys the Express Portal	Windows only
Server Express	Installs all server components Autoconfigures MySQL Deploys the Express Portal	Windows, Linux, NetWare^®
Server	Installs only the server application features	Windows, UNIX, Linux, NetWare
Tools	Installs only the client application features	Windows only
Custom	Lets you select options to install a specific configuration of products and features	Windows, UNIX, Linux, NetWare

Before you install

Preparing your computer

If you have a previously installed version of any Novell exteNd product, uninstall it before installing this version of the Novell exteNd 5 suite.

If you need to uninstall an existing exteNd 5 installation, you can run the uninstall program from the Add or Remove Programs item from the Windows Control Panel, or from the Start menu shortcut in the Novell exteNd 5 program group. exteNd can also be manually uninstalled. See the section on What gets installed for a list of items to remove.

Making installation decisions

These are the decisions you need to make before you install Novell exteNd:

What to decide	Considerations	For information see
Which install will you use?	Applies to: Windows, NetWare, UNIX, and Linux Details: The different install options are customized for various typical uses	Choosing an installation option
Which database will you use for your SilverMaster?	Applies to: Windows, UNIX, and Linux (the suite install uses the existing exteNd Application Server and SilverMaster installed with NetWare) Details: The Application Server requires a SilverMaster database to maintain its own system information; you need to specify a database of a supported type (DBMS) to use as SilverMaster	Choosing a database for SilverMaster
Should you configure the Application Server to run as a service or daemon?	Applies to: Windows (on UNIX and Linux, this is done after installation; on NetWare, the Application Server automatically starts by default via autoexec.ncf) Details: If you want the Application Server to restart automatically whenever its host machine reboots, configure it to run as a Windows service or UNIX/Linux daemon	Installing the Application Server as a Service or Daemon

What to decide

Considerations

For information see

Which install will you use?

Applies to: Windows, NetWare, UNIX, and Linux

Details: The different install options are customized for various typical uses

Choosing an installation option

Which database will you use for your SilverMaster?

Applies to: Windows, UNIX, and Linux (the suite install uses the existing exteNd Application Server and SilverMaster installed with NetWare)

Details: The Application Server requires a SilverMaster database to maintain its own system information; you need to specify a database of a supported type (DBMS) to use as SilverMaster

Choosing a database for SilverMaster

Should you configure the Application Server to run as a service or daemon?

Applies to: Windows (on UNIX and Linux, this is done after installation; on NetWare, the Application Server automatically starts by default via autoexec.ncf)

Details: If you want the Application Server to restart automatically whenever its host machine reboots, configure it to run as a Windows service or UNIX/Linux daemon

Installing the Application Server as a Service or Daemon

Choosing an installation option

These are the five installation options available with exteNd 5.

Install option	What it does	Platforms / for instructions
Express	This is the simplest way to get started using the exteNd suite of products. In addition to installing all of the products, it creates and configures a MySQL database for use as a SilverMaster and deploys a portal project that can be used as a starting point for development, testing, or learning.	Windows For more information, see Express and Server Express Installs
Server Express	Installs the server components of exteNd, but not the designers and tools used for development. The Server Express install creates and configures a MySQL database for use as a SilverMaster and deploys a portal project that can be used as a starting point for development, testing, or learning.	Windows, Linux, and NetWare Express and Server Express Installs
Server	Installs the server components of exteNd, but not the designers and tools used for development. The Server install asks what type of database you will use for SilverMaster and requests specific configuration information such as port numbers and passwords. The Server install is appropriate for machines that will be hosting exteNd applications. On NetWare, Server Express uses the exteNd Application Server and MySQL installed with NetWare.	All platforms Server Install
Tools	The Tools option installs the exteNd design tools used for application development.	Windows Tools Install
Custom	The Custom option allows you to select which features are installed on your machine. You can specify your own preferences for databases, port numbers, and passwords.	All platforms. Custom Install

Choosing a database for SilverMaster

The SilverMaster is a database used by the Novell exteNd Application Server. There is one SilverMaster for each Application Server or cluster. The SilverMaster keeps track of all deployment databases used by the Application Server and also holds the Application Server's system tables—such as tables containing security group and user information. Applications can also be deployed to the SilverMaster.

Making a DBMS choice

When choosing a DBMS to host your SilverMaster, consider the following platform issues:

Platform	DBMS considerations for SilverMaster
Windows or Linux	The Express install option automatically installs and configures MySQL. You can choose any supported DBMS for SilverMaster using other installation types.
NetWare	MySQL is automatically installed and configured as SilverMaster as part of the NetWare installation.
UNIX	You must be using a supported DBMS product and create a database to be used as SilverMaster before running the install program.

The Application Serverr can communicate with multiple database engines at once. For example, you can install your SilverMaster database on Cloudscape and have all of your deployment databases on another DBMS, such as Oracle.

Preparing the database to be a SilverMaster

NOTE: If you are using the Express or Server Express option, the install automatically creates a MySQL database. Otherwise, you will have to create a database. If you are using the Custom option on Windows or Linux, a MySQL database can be created for you.

Preparing the database involves two operations:

Creating the database You need to create a database to use as your SilverMaster before installing the Application Server.

Setting up the database The Application Server must be able to connect to the database you want to use as SilverMaster (as well as any other databases you want it to access). The Application Server acts as a database client—so it requires any database client software, ODBC driver, JDBC driver, and any configuration necessary for an application connecting to a particular database.

The steps for setting up a database differ for the different database types (Oracle, and so on).

For more information For details on setting up your database type, see the appropriate chapter in the exteNd Application Server Database Configuration Guide.

For more information about the SilverMaster database and setting it up, see the exteNd Application Server Administrator's Guide (especially the chapter on data source configuration).

Using MySQL with exteNd 5

Default port number

MySQL is installed at port number 63306 when installed by the exteNd suite installer. This is to avoid conflicts with any other MySQL server running on the same machine.

MySQL and NetWare

MySQL and the exteNd Application Server are installed as part of the NetWare installation program. The exteNd 5 suite does not reinstall either the MySQL SilverMaster or the Application Server during the suite installs.

MySQL on Windows

Running the Express or Server Express option installs MySQL. If you have an existing installation of MySQL running as a service on Windows, your MySQL service will be overwritten and your existing my.ini file will be renamed my.ini.bak.

Using the Custom option and deselecting MySQL will avoid installing MySQL during the extend installation.

What gets installed

The following table lists the items that get installed or started during the installation.

If you should manually uninstall, you need to make sure these items are stopped and/or deleted.

Services and applications

Category

Applications

Registry Keys

Application Server

Novell exteNd Application Server 5.1

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdAppServer51

Novell exteNd Application Server Cache Manager 5.1

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdCachemgr51

Novell exteNd Application Server Dispatcher 5.1

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdDispatcher51

Novell exteNd Application Server Load Manager 5.1

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdLoadmgr51

Director services

exteNd Director DRE

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DirectorDRE

exteNd Director Cache Coordinator

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\CacheCoordinator

MySQL service

MySQL

My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\MySQL

Other

The Novell exteNd LDAP Utility program

—

Category	Applications	Registry Keys
Application Server	Novell exteNd Application Server 5.1	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdAppServer51
Novell exteNd Application Server Cache Manager 5.1	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdCachemgr51
Novell exteNd Application Server Dispatcher 5.1	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdDispatcher51
Novell exteNd Application Server Load Manager 5.1	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\exteNdLoadmgr51
Director services	exteNd Director DRE	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DirectorDRE
exteNd Director Cache Coordinator	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\CacheCoordinator
MySQL service	MySQL	My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\MySQL
Other	The Novell exteNd LDAP Utility program	—

Files

The installation program installs into the directory of your choice. Files will be placed at installation directory\exteNd5.

If you are doing a manual uninstall, there are some things you may want to preserve:

Any profiles, projects, and configuration files that are user-created and saved in various places
Any files under MySQL/data (they will be overwritten during an Express or Server Express install)

NOTE: If you had a previous version of MySQL installed, the exteNd install creates winnt\my.ini. Your original is saved as my.ini.bak.

Environment variables

NOVELL_EXTEND_APPSERVER_HOME

NOVELL_EXTEND_COMPOSER_HOME

NOVELL_EXTEND_DIRECTOR_DEV_HOME

NOVELL_EXTEND_DIRECTOR_HOME

NOVELL_EXTEND_HOME

NOVELL_EXTEND_WORKBENCH_HOME

AGCLASSPATH If you installed MySQL as part of the exteNd install, the install adds its driver to AGCLASSPATH—for example:

  C:\Program Files\Novell\exteNd5\MySQL\jdbc\mysql-connector-java-3.0.8-stable-bin.jar

Registry keys

exteNd Application Server

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\AppServer\5.0

exteNd Director^TM

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Director\5.0

exteNd Director tools

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Workbench\5.0

exteNd Application Server	My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\AppServer\5.0
exteNd Director^TM	My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Director\5.0
exteNd Director tools	My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Workbench\5.0

Path modifications

User path

C:\Program Files\Novell\exteNd5\Director\autonomy

System path

C:\Program Files\Novell\exteNd5\AppServer\bin;C:\Program Files\Novell\exteNd5\Director\autonomy

User path	C:\Program Files\Novell\exteNd5\Director\autonomy
System path	C:\Program Files\Novell\exteNd5\AppServer\bin;C:\Program Files\Novell\exteNd5\Director\autonomy

Start menu items

Novell exteNd 5.0 directory

UNIX/Linux-specific

When installing as root user on Linux, the installation edits the /etc/password and /etc/group files with entries required to start MySQL.

Contacting Technical Support

To learn about the online product support available to you, visit the Novell exteNd Application Server Web site (http://extend.novell.com/appserver).

If you contact the Novell exteNd support staff for assistance, you will be asked to provide information about your environment and your problem—as follows:

Information to provide about your environment

Category	Details
Product versions	Available from the About... help menu
Product type	The suite edition you are using
Operating system	The platform for your server
Database platform for SilverMaster	The DBMS you are using for your SilverMaster
Other databases	The DBMSs you are using for application deployment and application data, including versions
Database drivers	The types and versions of the database drivers you are using
Browser	The name and version number of the Web browser you are using
Java Virtual Machine version (JVM)	Displayed when you start the Application Server
Proxy servers and firewalls	Whether you are using a proxy server or firewall in your system configuration

Information to provide about your problem

Does the problem occur in the development environment or at runtime?
What was the specific action that caused the error?
What error message did you see?
Can the problem be recreated consistently?
What are the exact steps to recreate the error? Please be prepared to provide an example

Preparing to Install exteNd 5

About the installation program

Before you install

Preparing your computer

Making installation decisions

Choosing an installation option

Choosing a database for SilverMaster

Making a DBMS choice

Preparing the database to be a SilverMaster

Using MySQL with exteNd 5

Default port number

MySQL and NetWare

MySQL on Windows

What gets installed

Services and applications

Files

Environment variables

Registry keys exteNd Application Server My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\AppServer\5.0 exteNd DirectorTM My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Director\5.0 exteNd Director tools My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Workbench\5.0

Path modifications User path C:\Program Files\Novell\exteNd5\Director\autonomy System path C:\Program Files\Novell\exteNd5\AppServer\bin;C:\Program Files\Novell\exteNd5\Director\autonomy

Start menu items

UNIX/Linux-specific

Contacting Technical Support

Information to provide about your environment

Information to provide about your problem

Registry keys

exteNd Application Server

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\AppServer\5.0

exteNd Director^TM

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Director\5.0

exteNd Director tools

My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\exteNd\Workbench\5.0

Path modifications

User path

C:\Program Files\Novell\exteNd5\Director\autonomy

System path

C:\Program Files\Novell\exteNd5\AppServer\bin;C:\Program Files\Novell\exteNd5\Director\autonomy