Alternatively, you can download an Open Source edition of the ActiveGrid Server that includes MySQL. Commercial features of the ActiveGrid Server (Role-based access control and web services caching, for example) are not included with this installation (
“The Open Source Edition of the ActiveGrid Server” on page 49). To use the commercial version of the ActiveGrid Server with MySQL, install the commercial version of the ActiveGrid Server and use your own MySQL installation (
MySQL Server).
Note: The DB2 Express-C bundle edition of the ActiveGrid Server installation includes a silent install of DB2 Express-C using parameters that you submit in the ActiveGrid Server install wizard. This DB2 Express-C instance listens on TCP port 50000. The DB2 Express-C install is located in
/opt/IBM/db2/V8.1.
To execute the DB2 Express-C edition of the ActiveGrid Server installer, you must be logged in as root. You can install the standard edition of the Server as any user. The install wizard prompts you to enter the following configuration information:
•
|
Installation Directory: The installer puts all the files and sub-directories for the ActiveGrid Server in the directory you specify.
|
•
|
Hostname: The hostname for the server. The default value is localhost, which is sufficient for a single-node server. If you plan to use a cluster of servers, then use the same hostname that the other servers in the cluster use to identify this server.
|
•
|
Port Number: The port number for the ActiveGrid Server. If you’re installing as root, you can use any port number. If you installing as a non-root user, use a port number greater than 1024.
|
•
|
Linux user accounts (for DB2 Express-C edition only): The DB2 Express-C installation is included in the ActiveGrid Server installation. This database installation requires you to create the following two Linux user accounts, along with home directories and passwords for the accounts:
|
If possible, keep the defaults for the user account names and home directories. Note that the fenced user and instance user are the same (for more information on these user accounts, see
About the Accounts Created for the DB2 Installation).
The installation process creates a log in the /tmp/bitrock/installer.log file. If you have any problems with your installation, check the installation log for errors.
During server installation, you might be prompted for additional installation information for the DB2 Express-C installation. For additional details about the DB2 Express-C installation, refer to the documentation on the IBM web site:
The installer automatically launches the DB2 Express-C Server on completion. You still need to start the ActiveGrid Server by running the start script:
You can install the ActiveGrid Server in silent mode, which is useful for batch installations of the server on multiple machines. The command is different depending on whether you’re installing the DB2 Express-C bundle edition of the ActiveGrid Server:
•
|
X.X is the version of the ActiveGrid Server that you’re installing.
|
•
|
INSTALL_DIR is the directory in which want to install the server.
|
•
|
SERVER_PORT is the main port the ActiveGrid Server listens on. If you leave out the SERVER_PORT argument, the installer uses the default ( 8080).
|
•
|
HOSTNAME is the hostname that the server listens on. If you leave out the HOSTNAME argument, the installer uses the default ( localhost), which is fine for a single-node server configuration. However, if you are using the distributed session management mode, you must set HOSTNAME to the DNS-resolvable name of the machine. This enables the other members of the cluster to reference the machine.
|
•
|
X.X is the version of the ActiveGrid Server that you’re installing.
|
•
|
INSTALL_DIR is the directory in which want to install the server.
|
•
|
SERVER_PORT is the main port the ActiveGrid Server listens on. If you leave out the SERVER_PORT argument, the installer uses the default ( 8080).
|
•
|
HOSTNAME is the hostname that the server listens on. If you leave out the HOSTNAME argument, the installer uses the default ( localhost), which is fine for a single-node server configuration. However, if you are using the distributed session management mode, you must set HOSTNAME to the DNS-resolvable name of the machine. This enables the other members of the cluster to reference the machine.
|
To uninstall the ActiveGrid Server, run the uninstall script, located in the installation directory (INSTALL_DIR). This script uninstalls the ActiveGrid Server, but does not uninstall DB2 Express-C.
•
|
INSTALL_DIR: The INSTALL_DIR directory contains the uninstall script, the Start.desktop and Stop.desktop shortcuts (which are mapped to desktop icons) and five sub-directories: 3rdparty, bin, local, lib, and html.
|
•
|
3rdparty: The 3rdparty directory contains the third-party software required by the ActiveGrid Server ( Third-Party Components). The 3rdparty directory is organized into the following sub-directories:
|
•
|
apache2: Apache binaries. The configuration files in this directory tree are not used.
|
•
|
python: Python binary and libraries.
|
•
|
php: PHP binary and libraries.
|
•
|
common: common libraries, mainly used for building stack components.
|
•
|
sqlite: Contains the sqlite application and associated libraries.
|
•
|
bin: The bin directory contains the scripts for starting and stopping the ActiveGrid Server (activegridctl) and for deploying applications (activegrid_deploy).
|
•
|
local: The local directory contains the files for a single server instance.
|
•
|
conf: configuration files for the server instance. Includes php.ini file.
|
•
|
logs: server log files (for example, Apache logs, mysql logs).
|
•
|
lib: The lib directory contains the ActiveGrid product code.
|
•
|
html: The html directory contains the ActiveGrid documentation.
|
This section contains some information about the DB2 installation that is bundled with the ActiveGrid Server (DB2 Express-C bundle). For complete information on DB2, refer to the DB2 documentation from IBM:
The commercial edition of the ActiveGrid Server includes DB2 Express-C. In order to reduce the size of the overall download, only the minimum feature set required for testing and development is included in this bundled edition of DB2 Express-C.
If you need a DB2 feature that is not included in the ActiveGrid Server installation, download the full version of DB2 or DB2 Express-C directly from the IBM web site.
The DB2 installation requires an account for the instance owner and an account for the adminstration server user. You are prompted for some information about these accounts when you run the ActiveGrid Server installer. This section provides a little more information about these accounts, and about the fenced user account, which for your ActiveGrid installation is the same as the instance owner account:
For information on uninstalling DB2 Express-C, consult the DB2 Express-C documentation. The installation image that the ActiveGrid installer uses to install DB2 Express-C is located in
INSTALL_DIR/3rdparty/db2installer. As part of the DB2 Express-C uninstall process, you might need to run the
db2_deinstall script located in that directory.
The ActiveGrid Server installation includes some third-party software components that the ActiveGrid Server requires for operation. These third-party components do not interfere or interact with the system binaries (such as
/usr/bin/python and
/usr/sbin/httpd).
The installer puts these Python extensions in the site-packages subdirectory of your Python installation.
To see these demos, use the URLs in the following table. These URLs are based on the default hostname and port number (localhost:8080). If you did not use the defaults, substitute the hostname and port number for your own ActiveGrid Server installation.
The commercial edition of the ActiveGrid Server includes DB2 Express-C. The ActiveGrid Server supports a number of other databases, which you can configure and use instead of, or in addition to the DB2 Express-C database. This section explains how to set up these databases to work with ActiveGrid.
In the Python version, support for MySQL Server is automatically enabled. To enable PHP support for MySQL, add the following line to the
php.ini file:
The php.ini file is located in the
INSTALL_DIR\local\conf directory.
The ActiveGrid Server supports the cx_Oracle Python extension module. The specific driver you use depends on the version of Oracle you’re using. By default, the 10g version of
cx_Oracle is enabled. The 10g
cx_Oracle version also works with Oracle 9i. To use Oracle 8i, follow these steps:
The php.ini file is located in the
INSTALL_DIR/local/conf directory.
The database driver for PostgreSQL (PyGreSQL 3.6.2) is installed with the ActiveGrid Server. This Python library allows the ActiveGrid Server to communicate with a PostgreSQL database. You must install the database itself and also the native client libraries needed to communicate with PostgreSQL.
The php.ini file is located in the
INSTALL_DIR/local/conf directory.
ActiveGrid uses the pymssql (0.7.3 or higher) python module to connect to MS SQL Server. This module is not bundled with the ActiveGrid Server. Download it from the following site:
On Linux systems, pymssql uses FreeTDS (0.6 or higher) as communication layer. FreeTDS is not bundled with ActiveGrid. Download it from the following site:
#"Connection String" when you configure
# the data source in the ActiveGrid IDE.
This pre-initializes all deployed applications and then starts the ActiveGrid Server. By default, applications are not preinitialized, so when the server first starts up, each application may behave a little slower. The
–init option slows the server startup time, but improves initial application performance.
The ActiveGrid Server supports SSL requests through the mod_ssl Apache module. Much of this setup is specific to Apache
mod_ssl. For clarification on these steps, refer to the
mod_ssl documentation.
where server.crt and
server.key are the self-signed certificate and the private key respectively.
The ActiveGrid Server includes all packages that it needs in order to run. ActiveGrid recommends using the packages that are included in the ActiveGrid Server installation. If you do need to use external packages (for example, an external Apache Server), follow the guidelines in this section.
1.
|
Include INSTALL_DIR/local/conf/activegrid.conf.
|
3.
|
Add the required PythonInterpreter directive pointing to the correct Python executable.
|
4.
|
Set the ServerName parameter to the local hostname followed by the port. The ActiveGrid Server requires this setting for proper operation.
|
Because a server upgrade wipes out the entire contents of the installation directory, including
local/, you should make a copy of the
local/ directory before you upgrade.
5.
|
Remove the local/ directory in the new installation and replace it with your copy of the old local/ directory.
|