Command Central 10.1 | Command Central Developer Reference | Using the Command Line Interface | Landscape Commands | sagcc create landscape environments
 
sagcc create landscape environments
Creates a new environment that you want to use to manage a collection of installations.
Syntax
*Command Central syntax:
*To specify the data for the new environment on the command line:
sagcc create landscape environments  alias=env_alias [name=name]    
[description=description]  [options]
*To specify the data for the new environment in an input data file:
sagcc create landscape environments      
{--input | -i} filename{.xml|.json}  [options]
     
 options:        
[{--debug | -d}]        
[{--error | -r} file]        
[{--log | -l} file]        
[{--media-type | -m} content-type]        
[{--password | -p} password]        
[{--quiet | -q}]        
[{--server | -s} url]        
[{--username | -u} user_name]
*Not applicable to Platform Manager.
Arguments and Options
Argument or Option
Description
alias=env_alias
Required. Specifies the alias name you want to assign to the new environment. The name must be unique among all environments that Command Central manages.
Valid characters are ASCII characters, numbers, hyphen (-), underscore (_), and period (.). Spaces are not allowed.
[name=name]
Optional. Specifies the display name you want to assign to the environment. If you use a value that includes spaces, place quotes around the value, for example:
name="Dev Environment"
If you do not specify a display name, the command uses the value you supply for the environment alias name.
[description=description]
Optional. Specifies a description for the new environment. If you use a value that includes spaces, place quotes around the value, for example:
description="A description with spaces"

[{--input | -i}
filename{.xml|.json}]
Optional. Identifies an input file that contains the data for the new environment. For more information, see input.
Tip:
To determine how to specify the data in the input file, use sagcc get landscape environments to retrieve data for an existing environment. For example, if you want to use an XML input file, use sagcc get landscape environments with the --format xml option to retrieve the data in XML format.
[options]
Optional. Refer to the command syntax for a list of the options the command supports. For a description of the options, see Common Options.
Usage Notes
*After creating the new environment, use sagcc add landscape environments nodes to add existing installations to the environment.
Example When Executing on Command Central
To create a new environment with the display name “Development1”, the alias name “dev1”, and a description “Environment to test latest release”:
sagcc create landscape environments name=Development1 alias=dev1       
description="Environment to test latest release" --password secret
Because the {--server | -s} and {--username | -u} options are not specified, the command uses the default server and user name. For more information, see server and username. The command specifies “secret” for the user’s password