Managing applications

In the StorONE system, an application is a logical namespace for grouping virtual storage containers (VSCs, also referred to as volumes within the user interfaces and documentation). Using the command line interface (CLI), you can list, create, edit, and delete applications using the applications command.

Listing applications

To list application instances, use the applications list command.

Usage

applications list [--application=<name>] [--desc] [--cg] [--vols]

Options

Options and arguments	Description
--application=<name>	List information from the specified application. Replace <name> with the application you want to list.
--desc	Show application descriptions.
--cg	Show consistency groups within each application.
--vols	List volumes within each application.

Examples

1. To list all applications and their descriptions, run:

   
   

   applications list --desc

2. To list all applications and their descriptions, as well as the volumes within each application, run

   
   

   applications list --desc --vols

3. To display the description, consistency groups, and volumes for only the sales application, run

   
   

    applications list --application sales --desc --cg --vols

Creating an application

You can create an application instance using the application create command. You cannot create VSCs or use any of the other features of the applications commands without creating at least one application instance. An application instance is a namespace for volumes. Within the application instance, volume names must be unique. However, volumes with the same name may exist in different application namespaces..

Usage

applications create --application=<name> [--template=<template>] [--description=<description>]

Options

Options and arguments	Description
--application=<name>	Specifies the application name. Replace <name> with a name of your choice.
--template=<template>	Creates the application from a template. Replace <template> with the template name.
--description=<description>	Provide a description for the application. If the description contains spaces, surround it with double quotes (for example, --description "VDI volumes for HR").

Examples

1. To create a new application instance sales with a description, run

   
   

   applications create --application sales --description "Application for the sales team."

2. To create application instance HR from a template standard-app-inst with a description, run

   
   

   application create --application HR --template standard-app-inst --description "For our HR team"

Editing an application

To edit an application, use the applications edit command. Because applications are just logical namespaces for volumes, the only attributes to edit are the name and description.

Usage

applications edit --application=<name> [--newname=<new_name>] [--description=<new_description>]

Options

Options and arguments	Description
--application=<name>	Specify the name of the application you want to edit.
--newname=<new_name>	Specify the new name for the application. Replace <new_name> with a name of your choice.
--description=<new_description>	Provide a new description for the application. If the description contains spaces, surround it with double quotes (for example, --description "File shares for Sales and Engineering").

Examples

1. To change the description of application instance sales, run

   
   

   applications edit --application sales --description "We are the most powerful sales team in the universe."

2. To change the name of the application instance sales to super-sales; run

   
   

   application edit --application sales --newname super-sales

3. To change the name of the application instance HR to human-resources and to change the description, run

   
   

   application edit --application HR --newname human-resources --description "VSCs for the HR department"

Deleting an application

To delete an application instance, use the applications delete command.

Usage

applications delete --application=<name> [--force]

Options

Options and arguments	Description
--application=<name>	Specify the name of the application to delete.
--force	Delete the application without prompting for approval.

Examples

1. To delete application instance HR; run

   
   

   applications delete --application HR 

2. To delete application instance HR without getting prompted for approval, run

   
   

   applications delete --application=HR --force