sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

User Commands | reconfig(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- SEE ALSO

## NAME

| reconfig - applies the changes you have made for a server instance

## SYNOPSIS

| ``reconfig` --user admin_user[ --password admin_password ][ --host localhost ] [ --port 4848 ][ --passwordfile filename ][ --secure|-s ] [ --discardmanualchanges=false ][ --keepmanualchanges=false ]instance_name`

## DESCRIPTION

| `reconfig` allows you to apply changes you have made for a server instance. Use the `reconfig` command after you've used the `set` command to change server properties. Any changes you make to the configuration files of the server do not take affect until you apply the changes by running the `reconfig` command. The valid combinations are: --discardmanualchanges=true --keepmanualchanges=false this will discard your manual changes and use the admin changes. --discardmanualchanges=false --keepmanualchanges=true this will keep your manual changes and discard the admin changes. --discardmanualchanges=false --keepmanualchanges=false an error message is displayed if manual changes have been made. --discardmanualchanges this will discard your manual changes and use the admin changes. --keepmanualchanges this will keep your manual changes and discard the admin changes. If no options are specified, an error message is displayed. Use this command with discretion since there is no undo, and the changes applied are made directly to your `config/backup/server.xml`file.

## OPTIONS

| --user administrative user associated for the instance. --password administrative password corresponding to the administrative user. --host host name of the machine hosting the administrative instance. --port administrative port number associated with the administrative host. --passwordfile file containing passwords appropriate for the command (e.g., administrative instance). --secure if true, uses SSL/TLS to communicate with the administrative instance. --discardmanualchanges defaults to false. When set to true, discards the changes made manually to the `server.xml` file. --keepmanualchanges defaults to false. When set to true, allows the manual changes made to the `server.xml` file to take affect.

## OPERANDS

| instance_name name of the instance.

## EXAMPLES

| Example 1. Using `reconfig`
    asadmin> reconfig --user admin --passwordfile passwords.txt --host localhost
    --port 4848 server1
    Successfully reconfigured
Example 2. Using `reconfig` with the --discardmanualchanges option
    asadmin> reconfig --user admin --passwordfile passwords.txt --host localhost
    --port 4848 --discardmanualchanges server1
    Instance restart is required
    Successfully reconfigured
Example 3. Using `reconfig` with the --keepmanualchanges option
    asadmin> reconfig --user admin --passwordfile passwords.txt --host localhost
    --port 4848 --keepmanualchanges server1
    Instance restart is required
    Successfully reconfigured

## EXIT STATUS

| 0 command executed successfully 1 error in executing the command

## SEE ALSO

| `get`(1), `set`(1), `list`(1)

| Go To Top | Last Changed April 2004

Company Info | Contact | Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.