Software Development Kit Windows Installation

Software Development Kit

The Software Development Kit (SDK) installation of Appistry EAF provides the libraries necessary to develop Java, .NET and 'C' fabric tasks and clients.

The Default Developer Installation The default Developer installation installs not only the SDK, but also the administrative utilities, and the fabric worker. This is the recommended minimal installation for working with the SDK. It is, however, not required that the fabric worker be on the same workstation where development is being performed. Optionally, you may opt out of installing the administrative utilities and/or the fabric worker. However, without the administrative utilities, you will probably not be able to do some of the things you will want to do during development (start/stop worker, logging, querying worker state, etc.). If you do not install the worker portion of the install and you are developing in .NET, you will currently need to install the Appistry assembly. Our fabric_gac utility can install the assembly.

Installing the Software Development Kit

1. Go to the directory storing Appistry EAF setup executable.
2. Double-click setup.exe.
3. 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.
     
     
     
     
     
     
4. Click I agree to the license agreement and continue with installation.
   
   
   
   
   
   
5. In the Install list, select the Developer installation. This includes the fabric worker, fabric utilities and SDK by default. If you deselect any of these options, the steps in these instructions may not match.
   
   
   
   
   
   
6. 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.

   
   
   

7. 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.

   
   
   

8. Click Yes to enable the fabric worker manager to automatically start when the worker reboots.
   
   
   
   
   
   
9. The installation is now complete. Click Finish.
   
   
   
   
   
   
10. Click Yes to reboot your system.
    
    
    
    

    If the pre-installed 5 worker license does not meet your development needs, you will want to deploy a new license key via the process at Deploy the license key. This key would need to be provided by Appistry.

Using the Software Development Kit

You will want to check the following directories for necessary header and jar files:

Java
Fabric/system/classes which contains the Java API (fabric.jar) for both task and clients.

C/C++
Fabric/include, which contains the headers that you will use when developing both clients and tasks.