Using the Interactive Editor

Language:

The installadm command automatically runs in interactive mode when you create a new manifest, whether based on an existing manifest or not.

How to Use the AI Interactive Tool

Before You Begin

Ensure that your role has the appropriate rights profiles to perform this procedure. See Using Rights Profiles to Install Oracle Solaris.

Launch the interactive tool with one of the following methods:
- Create a new manifest.
  For example:
```
aiserver$ installadm create-manifest -n solaris11_4-i386 -m mem1
```
- Create a new manifest based on an existing one.
  For example:
```
aiserver$ installadm create-manifest -e -n solaris11_4-i386 -m mem1 \
   -f /var/tmp/x86manifest.xml
```
  - –e activates the command's interactive mode.
  - –n identifies the install service that will use the new manifest.
  - –m identifies the manifest instance.
  - –d specifies the full path and XML file of the manifest.
The interactive mode is indicated by the installadm:manifest> prompt.
Modify or add parameter definitions to the file.
Choose one of the following methods:
- Type walk to go through each parameter.
```
installadm:mem1> walk
```
  Configure the first parameter or press Enter to skip to subsequent parameters.
- Use the Interactive Editor commands.
  Use editor commands to go directly to the parameters you want to configure or to add definitions. For a list of these commands, see Interactive Editor Commands or type help at the interactive prompt.
Type exit to quit the interactive mode.
An exit menu is displayed.
Type the menu item number of your choice.

Interactive Editor Commands

Use the following interactive editor commands to configure the manifest:

add: Adds an object or property. The command prompts you for objects and properties. See the description of walk in this list.
cancel: Discards any changes made on the current level and navigates up one level.
commit: At the top level, validates changes, saves the manifest and continues editing.
delete: Deletes an object or property.
end: Validates changes made on the current level and if no errors occur navigates up one level.
exit: Prompts to save the changes and exit, to exit without saving changes, or to continue editing.
info: Displays all objects and properties up to one level down.
move: Changes the order of multiple objects, such as software publishers.
select: Selects an object and navigates to that level.
set: Sets the value of a property.
walk: Prompts for each settable property and any settable subobjects or subproperties for the select object.

Examples of the Use of the Interactive Edit Mode

In the following examples, all user input is in bold. See also examples in the installadm(8) man page.

Example 1 Using the walk Interactive Command

This example shows an extract of the screen when you use the walk subcommand while customizing a manifest.

aiserver$ installadm create-manifest -n x86-service -m mymanifest
Type help to see list of subcommands.
installadm:mymanifest> walk
   *** To terminate walk, use Ctrl-D. ***
   http:proxy [not specified]:
   auto-reboot [false]: true
Ctrl-D is pressed
installadm:mymanifest> exit
1. Save manifest and exit.
2. Exit without saving committed changes.
3. Continue editing.
Please select choice: 1

Example 2 Adding a Publisher

This example uses interactive subcommands add a second publisher called firstoot to the manifest.

aiserver$ installadm create-manifest -n default-sparc -m test
Type help to see list of subcommands.
installadm:test> select software
installadm:test:software> add -w publisher
   *** To terminate walk, use Ctrl-D ***
   name [<not specified>]: firstboot
   key [<not specified>]: 
   cert [<not specified>]: 
   ca-cert [<not specified>]: 
   origin [<not specified>]: file:///net/host1/export/firstbootrepo
Ctrl-D is pressed 
installadm:test:software:publisher> info
   name: firstboot
   key: <not specified>
   cert: <not specified>
   ca-cert: <not specified>
   origin: file:///net/host1/export/firstbootrepo
   mirror: <not specified>
   cmd-options: <not specified>
installadm:test:software:publisher> end
installadm:test:software> exit
1. Save manifest and exit
2. Exit without saving uncommitted changes
3. Continue editing
Please select choice: 1

Example 3 Changing the Order of an Object

In this example, the order of the publishers is switched so that firstboot precedes solaris.

aiserver$ installadm update-manifest -n default-sparc -m test
Type help to see list of subcommands.
installadm:test> select software
installadm:test:software> move publisher 2 1
installadm:test:software> info
   type: IPS
   name: <not specified>
     ...
  publisher[1]:
      name: firstboot
      key: <not specified>
      cert: <not specified>
      ca-cert: <not specified>
      origin: http://example.com/solaris/mybuild
      mirror: <not specified>
      cmd-options: <not specified>
   publisher[2]:
      name: solaris
      key: <not specified>
      cert: <not specified>
      ca-cert: <not specified>
      origin: http://pkg.oracle.com/solaris/release
      mirror: <not specified>
      cmd-options: <not specified>
   pkg-list:
      action: install
      name: pkg:/entire@0.5.11-0.175.3
      name: pkg:/group/system/solaris-large-server
      reject: <not specified>
installadm:test:software> exit
1. Save manifest and exit
2. Exit without saving uncommitted changes
3. Continue editing
Please select choice: 1