<!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>
