The demo solution currently requires an instance of RHMAP. It can be a local or remote instance of RHMAP, but must be configured as outlined in the Raincatcher Getting Started Guide so that the local raincatcher-demo-cloud app can access RHMAP’s $fh.auth service
The raincatcher-demo-cloud app and raincatcher-demo-auth app requires a local running MongoDB instance. See the MongoDB Installation Guide for details on how to install MongoDB.
The raincatcher-demo-cloud app requires a local running instance of Redis. See the Redis Quick Start Guide for details on how to install Redis, or use your system’s package manager.
To use the Raincatcher CLI Tool, described later, you need to install Ruby. If the CLI tool is not required, you do not need to install Ruby.
The Raincatcher CLI Tool is a useful tool for getting set up with all of the Raincatcher modules and demo apps. Follow the steps in the README to clone, install, and link all of the Raincatcher modules.
In order to communicate with RHMAP and the local authentication service, several environment variables need to be configured. You can find the values in RHMAP → Projects → _Project name given in Getting Started Guide → WFM Demo Cloud App → Environment Variables → System Environment Variables.
These environment variables can be placed in the raincatcher-demo-cloud/Gruntfile.js
file in the Demo Cloud App.
{
...
env: {
local: {
FH_APPNAME: "<FH_APPNAME value>",
FH_DOMAIN: "<FH_DOMAIN value>",
FH_ENV: "<FH_ENV value>",
FH_INSTANCE: "<FH_INSTANCE value>",
FH_MBAAS_ENV_ACCESS_KEY: "<FH_MBAAS_ENV_ACCESS_KEY value>",
FH_MBAAS_HOST: "<FH_MBAAS_HOST value>",
FH_MBAAS_PROTOCOL: "<FH_MBAAS_PROTOCOL value>",
FH_WIDGET: "<FH_WIDGET value>",
FH_APP_API_KEY: "<FH_APP_API_KEY value>",
// This value can be found in `raincatcher-demo-cloud/Gruntfile.js`
// in the FH_SERVICE_MAP environment variable
WFM_AUTH_GUID: "iidn3tvprs62asdebat5m3eg"
}
}
...
}