Installing Magic xpa for UNIX Platforms (Magic xpa 3.x)
-
During the installation, several user-environment files are overwritten. Therefore it is best to back up the following files before starting the installation process:
.cshrc, .profile, .bash_profile (applies to Linux only)
-
If you already have a previous Magic xpa server version installed, it is best to install the product using a different user name.
-
Create a new user. (The installation should be performed using a non-root user.)
-
Log in as the new user.
-
Uncompress the installation file (magicxpa_<version>.<platform>.tar.gz) using the local uncompress utility or a compatible utility, such as gunzip).
-
Run the command from $HOME directory: tar xvf <installation file>.
The installation file name is magicxpa_<version>.<platform>.tar.gz.
-
Run the ./magicxpainstall command and enter the requested information.
-
When choosing to use GigaSpaces as the messaging infrastructure, the installation procedure will update the relevant configuration files accordingly in the GigaSpaces and GigaSpaces-xpa directories.
Note: On UNIX systems, the Tomcat server is used to host the HTTP requester. Follow the Windows installation explanation regarding those products with one difference – the scripts used have the .sh and not the .bat suffix.
-
When choosing the broker as the messaging infrastructure, run the $HOME/sbin/mgroot.sh file as a root user after the installation has been successfully completed. This script copies Magic xpa files that should be accessed by your Web server and follow the steps for the Apache Web server configuration.
-
To set up an Apache Web server, append the $HOME/web_utils/magic.conf file to the Apache configuration file (httpd.conf), place the requester in the modules directory and restart the Apache Web server (see also: Apache Requester Installation and Configuration).
-
Log out from the new user and log in again to enable the new environment settings.
-
If you need to uninstall the product, delete the user home directory created for the installation. For a complete removal, delete the files copied by the $MAGIC_HOME/sbin/mgroot.sh script and remove the changes that were applied to the Web server.
It is necessary to define for Magic xpa that a specific gateway must be loaded by pointing to a variable that contains a DB number. The DB number points to a specific executable that is the relevant gateway.
In UNIX operating systems an environment variable points to the executable, which should be used for a specific gateway located at $HOME/etc/mgenv.
For example, in UNIX: MAGIC_ DB_ 14_ DRIVER=$ MAGIC_ HOME/ bin/ mgoracle10
where the number 14 refers to the DB number.
|
Note:
|
-
If the installation fails, it is best to delete all files in $MAGIC_HOME and start a new installation from the beginning.
-
A remarked entry named MGLOCAL, which points to the Korean support library mglocal.kor, exists in the $HOME/etc/mgenv file. This file is required for proper functioning of browser-based applications when using Korean/Hangul characters.
|
Installation Components - UNIX Platforms
