Installing and administering the MDM and Cloudant sample service
The MDM and Cloudant® sample service (MCS) is a mid-tier service that provides a web interface through which clients access the MDM data that is cached in Cloudant. MDM and Cloudant sample service is deployed as a service either locally or on IBM® Bluemix™.
The MDM and Cloudant sample service is built, deployed, and used in both local and IBM Bluemix environments. Differences between the environments are described where applicable in the configuration topics.
The service operates in two modes
whose properties are controlled by configuration files that are in
the top-level com.ibm.mdm.integration.cloudant/distribution/node.zip directory.
- Local environment: This mode is controlled by settings in the config_local.json file. If installed locally, the service must be on a server that is internet-accessible.
- Bluemix environment: This mode is controlled by settings in the config_bluemix.json file.
The only dependencies for using the MDM and Cloudant sample service are the following.
Installation of these items is done when you install the service.
- Express - is a web-server framework that is written for server-side JavaScript applications, specifically Node.js. The required dependencies are listed in the package.json file that is provided in the MDM and Cloudant integration sample.
- npm packages - npm is a package manager for Node.js applications and is provided with Node.js. The required packages are listed in the package.json file that is provided in the MDM and Cloudant integration sample. The npm installation reads the package.json and installs the dependencies in the node_modules directory.
Use the tasks below to install and manage your MDM and Cloudant sample service, and to administer user account permissions for the Cloudant database.
- Installing MDM and Cloudant sample service in a local environment
Use this procedure to install the service in a local environment. The MDM and Cloudant sample service provides the web interface through which clients access their cached on-premises MDM data. - Installing MDM and Cloudant sample service in an IBM Bluemix environment
Use this procedure to install the service in a Bluemix environment. The MDM and Cloudant sample service provides the web interface through which clients access their cached on-premises MDM data. - Accessing the MDM and Cloudant sample service
Use this procedure to access the service. - Starting the MDM and Cloudant sample service
Use this procedure to start your service. - Authentication
Authentication must take place between the MDM and Cloudant sample service and Cloudant, and between clients and the MDM and Cloudant sample service.
