Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

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 Commandsreconfig(1)


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

SEE ALSO

 

get(1), set(1), list(1)



Go To TopLast Changed April 2004