<!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="deploy-jbi-service-assembly-1">
<refmeta><refentrytitle>deploy-jbi-service-assembly</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="deploy-jbi-service-assembly">deploy-jbi-service-assembly &mdash; deploys a service assembly into the JBI environment</primary></indexterm><indexterm><primary sortas="deploys a service assembly into the JBI environment">deploys a service assembly into the JBI environment &mdash;
deploy-jbi-service-assembly</primary></indexterm><refname>deploy-jbi-service-assembly</refname><refpurpose>deploys a service assembly into the JBI environment</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>deploy-jbi-service-assembly</command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;enabled=<replaceable>true</replaceable></arg><arg choice="opt">&Dash;&Dash;upload=<replaceable>true</replaceable></arg><arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg><arg choice="plain"><replaceable>filepath or service_assembly_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>T<?Pub Caret1>he <command>deploy-jbi-service-assembly</command> command deploys a service assembly into the JBI environment. </para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term><listitem><para>If this option is set to true, the service assembly is started automatically when the system starts up. Users are allowed to access the service assembly. If this option is set to false, the service assembly is
not started automatically when the system starts up. Users are not able to access the service assembly. For EE, this option enables the deployment on the specified target instance or cluster. This option is ignored when the service assembly is being deployed on the target domain.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;upload</option></term><listitem><para>When this option is set to true, the command uploads the file to the administration server. The file is uploaded to the <systemitem class="environvar">$JBI_HOME</systemitem><filename>/tmp</filename> directory on
the Domain Administration Server (DAS), for example, <systemitem class="environvar">$AS_INSTALL_DIR</systemitem><filename>/domains/</filename><replaceable>domain_name</replaceable><filename>/jbi/tmp</filename>. If the filepath of the installable file is mounted to the server machine, or if the administration
server is running locally, set the upload option to false.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term><listitem><para>Specifies the target on which you are deploying the service assembly. Specify this option only if the service assembly is deployed in a multiserver environment with a 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 deploys the JBI service assembly on the embedded DAS instance. This is the default value.</para>
</listitem>
<listitem><para><literal>domain</literal>, which deploys the JBI service assembly for 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 deploys the JBI service assembly on every server instance in the cluster.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which deploys the JBI service assembly for the named unclustered server instance.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="wholeline">
<varlistentry><term><replaceable>filepath or service_assembly_name</replaceable></term><listitem><para>The path to the archive file that contains the attributes of the JBI service assembly or the name of the service assembly that has been previously deployed to the domain.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the deploy-jbi-service-assembly command</title>
<para>The following command deploys a JBI service assembly.</para>
<screen>asadmin> <userinput>deploy-jbi-service-assembly --user admin2
--passwordfile passwords.txt --target server1 filepath</userinput>
Command deploy-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="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 *0000006052>
