<!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="upgrade-jbi-component-1">    <refmeta><refentrytitle>upgrade-
jbi-component</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>  <refnamediv><indexterm><primary  sortas="upgrade-jbi-
component">upgrade-jbi-component   &mdash;   upgrades  a  service
engine                         or                         binding
component</primary></indexterm><indexterm><primary
sortas="upgrades a service engine or binding  component">upgrades
a  service  engine  or  binding  component  &mdash;  upgrade-jbi-
component             </primary></indexterm><refname>upgrade-jbi-
component</refname><refpurpose>upgrades a service engine or bind-
ing                           component</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>upgrade-jbi-component</command>&synopsis-
common;     <arg    choice="opt">--properties    :    <group><arg
choice="plain"
rep="repeat">(name=<replaceable>value</replaceable>)<arg
choice="opt">:name=<replaceable>value</replaceable></arg></arg><arg
choice="plain"><replaceable>file</replaceable></arg></group></arg><arg
choice="opt">&Dash;&Dash;upload=<replaceable>
true</replaceable></arg><arg
choice="plain"><replaceable>component_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>           <refsect1><title>&desc-
tt;</title>  <para>The   <command>upgrade-jbi-component</command>
command  upgrades  a service engine or binding component that has
previously been installed in the  JBI  environment.  The  service
engine   or   binding   component   that   is   to   be  upgraded
<emphasis>must</emphasis> be in  the  <literal>shutdown</literal>
state.</para>    </refsect1>   <refsect1><title>&opts-tt;</title>
<variablelist                termlength="medium">&options-common;
<varlistentry><term><option
role="nodash">&Dash;&Dash;properties</option></term><listitem><para>Property
values  that  are  to be set for the component. The option can be
specified as a string of keyword-value pairs, or the  name  of  a
property  file can be provided.</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
this   option   to    false.</para>    </listitem></varlistentry>
</variablelist></refsect1>     <refsect1><title>&oper-tt;</title>
<variablelist                                termlength="medium">
<varlistentry><term><replaceable>component_name</replaceable></term><listitem><para>The
name of the JBI component or service engine that you are  upgrad-
ing.  This  component or service engine must have previously been
installed  in  the  JBI  environment   and   must   be   in   the
<literal>shutdown</literal>     state<?Pub    Caret>.     </para>
</listitem></varlistentry>             </variablelist></refsect1>
<refsect1><title>&exam-tt;</title>   <example>  <title>Using  the
upgrade-jbi-component command</title> <para>The following command
upgrades     a     JBI     component.</para>     <screen>asadmin>
<userinput>upgrade-jbi-component  --user  admin2   --passwordfile
passwords.txt component</userinput> Command upgrade-jbi-component
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="install-jbi-component-
1"><citerefentry><refentrytitle>install-jbi-
component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                               linkend="start-jbi-component-
1"><citerefentry><refentrytitle>start-jbi-
component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                       linkend="list-jbi-binding-components-
1"><citerefentry><refentrytitle>list-jbi-binding-
components</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                          linkend="list-jbi-service-engines-
1"><citerefentry><refentrytitle>list-jbi-service-
engines</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                                linkend="stop-jbi-component-
1"><citerefentry><refentrytitle>stop-jbi-
component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                           linkend="shut-down-jbi-component-
1"><citerefentry><refentrytitle>shut-down-jbi-
component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
<link                           linkend="uninstall-jbi-component-
1"><citerefentry><refentrytitle>uninstall-jbi-
component</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1> </refentry> <?Pub *0000005535>
