Scenario: installing and updating a MARS app at a customer

This scenario includes the context and approach for installing and updating a MARS app that you have created for a customer.

Context

Rick, a support engineer at Future Software has assigned the co-ownership of his MARS app approvalportalwhl to one of his customers, Wernham Hogg Labels (see Assigning co-ownership of a MARS app to a customer). The MARS app contains some approval workflows and a customized HTML page for Wernham Hogg Labels. In combination with a customized HTML page, the workflows can be used as a portal.

Since Rick has assigned the co-ownership of the MARS app to Wernham Hogg Labels, it is in their list of MARS apps. Consequently, when Rick is at the customer, he can easily install the MARS app.

Approach

Rick takes the following steps:
  1. He logs in to CLOUDFLOW with the credentials of Wernham Hogg Labels.
  2. He opens MARS > My Apps > Available. This list gives an overview of all the MARS apps of Wernham Hogg Labels that are available on their personal space on MARS.
  3. Next to the MARS app approvalportalwhl, he selects Install.
The MARS app and all its assets and workflows are now installed on the local CLOUDFLOW system at Wernham Hogg Labels and can be used.

A few weeks later, Rick is back at Wernham Hogg Labels to make some changes in the MARS app and to upload a new version of the MARS app, containing the changes.

He takes the following steps:
  1. He logs in to CLOUDFLOW with the credentials of Wernham Hogg Labels.
  2. He opens MARS > My Apps > Installed. This list gives an overview of all the MARS apps of Wernham Hogg Labels that are installed on their local system.
  3. In MARS > My Apps > Installed, he selects Edit next to the MARS app approvalportalwhl.
  4. He changes the version number of the MARS app. He fixed some bugs in the approval workflows and the MARS app stays backwards compatible, so he increments the Patch number from 0.0.1 to 0.0.2.
  5. He selects Save. As a consequence, the version of the MARS app approvalportalwhl in MARS > My Apps > Installed and the version of the same MARS app in MARS > My Apps > Available is different. So it is very important that Rick uploads the MARS app to MARS in order not to lose the bug fixes in the workflows.
  6. In MARS > My Apps > Installed, he selects Upload to MARS next to the MARS app approvalportalwhl.

approvalportalwhl is now uploaded to Wernham Hogg Labels' personal space on MARS.