Getting Familiar with Using Commands

The following steps illustrate how you might get familiar using the Command Central and Platform Manager commands. For more information about the commands used in the examples in the following table, see the section about landscape commands in this help.

1. Use a list command to view the type of information the command returns.

   For example, execute the following command to view a list of installations.

   sagcc list landscape nodes

   The output includes alias names for all the installations. You can use the alias names in subsequent commands to get data for an installation, update an installation, execute actions against an installation, or delete an installation.

2. Use a get or list command to retrieve information for a specific instance.
   Note: The get and list commands are equivalent.

   For example, assume the list command provided information for an installation that has the alias name “sag01”. To retrieve information for the “sag01” installation, returning the information to an output file in XML format, execute the following command:

   sagcc get landscape nodes sag01         
   --output info --format xml

3. Use a create command to create a new instance.

   You can edit the output file that a get command returns to specify the information for the new instance. Then you can use that file as input to the create command.

   For example, to create a new installation with alias name “new”, edit the info.xml file that the get command returned to supply the alias name, URL, and description for the new installation. Then execute the following command:

   sagcc create landscape nodes         
   --input info.xml

   Note: If you execute the list command again, the command lists the “new” installation.
4. Use an update command to update data for an instance.

   You can use a get command to retrieve information for the specific instance you want to update, returning the output to a file. Then you can update the output file the get command returns and use that as the input to the update command.

   For this example, update the “new” installation. Execute the following command to retrieve information for the “new” installation, returning the output to a file in XML format:

   sagcc get landscape nodes new         
   --output updatefile --format xml

   Update the data in the returned “updatefile”. For example, you might specify a new description. Then execute the following command to update the installation information:

   sagcc update landscape nodes new         
   --input updatefile

5. Use an exec command to execute an action against an instance.

   To generate a new ID for the “new” installation, execute the following command:

   sagcc exec landscape nodes new           
   generateNodeId

6. Use a delete command to remove an instance.

   To delete the “new” installation, execute the following command:

   sagcc exec landscape nodes new