Using the Bluemix™ Configuration Wizard with XPages applications

The Bluemix™ Configuration Wizard is provided in Domino® Designer so that you can configure existing local XPages applications for deployment to Bluemix™.

This wizard is part of the functionality and tooling available in Domino® Designer to provide the infrastructure needed to modify, configure, and deploy XPages applications to and from Bluemix™. The Bluemix™ Configuration Wizard configures existing local XPages applications for deployment to Bluemix™.

To open the wizard select Design >IBM Bluemix >Configure For Deployment or use the dropdown menu associated with the Bluemix™ toolbar button. You can also right-click on an open application in the Applications Navigator and use the IBM Bluemix >Configure For Deployment popup menu.

Bluemix™ Configuration Wizard usage example

As mentioned, the Bluemix™ Configuration Wizard configures existing local XPages applications for deployment to Bluemix™. Before deploying your design NSF to Bluemix™, you must configure it using the Bluemix™ Configuration Wizard. This process associates your application with a directory in the local file system. This deployment directory is used to store the Bluemix™ settings for your application (found in the manifest.yml file) and during deployment a copy of your NSF is placed here before being pushed to Bluemix™.

The steps outlined next are provided as an example of how you would typically use this wizard.

  1. Make sure you have configured the Bluemix™ Server connection in the Domino Designer >IBM Bluemix preferences.
  2. Make sure that the application that you want to configure for deployment is open in Designer.
  3. Select Design >IBM Bluemix >Configure For Deployment from the menu or use the dropdown menu associated with the Bluemix™ toolbar button. You can also right-click on the open application in the Applications Navigator and use the IBM Bluemix >Configure For Deployment popup menu.
  4. On the first wizard panel, choose the deployment directory for the application. It is recommended to choose an empty directory. Click Next. The wizard connects you with the Bluemix™ server you have specified in your IBM® Bluemix™ preferences
  5. On the wizard Organization and Space panel, choose the Bluemix™ organization and space where this application will be deployed (see the Bluemix™ documentation for more information on organizations and spaces). Click Next. The wizard connects to the Cloud Space and the wizard Application Name panel is displayed.
  6. On the next wizard panel, specify a name and host for your application, or choose an existing application to overwrite.
  7. Click Finish to complete the configuration.