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
- INTERFACE EQUIVALENT
- 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

## INTERFACE EQUIVALENT

> Any Apply Changes button in the interface

## SEE ALSO

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

Sun Java System Application Server | Go To Top | Last Changed 29 Dec 2003

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