Troubleshooting the Deployment Framework

This page describes the basic checks you should perform when troubleshooting the Deployment Framework.

Basic checks

To check that the basic Deployment Framework containing Liberator and Transformer has been installed correctly:

  1. Run the dfw versions command to check that expected components are deployed and expected blades are active:

    $ ./dfw versions
    
      Deployment Framework                     7.1.1-313146
    
      Core components                          Version
      ---------------------------------------------------------------------
      Liberator                                7.1.9-313149
    
      Deployed blades                          Version            State
      ---------------------------------------------------------------------
      BlotterExport                            7.1.9-313149       Inactive
      CfgPermissioning                         7.1.9-313149       Inactive
      DemoDataSourceLatency                    7.1.9-313149       Inactive
      DirectConnection                         7.1.9-313149       Active
      DirectSSLConnection                      7.1.9-313149       Inactive
      HTTP                                     7.1.9-313149       Active
      HTTPS                                    7.1.9-313149       Inactive
      JavaOpenPermissioning                    7.1.9-313149       Inactive
      LiberatorDemoDataSource                  7.1.9-313149       Inactive
      LiberatorJMX                             7.1.9-313149       Inactive
      LiberatorWebsite                         7.1.9-313149       Active
      MinimalLiberatorWebsite                  7.1.9-313149       Inactive
      OpenPermissioning                        7.1.9-313149       Active
      ServerIdentification                     7.1.9-313149       Active
      TokenPermissioning                       7.1.9-313149       Inactive
      XMLPermissioning                         7.1.9-313149       Inactive
  2. Run the dfw start command to start components on the host:

    $ ./dfw start
    
      Blades ok
    
      Starting Liberator:
    rttpd: License will expire on Wed Apr  1 01:00:00 2020
  3. Run the dfw status command to see which components are running on the host:

    $ ./dfw status
    
      Core components                Status             Process ID
      -------------------------------------------------------------
      Liberator                      Running            32649
    
      Deployed Adapter blades        Status             Process ID
      -------------------------------------------------------------
  4. If Liberator is running on the host, open a web browser and navigate to the Liberator status web page.

    The Liberator status web page requires the following feature blades to be active: HTTP (or HTTPS) and LiberatorWebsite (see Installing Liberator). To check which port Liberator’s HTTP or HTTPS interface is running on, run the dfw info command.

    Use the status page to check that Transformer and other DataSource peers of Liberator are active and connected.

    Liberator status page extract showing Transformer UP (green) status

Blade checks

Once the basic Deployment Framework is up and running, deploy your required blades. The best way to check that a particular blade is correctly deployed and configured is to start the Caplin Platform Deployment Framework and verify that the feature the blade provides is available.

If your Adapter blade doesn’t appear to be running, or can’t be seen by the Transformer or Liberator:

If you have problems with the basic installation, or with any blades supplied by Caplin Systems, contact Caplin Support.