Package a custom blade

Before you can deploy a newly developed custom blade to a Deployment Framework on a production system, it has to be packaged into a kit. Here's how to do this.

These instructions apply to all blades, except Java-based Adapter blades that have been produced using the Caplin Integration Suite toolkit. For how to package Java-based Adapter blades, see How Can I...  Export my blade as a kit in the CIS Toolkit pages.
  • The files for the blade must be located in the Deployment Framework directory structure under <Framework-root>/kits/<blade_name> /<blade-name>
  • Make sure that all the files required for the blade are present and are in the correct directory structure. For more information about the directory structure and files required for the type of blade you're creating, refer to the relevant page via one of the links in How can I... Create a custom blade.
  • Delete any files that are in the blade's DataSource/var directory
    (<Framework-root>/kits/<blade_name>/<blade-name>/DataSource/var)
  • Name the blade kit
  • Create the blade kit on Windows
    or
  • Create the blade kit on Linux
     

Naming the blade kit

Give your blade kit a name of this form:
<blade_name>-<version_number>

For example, if your blade is called MyAdapterBlade, and the version of the blade that you want to package is 000017, the full kit name would be MyAdapterBlade-000017
 

Creating the blade kit on Windows

To create a new blade kit on Windows:

  1. In Cygwin, navigate to the directory <Framework-root>/kits/<blade-name>
  2. Run this zip command:
    zip –qyr <kit-name>.zip <blade_name>

    For example:
    zip –qyr MyAdapterBlade-000017.zip MyAdapterBlade
     
  3. Move the newly created .zip file out of the kits directory, so it doesn't inadvertently get deployed when you next run .dfw /deploy or deleted when you run ./dfw delete

Creating the blade kit on Linux

To create a new blade kit on Linux:

  1. Navigate to the directory <Framework-root>/kits/<blade-name>
  2. Run these tar commands in order:
    tar cf <kit-name>.tar <blade_name>
    gzip <kit-name>.tar

    For example:
    tar cf MyAdapterBlade-000017.tar MyAdapterBlade
    gzip MyAdapterBlade-000017.tar

     
  3. Move the newly created .tar.gz file out of the kits directory, so it doesn't inadvertently get deployed when you next run .dfw /deploy or deleted when you run ./dfw delete

Deploying the new blade

Once you've packaged the new blade, you'll want to deploy it on your production, pre-production, or test system - see How can I... Deploy a custom blade.