<!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 binding 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 upgrading. 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>
