Skip to the content.

Subscribing to Your Application

Introduction

Deploying an application into MSX is the first step in making it available. A tenant cannot subscribe to the application until it has been published, and an offer created. In this guide we walk through the steps in the Cisco MSX Portal to achieve these goals. Note that if you see an unexpected behaviour you may have to hit refresh on the browser.

Goals

Prerequisites

Publishing the Application

Open the Cisco MSX Portal and navigate to “Settings->Component Manager”, then click on the ellipsis and select “Publish Application”.


Fill in the “Label” field and click “Save”. The “Advanced Settings” are not covered in the document.


Follow the prompts until the application is published, and you see the success screen.


Creating an Offer

Next we need to create an offer that sets details like price and the terms and conditions. Click the ellipsis on the application this time (instead of the component), and select “Offers”.

GOTCHA

To create offers your user must have role SUPERUSER or ADMIN.


As this is a new application there are no offers yet.


Click “Create Offer” and fill in the mandatory fields, then click “Save”.


The offer will be created and appear in the list. You can create as many offers as you want. Offers can also be restricted by Tenant, but that process is not covered here.


Subscribing to the Application

To subscribe to the application choose a tenant, click on “Offer Catalog”, and select “My React Demo”.


Follow the prompts until the success dialog is shown.


Using the Application

Once you have successfully subscribed to the application it will appear in the dashboard for that tenant.


The application does implement SSO but for demonstration purposes we do not start the flow until the “Sign In” button is pressed. Go ahead and press the that button, as you are already signed in you will not be prompted to do so again. Instead, the application will show the current user information.


To demonstrate the MS SDK client click on the “Tenants” in the application title bar. That will request a page of tenants from MSX and show the response. As an exercise you could display that result in a table, rather than our blunt JSON dump.


Let us take a moment to step back and acknowledge what we have achieved. We have written an MSX user interface, packaged it, onboarded it, deployed it, published it, offered it, subscribed to it, and used it.

Unsubscribing from the Application

You cannot remove a component that has subscriptions. To unsubscribe from an application click on the cross in the top right-hand corner of the application.


The application will no longer be visible in the dashboard once the process has completed.


PREVIOUS HOME