FreeKB - IBM WebSphere restoreConfig script
IBM WebSphere - restoreConfig script

This assumes you have backed up a WebSphere application server or profile using the (Linux) or (Windows) scripts.

The (Linux) or restoreConfig.bat (Windows) command can be used to restore a WebSphere application server or profile.

When the restoreConfig script is invoked from the ${WAS_INSTALL_ROOT}/bin directory, the entire application server will be restored.



When the restoreConfig script is invoked from the ${WAS_INSTALL_ROOT}/bin/profiles/your_profile/bin directory, the profile wil be restored. In this scenario, profile "AppSrv01" will be restored.



Linux Permissions and Ownership

The and scripts will not store the file permissions and ownership of files. For example, if file1.txt is owned by Admins and has permissions -rwxrwsr-x, the owner and permissions may not be proper after invoking the script. For this reason, it is recommended to not use the and scripts on Linux, and to instead use the TAR command to create and restore.


-nostop option

By default, the restoreConfig command will stop the nodes, which means that the application servers and applications in the nodes are also stopped. In a non-clustered environment, this produces some downtime, as the nodes/application servers/applications will be stopped while the restoreConfig script is executing. 

Note - The nodes/application servers/application will automatically start after the restoreConfig script completes its execution

The -nostop option can  be used to not stop the nodes as part of the restore. -nostop


-username -password options

If administrative security is enabled, the restoreConfig command without any options will prompt you to provide a username and password. The -username and -password options can be used to provide the username and password on the command line. However, you should avoid using the -username and -password options, as the username and password can easily be intercepted using the ps command (Linux). This is another reason why the TAR command should be used instead, as the TAR command does not expose your username and password. -username your_username -password your_password


config.old directory

If the ${WAS_INSTALL_ROOT}/profiles/your_profile/config directory exists, it will be renamed to config.old, and then the config directory will be restored from the backup zip file. The following will be displayed in the console.

ADMU5502I: The directory was_home/profiles/profile01/config already exists;
           renaming to was_home/profiles/profile01/config.old
ADMU5504I: Restore location successfully renamed
ADMU5505I: Restore file to location was_home/profiles/profile01/config


Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter 84c3a in the box below so that we can be sure you are a human.


Web design by yours truely - me, myself, and I   |   |