<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY Dash "&ndash;">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="stop-instance-1">
<refmeta><refentrytitle>stop-instance</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="stop-instance">stop-instance &mdash;
stops a server instance</primary></indexterm><indexterm><primary sortas="stops a server instance">
stops a server instance &mdash; stop-instance</primary></indexterm><refname>
stop-instance</refname><refpurpose>stops a server instance</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>stop-instance</command>&synopsis-common;
<arg choice="plain"><replaceable>instance_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Use the <command>stop-instance</command> command to stop the instance
with the instance name specified. The <command>stop-instance</command> command
can be run both locally and remotely. The named instance must already exist
within the given domain; and the instance must be running.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>instance_name</replaceable></term><listitem>
<para>This is the name of the server instance to stop.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using <command>stop-instance</command> in local mode</title>
<screen>asadmin> <userinput>stop-instance --user admin1 --passwordfile passwords.txt instance1
</userinput>
Command stop-instance executed successfully</screen>
</example>
<example>
<title>Using <command>stop-instance</command> in remote mode</title>
<screen>asadmin> <userinput>stop-instance --user admin1 --password passwords.txt 
--host pigeon --port 4849 instance2</userinput>
Command stop-instance executed successfully</screen>
<para>Where: the <filename>instance2</filename> is associated with user, password,
host and port of the remote machine.</para>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</title>
<variablelist termlength="medium"><?Pub Caret>
<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>INTERFACE EQUIVALENT</title>
<para>Server Instance page</para>
</refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-instance-1"><citerefentry><refentrytitle>delete-instance
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="start-instance-1"><citerefentry>
<refentrytitle>start-instance</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="create-instance-1"><citerefentry><refentrytitle>create-instance</refentrytitle>
<manvolnum>1</manvolnum></citerefentry></link>, <link linkend="restart-instance-1"><citerefentry>
<refentrytitle>restart-instance</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000003651>
