Downloading and installing the plug-in package for Flocker

To enable provisioning of storage volumes from an external IBM storage to Docker containers, you must first download the IBM Storage Plug-in for Flocker from Spectrum Control Base and install it on a Flocker node.

Before you begin

Verify that:
  • Flocker container manager has been installed on all relevant nodes.
  • At least one storage service has been to the Flocker interface.
  • Storage connectivity (iSCSI or FC) and multipathing have been configured for all Flocker nodes.

About this task

The following procedure details how to download, install, and properly configure the IBM® Storage Plug-in for Flocker.

Procedure

  1. On the Interfaces pane, right-click the Flocker interface, and then select Modify. The Flocker Settings dialog box is displayed.
  2. On the bottom of the dialog box, click Download plug-in package and download it to every Flocker node.
    Figure 1. Download plug-in package button
    This image shows the Download plug-in package button.
  3. Install the Flocker plug-in as follows: 
    tar xvf flocker-driver-1.0.0-*-beta.tar.gz
cd flocker-driver
sudo /opt/flocker/bin/pip install
  4. Create and edit the agent.yml file in /etc/flocker directory according to your environment: 
    version: 1
control-service:
   hostname: "hostname or IP address of the Flocker control node"
dataset:
  backend: "ibm_storage_flocker_driver"
  management_ip: "hostname or IP of IBM Spectrum Control Base Edition server"
  management_port: "Optional (default port is 8440)"
  verify_ssl_certificate: "True verifies SCB SSL certificate or False ignores the certificate (default is True)"
  username: "user name defined for SCBE Flocker interface"
  password: "password defined for SCBE Flocker interface"
  default_service: "SCBE storage service to be used by default as the Flocker default profile"
  5. Verify the plug-in installation by changing the configuration file, as described below (use the values according to your requirements) and running the sudo /opt/flocker/bin/trial test_ibm_storage_flocker_driver command. 
    export IBM_STORAGE_CONFIG_FILE=/etc/flocker/ibm.yml

vi $IBM_STORAGE_CONFIG_FILE
ibm:
  management_ip: "SCBE IP"
  management_port: "SCBE PORT"
  verify_ssl_certificate: True
  username: "USERNAME"
  password: "PASSWORD"
  default_service: "SERVICE"
    Make sure that all tests succeed and no error messages are generated.