<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY Pam SYSTEM "Pam.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="restore-domain-1">
<refmeta><refentrytitle>restore-domain</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="restore-domain">restore-domain &mdash;
restores files from backup</primary></indexterm><indexterm><primary sortas="restores files from backup">
restores files from backup &mdash; restore-domain</primary></indexterm><refname>
restore-domain</refname><refpurpose>restores files from backup</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>restore-domain</command><arg choice="opt">&Dash;&Dash;domaindir <replaceable>
domain_directory</replaceable></arg><arg choice="opt">&Dash;&Dash;filename <replaceable>
backup_filename</replaceable></arg><arg choice="opt">&Dash;&Dash;description <replaceable>
description</replaceable></arg><arg>&Dash;&Dash;terse=<replaceable>false</replaceable></arg>
<arg>&Dash;&Dash;verbose=<replaceable>false</replaceable></arg><arg><replaceable>
domain_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command restores files under the domain from a backup directory.
The <command>restore-domain</command> command is supported in local mode only.
</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">&Dash;&Dash;domaindir</option></term>
<listitem><para>This option specifies the parent directory of the domain upon
which the command will operate. The default is <filename>install_dir/domains
</filename>.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;filename</option></term>
<listitem><para>The restore is performed using the specified zip file as the
source.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;description</option></term>
<listitem><para>A description can contain any string to help identify the
particular backup. The description is displayed as part of the information
for any backup.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;t</option> <option role="nodash">&Dash;&Dash;terse
</option></term><listitem><para>Indicates that any output data must be very
concise, typically avoiding human-friendly sentences and favoring well-formatted
data for consumption by a script. Default is false.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;v</option> <option role="nodash">&Dash;&Dash;verbose
</option></term><listitem><para>Indicates that output data is displayed with
detailed information. Default is false.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>domain_name</replaceable></term><listitem>
<para>This is the name of the domain to restore. If the domain is not specified
and only one domain exists, it will be used automatically.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using restore-domain</title>
<screen>asadmin><userinput>restore-domain --domaindir /opt/SUNWappserver/nondefaultdomaindir/domain1 --filename sjsas_backup_v00001.zip domain1
</userinput>
Successfully restored the domain (domain1), from /opt/SUNWappserver/nondefaultdomaindir/domain1/backups/sjsas_backup_v00001.zip

Description: 1137030607263
Backup Filename: /opt/SUNWappserver/nondefaultdomaindir/domain1/backups/sjsas_backup_v00001.zip
Date and time backup was performed: Wed Jan 11 17:50:07 PST 2006
Domains Directory: /opt/SUNWappserver/nondefaultdomaindir
Domain Directory: /opt/SUNWappserver/nondefaultdomaindir/domain1
Domain Name: domain1
Name of the user that performed the backup: jondoe<?Pub Caret></screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="backup-domain-1"><citerefentry><refentrytitle>backup-domain
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-backups-1"><citerefentry>
<refentrytitle>list-backups</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005040>
