Configure DRE with the CLI to install the container package, configure a virtual port group, map and start the service, assign a profile when supported, activate the application, and uninstall the service if required.
This task demonstrates how to manage the DRE service using CLI examples, including installation, virtual port group configuration and mapping, profile assignment, activation, and uninstallation.
The examples use device configuration and application hosting commands to deploy DRE, assign profiles when available, and control the service lifecycle for applications such as Bangalore.
Before you begin
Follow these steps to configure DRE with the CLI:
Procedure
-
Install the DRE container package.
Example:
app-hosting install appid < name > package bootflash:<name>.tar
-
Configure a virtual port group, map it to the DRE service, and start the DRE service.
Example:
Device(config)# interface VirtualPortGroup 0
Device(config-if)# no shutdown
Device(config-if)# ip address 192.0.2.1 255.255.255.252
Device(config-if)# app-hosting appid dre
Device(config-app-hosting)# app-vnic gateway0 virtualportgroup 0 guest-interface 1
Device(config-app-hosting-gateway)# guest-ipaddress 192.0.2.2 netmask 255.255.255.252
Device(config-app-hosting-gateway)# start
-
Configure a virtual port group, map it to the DRE service, and assign a DRE profile.
Example:
Device(config)# interface VirtualPortGroup 0
Device(config-if)# no shutdown
Device(config-if)# ip address 192.0.2.1 255.255.255.252
Device(config-if)# app-hosting appid dre
Device(config-app-hosting)# app-resource profile-package small
Device(config-app-hosting)# app-vnic gateway0 virtualportgroup 0 guest-interface 1
Device(config-app-hosting-gateway)# guest-ipaddress 192.0.2.2 netmask 255.255.255.252
Device(config-app-hosting-gateway)# start
Note
The DRE Profiles feature is available starting from Cisco IOS XE Catalyst SD-WAN Release 17.6.1a only. This feature is not applicable to releases before Cisco IOS XE Catalyst SD-WAN Release 17.6.1a.
This example shows the small (S) profile being assigned.
-
Activate the DRE service for the application named Bangalore.
Example:
Device# app-hosting activate appid Bangalore
Note
Use the app-hosting activate appid command if you've already configured the DRE application, but haven't enabled it. Alternatively, you can use the start command in application hosting gateway configuration mode, as shown in the example in the preceding section.
-
Stop the DRE service for the application named Bangalore.
Example:
Device# app-hosting stop appid Bangalore
In this example Bangalore is the name of the DRE application to be stopped.
-
Deactivate the DRE service for the application named Bangalore.
Example:
Device# app-hosting deactivate appid Bangalore
In this example Bangalore is the name of the DRE application to be deactivated.
-
Uninstall the DRE service for the application named Bangalore.
Example:
Device# app-hosting uninstall appid Bangalore
In this example Bangalore is the name of the DRE application to be uninstalled.
DRE is installed and configured, the virtual port group is mapped, the service is started or activated as needed, and the service can be stopped, deactivated, and uninstalled when required.