Fabric Worker
The worker installation installs the application fabric and administrative utilities on a single worker.
The installation steps described here are appropriate for manually installing:
- single worker fabrics (such as on a developer's workstation)
- small multi-worker fabrics being used for evaluation, development, testing, or small production environments
- a single worker as a preparation step for setting up for using the fabric assimulation features.
The Appistry EAF installation and basic configuration consists of the following procedures.
What about installing larger fabrics, and the fabric assimulation feature?
For information on automating the installation and configuration of fabric workers using the fabric assimulation feature, please refer to Worker Assimilation.
Prepare for installation
If installing fabric workers for production, test, or development fabrics
We assume the following:
- The fabric is segmented from the network by a firewall that restricts MCAST communication.
- The fabric is on a single network switch.
- The client and workers are on the same network segment.
- The operating system is already installed.
If installing fabric workers on developer workstations, or for an evaluation fabric
We assume the following:
- The client and workers are on the same network segment.
- The operating system is already installed.
 | Personal firewalls
Personal firewalls, such as Norton Internet Security and Zone Alarm, are known to interfere with fabric communication. Please disable all personal firewalls. |
If Java is installed on your system, and you intend to package, deploy, and run Java fabric tasks, verify the following
- The JAVA_HOME environment variable exists and is set correctly.
- For Java JRE
- System PATH includes %JAVA_HOME%\bin;%JAVA_HOME%\bin\client
- For Java JDK
- System PATH includes %JAVA_HOME%\jre\bin;%JAVA_HOME%\jre\bin\client
If correct .NET runtime libraries are not installed on your system, and you intend to use .NET fabric tasks
| None of the Appistry EAF components may be run from the CD itself.
You must install the worker components onto the worker hard drive. |
Install Appistry EAF on a worker
- Go to the directory storing Appistry EAF setup executable.
- Double-click setup.exe.
- If the .NET runtime library is not installed or you are not running the required .NET runtime library version, a dialog box appears stating the .NET components will not be registered. Your options at this point are:
- Click No to exit the installation process and install the .NET runtime library.
OR
- Click Yes to continue the installation process. You may install the .NET runtime library at a later time and register the Appistry EAF .NET components using the Appistry-provided utility.
- Click I agree to the license agreement and continue with installation.
- In the Install list, select the desired installation. You may select more than one installation type.
- Enter the fabric's MCAST address, then click Next.
| What about this fabric MCAST address?
Each fabric is assigned a unique MCAST address. Fabric clients and utilities (like Log Monitor and Fabric Control) use this MCAST address to communicate with the fabric. This address defaults to 239.255.0.1, but can be changed by setting the fabric-address property in the addr.cfg file that is deployed to all fabric workers. The fabric MCAST address specified by clients and utilities must match the fabric-address entry in the addr.cfg or 239.255.0.1 if using the default. As you go through command and code samples, please be sure to use the correct fabric MCAST address for your installation. |
- Click Next to accept the default installation directory or enter a different directory, then click Install.
| FABRIC_HOME
The installation directory that you select becomes the top of FABRIC_HOME, which is C:\Program Files\Fabric\system by default. |
- Click Yes to enable the fabric worker manager to automatically start when the worker reboots.
- The worker installation is now complete. Click Finish.
- Click Yes to reboot your system.
Deploying the license key
 | You must deploy the license key
The fabric will not run without a valid license key. You are required to deploy the license.cfg file. |
Before deploying the fabric application package, verify the following.
- The fabric is running. If the fabric is not running, refer to Installation for instructions.
- The Log Monitor is running in a separate window or terminal. To start the Log Monitor run the following command with the correct fabric MCAST address.
log_monitor 239.255.0.1:4000
| What about this fabric MCAST address?
Each fabric is assigned a unique MCAST address. Fabric clients and utilities (like Log Monitor and Fabric Control) use this MCAST address to communicate with the fabric. This address defaults to 239.255.0.1, but can be changed by setting the fabric-address property in the addr.cfg file that is deployed to all fabric workers. The fabric MCAST address specified by clients and utilities must match the fabric-address entry in the addr.cfg or 239.255.0.1 if using the default. As you go through command and code samples, please be sure to use the correct fabric MCAST address for your installation. |
Deploying the License Key
- The Log Monitor will be displaying errors like the following:
Sep 27 12:14:10 00:00:00:00:00:00 FabricKeeper[E:7104] License Key Error: failed to load license file
- Change to the directory holding license.cfg file you received from Appistry.
- To deploy the license.cfg file, run the following command with the correct fabric administrative user, password, and fabric address.
fabric_ctl -d 239.255.0.1:30000 -u fabric-admin/fabric-admin deploy license.cfg
- Fabric control sends the license key file to the worker, and the fabric services will begin to startup. The Log Monitor will display a message like the following:
Sep 27 12:26:00 00:00:00:00:00:00 FabricKeeper[I:7108] Spreading file: license.cfg
- After a few moments, the fabric will be fully started.
