Chapter 5: Deploying Files and Executing e-Biz Impact Clusters

Deploying cluster files

A cluster’s configuration, project, module, and application files must be located in the same directory as the e-Biz Impact server. This section describes how to copy a cluster’s configuration files to to the location from which you want the cluster to run.

Windows

When the e-Biz Impact server is installed on Windows, you create a true runtime directory on Windows and use the e-Biz Impact deploy utility to copy the cluster’s configuration files to that location (“Deploying cluster files”). Afterward, you use the instructions in “Moving application, module, and production object files” to copy the remaining cluster files to the runtime directory.

UNIX

When the e-Biz Impact server is installed on UNIX, you create a temporary deployment directory on Windows and use the e-Biz Impact deploy utility to copy the cluster’s configuration files to that location (see “Deploying cluster files”). Next you manually move the remaining cluster files to the same temporary directory. Afterward, you use the instructions in “Moving application, module, and production object files” to copy or FTP all of the cluster files from the temporary Windows directory to a permanent user-created runtime directory on UNIX where the e-Biz Impact server is installed.

Before you run the deploy utility, you must use the Configurator to generate a set of configuration files for a cluster. Cluster configuration files are generated by the Configurator when you save a cluster. See Chapter 2, “Configuring Clusters,” for instructions.

Deploying cluster configuration files

In the Windows File Explorer, verify that the cluster’s configuration files (.xml and .cfg) exist in the same default directory (x:\Sybase\ImpactClient-5_4\config) or the working directory that you specified when you saved the cluster.
Open the Windows File Explorer.
Create a directory to copy the cluster’s configuration files.

When the e-Biz Impact server is installed on Windows, this is the location from which you want to run the cluster. For example, you could create the directory called “Working\Config” on drive D—D:\Working\ or D:\Sybase\ImpactServer-5_4\Working.

When the e-Biz Impact server is installed on UNIX, this is a temporary Windows directory. For example, you could create the directory called “deploy” on drive D—C:\Deploy or D:\Sybase\ImpactClient-5_4\Deploy.
Close the Windows File Explorer.
Select Start | Run, enter cmd in the Open text box, then click OK to open a command window.
When the command window opens, go to the directory containing the cluster configuration files; for example:
```
cd x:\Sybase\ImpactClient-5_4\config
```
where “x” is the drive where the e-Biz Impact client is installed.
At the command line, enter:
```
ims deploy -cluster <cluster_name> -root <path>
```
and press Enter.

<cluster_name> is the name of the e-Biz Impact cluster for which you are deploying files, and <path> is the root directory path under which the deployment utility copies all files. This is the directory that you created in step 3.

WARNING! Do not enter the filename extension (.xml) for the cluster_name variable; that is, only enter the portion of the cluster configuration file name that precedes the file name’s .xml extension. This ensures that the deployment utility copies all configuration files for that cluster. If you include the filename extension, the deploy utility fails.
Close the command line window.

Example

The assumptions for this example are:

The example cluster is named “Cluster1.”
On Windows, the e-Biz Impact 5.4.5 server is installed in D:\Sybase\ImpactServer-5_4. On UNIX, the e-Biz Impact server is installed in /Working/ImpactServer-5_4/clusters/.
The cluster files have been saved to the default D:\Sybase\ImpactClient-5_4\config directory.

To deploy the example cluster’s configuration files, you:

Create the Windows runtime directory D:\Sybase\ImpactServer-5_4\Working\Config when the server is on Windows, or create the temporary directory /Working/ImpactServer-5_4/clusters/Cluster1/Config when the server is on UNIX.
Open a command window and go to D:\Sybase\ImpactClient-5_4\config.

At the command line, enter this command on one line:

e-Biz Impact server on Windows:

ims deploy -cluster Cluster1 -root D:\Sybase\
      ImpactServer-5_4\Working\Config

e-Biz Impact server on UNIX:

ims deploy -cluster Cluster1 -root D:\Sybase\Deploy\Config

All of the cluster’s configuration files (.cfg and .xml) are copied to the appropriate Windows directory.

Example

To deploy the example cluster configuration files, you would:

Create a Cluster1 subdirectory on the UNIX machine where the e-Biz Impact 5.4 server is installed; for example:
```
cd /Working/Sybase/ImpactServer-5_4/Clusters/
```
```
mkdir Cluster1
```
```
chmod a=rwx Cluster1
```
These commands create the Cluster1 directory, and grant read, write, and execute permission to the world on the Cluster1 directory.
In Windows, use FTP or NFS to copy the cluster files to the directory you created on the server machine: /working/Sybase/ImpactServer-5_4/clusters/Cluster1.

Moving application, module, and production object files

View this book as PDF