• 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.xmlfile.

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)