Next topic

Planning for Everserve Installation

Before you install Everserve you need to plan for the community topology. This is important for correct installation and configuration of the systems running Everserve. You must determine which computer will manage the community, which one will publish packages to community targets, and whether or not relay systems will be needed. This tutorial will create the community manager and publisher peers required for a working community on the same computer. At least one other computer will be needed for installation of a target peer.

Another important consideration is the database software to use with Everserve. Each community manager, publisher, and relay in the community must have database software running prior to Everserve installation. Instructions for installing and configuring MySQL are part of this documentation.

Before you begin:

System Requirements

The minimum system requirements depend on the role in the community. Everserve supports running all roles on the following platforms:

Community Manager, Publisher, and Relay requirements

The internal structure of community managers, publishers, and relays is nearly identical, with each having the same system requirements. Each of these roles has the OpenJMS Server transport mechanism, and requires database software. Community manager and publisher systems also install Everserve's Web interface components (Tomcat Application Server). These systems should have:

Target requirements

Targets maintain their community data in a file. They do not require a database and cannot run the Web interface. Target systems should have:

Supported Databases

Everserve requires use of a database. If you have not made arrangements to use another database, you can install the MySQL database from the "Third Party Software" directory of the installation CD. Note that Everserve installation will create a database account with the name "everserve" and password "everserve" in order to initialize the tables and databases used during execution. Please refer to the System Administrator's guide for more information.

MySQL database setup

To Install MySQL you can follow the installation and setup instructions found in the "Third Party Software" folder of the Everserve installation CD. You can also use the web to get the install program and instructions. Below are links to the appropriate web pages and a short set of instructions for using the installatiton program from the Everserve CD.

Download:
http://www.mysql.com/downloads/mysql-3.23.html
Install instructions:
http://www.mysql.com/documentation/mysql/bychapter/manual_Installing.html#Windows_installation

Windows Systems

  1. Ensure you have sufficient disk space to install MySQL.
  2. Go to the MySQL directory on the Everserve CD and run setup.exe.
  3. Accept the default options. Install MySQL in the C:\mysql directory (default value). Installing MySQL in some other directory will require changes to default values found in Everserve installation.
  4. Following the reboot required by installation you must open the Services Panel to verify that MySQL is running before you begin installation of Everserve. If MySQL is not in the list of Services then change directories to C:\mysql\bin\ and execute the winmysqladmin.exe program. If this is a new installation you will be prompted to create a passphrase for the database administrator account. The MySql username and password must be set after MySQL installation in order to run the MySQL service.

Solaris Systems

All devices that will be used as a community manager, publisher, or relay must
have a database configured with Everserve. It is recommended that you review the MySQL install documentation before installing MySQL. The MySQL documentation can be found at the following Web site:

http://www.mysql.com

1. Go to the directory in which to install MySQL and verify there is sufficient
disk space (425 MB) for the MySQL installation (/usr/local
is used in this example). For example:

# cd /usr/local
# df -k .

2. Copy the two files listed below from the /Third Party Software/mysql directory
on the installation CD to the directory used for the MySQL install.

# cp "/cdrom/Everserve1.1c/Third Party Software/mysql/mysql-max-3.23.46-
sun-solaris2.x-sparc.tar.gz" .
# cp "/cdrom/Everserve1.1c/Third Party Software/mysql/gtar-sparc.gz" .

3. Execute the following commands:

# groupadd mysql
# useradd -g mysql mysql
# ./gtar-sparc.gz xvzf mysql-max-3.23.46-sun-solaris2.x-sparc.tar.gz
# ln -s mysql-max-3.23.46-sun-solaris2.x-sparc mysql
# cd mysql
# scripts/mysql_install_db
# chown -R root *
# chown -R mysql data/
# chgrp -R mysql *
# chown -R root bin/
# cp -f support-files/my-medium.cnf /etc/my.cnf
# bin/safe_mysqld --user=mysql &

5. Verify the MySQL process is running by issuing the command "ps" and
examining the results for an indication MySQL is up. For example:

# ps

PID TTY TIME CMD
27158 pts/1 0:00 ksh
27311 pts/1 0:00 ps
27162 pts/1 0:00 bash
27287 pts/1 0:00 safe_mys

Now you are ready to install Everserve and configure a community manager.