Deploying a Configuration

Navigation:  Managing the Account > Applications > Configurations >

Deploying a Configuration

Previous pageReturn to chapter overviewNext page

 

Overview

 

The ultimate target of a Configuration is always a Device Group. Instead of creating a deployment in the "Deployments" sub-module and choosing a configuration, you can assign a specific configuration to a device group in the "Configurations" page, meaning, create a deployment for the selected configuration.

 

Step-by-step

 

1. In the Admin Dashboard's "Control Panel", click Applications button , and, in the resulting row, select Configurations Sub Module Button .

 

Account Configurations0

 

2. Select the configuration to be assigned to a device group by clicking the corresponding Check box.

 

3. Click Add Deployment Header Button2 . This opens a New Deployment wizard.

 

If an error message appears, check Possible Error Message(s) to know how to proceed.

 

Assign to Group New Deployment Plan Page_Account

 

4. Fill in the available options (the fields marked with an asterisk are mandatory):

 

Note

The configuration being deployed and the device group must be compatible. In this context (assigning a configuration to a device group), the "Configuration to Deploy" option is already filled in. Therefore, only device groups compatible with that configuration will be available in the "Target" tab.

 

Plan Name *

Enter a name for the new deployment (minimum of 4 characters).

 

TIP

We recommend you avoid special characters and consider the related best practices when you define a deployment plan's name:

Use alphabetic/numeric characters (a-z; A-Z; 0-9);

Underscore and/or dash characters are allowed;

Always start the entity's name with an alphabetic character.

Configuration to Deploy *

This field displays the previously selected configuration's name and version. It is possible to change the configuration. To do so, click the corresponding Select Configuration button. See Details on the "Select a Configuration" window below.

Name

Refers the selected configuration's name. NOT Editable.

Version

Refers the selected configuration's version. NOT Editable.

Size

Refers the selected configuration's size. NOT Editable.

Qualification

Refers the selected configuration's qualification. NOT Editable.

Device Model

Displays the configuration's target device: manufacturer, device model and Operating System. NOT Editable.

Description

Provides the notes of the previously selected configuration, if there are any. NOT Editable.

 

hmtoggle_plus1Click Here for Details on the "Select a Configuration" window

 

5. Click Button_Next to continue.

 

Assign to Group New Deployment Plan Page_Account1

 

To return to the step 1 (Properties tab) wizard page, click Button_Previous or Wizard Step 1 icon.

 

TIPMouse over the Info Icon to see details on the configuration being deployed.

 

Deployment info_Account1

 

 

6. Fill in the available options (all fields are mandatory/must have information:

 

Target *

Qualification(s)

If available, select the qualification of the targeted site from the drop-down list.

If the configuration being deployed is restricted to a site, this option will NOT be editable - it will display the qualification of the site the configuration is restricted to.

 

Deployment Target

 

Site(s)

If available, select the compatible target site(s) for the deployment from the drop-down list or click Site Button. See Details on the "Select Sites" Window below.

 

If the configuration being deployed is restricted to a site, this option will NOT be editable - it will display the name of the site the configuration is restricted to.

Deployment Targeta

Device Group(s)

Select the target device group(s) for the deployment from the drop-down list or click Dev Group Button . See Detail on the "Select a Device Group" Window below.

Device Model

Automatically filled in - it displays the target device model of the selected configuration. Not editable.

 

Detail of Single site selection windowClick Here for Details on the "Select Sites" window

 

Detail of a Select a Device Group windowClick Here for Details on the "Select a Device Group" window

 

7. Click Button_Next to continue.

 

Assign to Group New Deployment Plan Page_Account2

 

To return to the step 2 (Target tab) wizard page, click Button_Previous or Wizard Step 2 icon.

 

8. Fill in the available options:

 

Deployment Mode *

Select the deployment mode from the drop-down list. There are two available:

Incremental: Only components present in the deployed configuration, that are not present on the device, will be implemented.

Full install: Deletes all the applications/firmwares and forces the installation of the components present in the deployed configuration.

Planning Date *

Check the most appropriate scheduling for the deployment:

As soon as possible: the deployment will happen as soon as the device contacts the account and the deployment criteria are met.

Date: Click Date button to display a calendar where you can define the day and hour of the deployment. See Scheduling a Deployment.

Deployment profile *

Select the deployment profile to be used from the drop-down.

Use the Profile Management Button button to access the selected profile's details page. If <Default> is selected, it will open the "Profile Management" page. See Deployment Profile Details .

Use the Button_Refresh button to refresh the current profile list.

Description box

Not Editable - it provides deployment related information.

 

9. Click Button_Save.

To return to the step 2 (Target tab) wizard page, click Button_Previous or Wizard Step 2 icon.

To cancel the wizard, click Button_Cancel .

 

If an error message appears, check Possible Error Message(s) below to know how to proceed.

 

A summary window is displayed with the deployment's details.

 

Assign to Group New Deployment Plan Page_Account3

 

10. If all checks out, click Confirm button1.

The new deployment will be displayed in the "Deployment Plans" page.

 

TIPMouse over the Info Icon to see details on the configuration being deployed.

 

Assign to Group New Deployment Plan Page_Account4

 

 

 

 

Possible Error Message(s)

Deployment plan error message

 

Occurrence: When clicking Assign to Group Header Button.

Cause: No configuration selected.

Action: Check the Check box of the intended configuration and, then, click Assign to Group Header Button.

 

Deployment plan error message1

 

Occurrence: When clicking Confirm button.

Cause: Deployment name is less than 4 characters long.

Action: Enter a deployment name with 4 or more characters and, then, click Confirm button.

 

 

Deployment plan error message2

 

Occurrence: When clicking Confirm button.

Cause: No deployment name defined.

Action: Enter a deployment name (minimum of 4 characters) and, then, click Confirm button.

 

Deployment plan error message4

 

Occurrence: When clicking Assign to Group Header Button.

Cause: More than one configuration selected.

Action: Check only the Check box of the intended configuration and, then, click Assign to Group Header Button.