<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<!--Arbortext, Inc., 1988-2007, v.4002-->
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="delete-instance-1">
<!-- @(#)delete-instance.1 1.13 07/07/25 SMI; -->
<refmeta><refentrytitle>delete-instance</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">13 Jul 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>delete-instance</primary></indexterm><indexterm>
<primary>deletes the instance that is not running.</primary></indexterm>
<refname>delete-instance </refname><refpurpose>deletes the instance that is
not running</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>delete-instance </command> &synopsis-common; <replaceable> instance_name
</replaceable> </synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Use the <command>delete-instance</command> command to delete a server
instance. If a standalone instance is deleted (i.e. the instance's configuration
name is <replaceable>server-name-</replaceable>-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 role="options"><title></title>
<variablelist termlength="wholeline">&options-common;
</variablelist>
</refsect1>
<refsect1 role="operands"><title></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 role="examples"><title></title>
<example><title>Using <command>delete-instance</command>:</title>
<screen>asadmin> <userinput>delete-instance --user admin 
--passwordfile passwords.txt --host pigeon 
--port 4848 instance2</userinput>
Command delete-instance executed successfully</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></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 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="create-instance-1">create-instance(1)</olink>, <olink targetdoc="asrefman" targetptr="start-instance-1">start-instance(1)</olink>, <olink targetdoc="asrefman" targetptr="stop-instance-1">stop-instance(1)</olink></para>
</refsect1>
</refentry>
