Skip Headers

Oracle® JRockit Virtual Edition User's Guide Release 2.0.0 Part Number E22518-01 |
Home | Contents | Contact Us

Previous | Next
| View PDF

# --reconfigure-service

You can use the `--reconfigure-service` option to configure services that are enabled in the virtual machine.

Syntax

    java -jar jrockitve-imagetool.jar --reconfigure-service vm_cfg service-name operation field [parameter]*...]

Note:

For information about the syntax conventions, see Documentation Conventions for Command-Line Syntax.

Arguments

Argument | Description
--- | ---
`vm_cfg` | Path and name of the configuration file (`vm.cfg`) of the virtual machine to be reconfigured.
`service-name` | The name of the enabled service that you want to reconfigure. You can view the names of the services that are currently enabled in the virtual machine, by using the following command:
    java -jar jrockitve-imagetool.jar -r vm_cfg get enabled-services
`operation, field` | The fields that you can reconfigure for a service and the operations that you can perform on the field depend on the functionality that is exposed by the service. You can view a list of the reconfigurable fields, by running the `--reconfigure-service` option without specifying any operation. Example:
    java -jar jrockitve-imagetool.jar --reconfigure-service vm_cfg sshd
This command displays the fields that you can reconfigure for the `sshd` service, and the reconfiguration operations that you can perform, as follows.
    Operations for service "sshd":
    [get, remove] host-identity
    [get]         host-uuid
    [add, remove] key
    [get]         keys
    [add, remove] user
    [get]         users
    [get]         valid-arguments
In this example, `get`, `remove`, and `add` are the operations that can be performed on fields such as `host-identity`, `host-uuid`, and so on.
- `parameter` | The parameter that you must specify depends on the field you want to reconfigure and the operation you want to perform. You can view the parameters required for each field-operation combination, by running the `--reconfigure-service` option without specifying any parameter. Examples: To view the parameter to be specified for adding a user to the `sshd` service, run the following command:
      java -jar jrockitve-imagetool.jar --reconfigure-service vm_cfg sshd add user
  This command displays the required parameter, as follows.
      add key <username>
- To view the parameter to be specified for adding a key to the `sshd` service, run the following command:
      java -jar jrockitve-imagetool.jar --reconfigure-service vm_cfg sshd add key
  This command displays the required parameter, as follows.
      add key <key-file>

Example

    java -jar jrockitve-imagetool.jar --reconfigure-service vm_cfg sshd add user jrveuser

This command adds the user `jrveuser` to the `sshd` service and prompts you to enter the password for the user.