<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY arch "generic">
<!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 EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="delete-instance-1">
<refmeta><refentrytitle>delete-instance</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="delete-instance ">delete-instance
 &mdash; deletes the instance that is not running.</primary></indexterm><indexterm>
<primary sortas="deletes the instance that is not running.">deletes the instance
that is not running. &mdash; delete-instance </primary></indexterm><refname>
delete-instance </refname><refpurpose>deletes the instance that is not running
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>delete-instance </command>&synopsis-common;
<command><replaceable> instance_name</replaceable></command>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Use the <command>delete-instance</command> command to delete a server
instance. The <command>delete-instance</command> command can be run both locally
and remotely.  If a standalone instance is deleted (i.e. the instance's configuration
name is <replaceable>server&Dash;name</replaceable>&Dash;config and no other
        clusters or unclustered instances refer to this configuration), its
standalone configuration will be automatically deleted as well.</para>
<para>The Node Agent need not be running (or even installed or created) to
delete a server instance. However, if the Node Agent is running, the command
will delete the instance. If the Node Agent is not running, it will delete
the instance the next time it is started.  If a standalone instance is deleted,
that is, the instance's configuration name is <filename>server&mdash;name-config
</filename> and no other clusters or unclustered instances refer to this configuration,
then its standalone configuration will be automatically deleted as well.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
</variablelist></refsect1>
<refsect1><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>instance_name</replaceable></term><listitem>
<para> name of the instance to be deleted.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using <command>delete-instance in local mode</command></title>
<screen>asadmin> <userinput>delete-instance --user admin1 --passwordfile passwords.txt instance1
</userinput>
Command delete-instance executed successfully</screen>
<para>Where: <filename>instance1</filename> is deleted on the local machine.
</para>
</example>
<example><?Pub Caret>
<title>Using <command>delete-instance</command> in remote mode</title>
<screen>asadmin> <userinput>delete-instance --user admin --passwordfile passwords.txt 
--host pigeon --port 4849 instance2</userinput>
Command delete-instance executed successfully</screen>
<para>Where: <filename>instance2</filename> is deleted on the remote machine.
</para>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</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="create-instance-1"><citerefentry><refentrytitle>create-instance
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="start-instance-1"><citerefentry>
<refentrytitle>start-instance</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="stop-instance-1"><citerefentry><refentrytitle>stop-instance</refentrytitle>
<manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004435>
