WildFly CLI - Taking and Restoring Configuration Snapshots: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 38: Line 38:
In order to rollback to a specific configuration, you will need the name of the configuration snapshot (in this case <tt>20160331-205313510standalone.xml</tt>).
In order to rollback to a specific configuration, you will need the name of the configuration snapshot (in this case <tt>20160331-205313510standalone.xml</tt>).


Shutdown the application server instance, then restart it with the following command:
Shutdown the application server instance, then restore the configuration file based on the backup:


<pre>
<pre>
$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/<snapshot-name>
cp $JBOSS_HOME/standalone/configuration/standalone_xml_history/snapshot/<snapshot-name> cp $JBOSS_HOME/standalone/configuration/standalone.xml
</pre>
</pre>


Line 47: Line 47:


<pre>
<pre>
$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20160331-205313510standalone.xml
cp $JBOSS_HOME/standalone/configuration/standalone_xml_history/snapshot//20160331-205313510standalone.xmlcp $JBOSS_HOME/standalone/configuration/standalone.xml
</pre>
</pre>


This command will restore the known configuration and transfer it to the current <tt>standalone.xml</tt> file.


The instance can then be shut down and restarted as usual.
The instance can then be shut down and restarted as usual.
Note that you can start the server based on the backup snapshot directly, as shown below:
<pre>
$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/<snapshot-name>
</pre>
Example:
<pre>
$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20160331-205313510standalone.xml
</pre>

Revision as of 04:11, 1 April 2016

Internal

Relevance

EAP 6.4

Overview

This article describes the procedure of taking a standalone instance configuration snapshot, usually performed before a significant CLI-based reconfiguration of the application server and restoring the initial configuration in case of re-configuration failure. This mechanism relies on the fact that the application server maintains a history of its past configurations, and it is capable of taking configuration snapshots. More details about this mechanism are available here:

WildFly Configuration History

Take a Configuration Snapshot

Before applying a configuration change (or a set of configuration changes) that could destabilize the application server instance, take a configuration snapshot as described below.

Connect to the application server with the CLI. More details on how to connect to the application server instance are available here: Connect to a Controller.

Take a configuration snapshot as follows:

[standalone@localhost:9999 /] cd /
[standalone@localhost:9999 /] :take-snapshot
{
    "outcome" => "success",
    "result" => "./configuration/standalone_xml_history/snapshot/20160331-205313510standalone.xml"
}

Record the name of the configuration snapshot (in this case 20160331-205313510standalone.xml). This information will be needed in case we need to rollback.

Rollback to a Specific Configuration

In order to rollback to a specific configuration, you will need the name of the configuration snapshot (in this case 20160331-205313510standalone.xml).

Shutdown the application server instance, then restore the configuration file based on the backup:

cp $JBOSS_HOME/standalone/configuration/standalone_xml_history/snapshot/<snapshot-name> cp $JBOSS_HOME/standalone/configuration/standalone.xml

Example:

cp $JBOSS_HOME/standalone/configuration/standalone_xml_history/snapshot//20160331-205313510standalone.xmlcp $JBOSS_HOME/standalone/configuration/standalone.xml


The instance can then be shut down and restarted as usual.


Note that you can start the server based on the backup snapshot directly, as shown below:

$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/<snapshot-name>

Example:

$JBOSS_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20160331-205313510standalone.xml