<!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 % 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="undeploy-jbi-service-assembly-1">
<refmeta><refentrytitle>undeploy-jbi-service-assembly</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="undeploy-jbi-service-assembly">undeploy-jbi-service-assembly &mdash; undeploys a service assembly on the specified target</primary></indexterm><indexterm><primary sortas="undeploys a service assembly on the specified target">undeploys a service assembly on the specified
target &mdash; undeploy-jbi-service-assembly</primary></indexterm><refname>undeploy-jbi-service-assembly</refname><refpurpose>undeploys a service assembly on the specified target</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>undeploy-jbi-service-assembly</command><?Pub Caret>&synopsis-common;
<arg choice="opt">&Dash;&Dash;force=<replaceable>false</replaceable></arg><arg choice="opt">&Dash;&Dash;keeparchive=<replaceable>false</replaceable></arg><arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg><arg choice="plain"><replaceable>service_assembly_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>undeploy-jbi-service-assembly</command> command undeploys a service assembly on the specified target. If the target is not specified, the command will be executed on the server instance.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;F</option> <option role="nodash">&Dash;&Dash;force</option></term><listitem><para>Setting to true forcibly undeploys the service assembly. Default is false.</para>
</listitem></varlistentry>
<varlistentry><term> <option role="nodash">&Dash;&Dash;keeparchive</option></term><listitem><para>Setting to true retains the service assembly that is stored in the  Domain Administration Server (DAS) repository. The service assembly is retained even if the service assembly is undeployed from all servers
in the JBI environment. Setting this option to true enables you to re-deploy the service assembly from the DAS  repository instead of re-deploying the service assembly from an archive file.</para>
<para>Setting to false deletes the service assembly from the DAS repository when the  service assembly is no longer deployed on any server in the JBI environment.</para>
<para>Default is false.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term><listitem><para>Specifies the target on which you are undeploying the service assembly. Specify this option only if the service assembly is deployed in a multiserver environment with a Domain Administration Server (DAS). If the
service assembly is not deployed in a multiserver environment with a DAS, this option is ignored. Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which undeploys the JBI service assembly on the embedded DAS instance. This is the default value.</para>
</listitem>
<listitem><para><literal>domain</literal>, which undeploys the JBI service assembly on the administrative domain itself. Specify <literal>domain</literal> only if you are using the cluster profile.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which undeploys the JBI service assembly on every server instance in the cluster.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which undeploys the JBI service assembly on the named unclustered server instance.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>service_assembly_name</replaceable></term><listitem><para>The name of the JBI service assembly you want to undeploy.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the undeploy-jbi-service-assembly command</title>
<para>The following command undeploys a JBI service assembly.</para>
<screen>asadmin> <userinput>undeploy-jbi-service-assembly --user admin2
--passwordfile passwords.txt --target server1 service_assembly_name</userinput>
Command undeploy-jbi-service-assembly executed successfully.</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="deploy-jbi-service-assembly-1"><citerefentry><refentrytitle>deploy-jbi-service-assembly</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-jbi-service-assemblies-1"><citerefentry><refentrytitle>list-jbi-service-assemblies</refentrytitle><manvolnum>
1</manvolnum></citerefentry></link>, <link linkend="shop-jbi-service-assembly-1"><citerefentry><refentrytitle>show-jbi-service-assembly</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005893>
