IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1M > luactivate man page

luactivate man page

Section 1M - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





System Administration Commands                     luactivate(1M)



NAME
     luactivate - activate a boot environment

SYNOPSIS
     /usr/sbin/luactivate  [-l  error_log]  [-o   outfile]   [-s]
     [BE_name] [-X]

DESCRIPTION
     The luactivate command is part of a suite of  commands  that
     make  up  the  Live Upgrade feature of the Solaris operating
     environment. See live_upgrade(5) for a  description  of  the
     Live Upgrade feature.

     The luactivate command, with no arguments, displays the name
     of  the  boot  environment (BE) that will be active upon the
     next reboot of the system. When an argument (a BE) is speci-
     fied, luactivate activates the specified BE.

     luactivate activates a BE by making the BE's root  partition
     bootable.  On  an  x86  machine, this might require that you
     take steps following the completion of  luactivate.  If  so,
     luactivate displays the correct steps to take.

     To successfully activate a BE, that BE must meet the follow-
     ing conditions:

       o  The BE must have a status of "complete," as reported by
          lustatus(1M).

       o  If the BE is  not  the  current  BE,  you  cannot  have
          mounted the partitions of that BE (using lumount(1M) or
          mount(1M)).

       o  The BE you want to activate cannot be  involved  in  an
          lucompare(1M) operation.


     After activating a specified  BE,  luactivate  displays  the
     steps to be taken for fallback in case of any problem on the
     next reboot. Make note of these instructions and follow them
     exactly, if necessary.

     Note -  Before booting a new BE, you must run luactivate  to
             specify  that  BE  as  active. luactivate performs a
             number  of  tasks,  described  below,  that   ensure
             correct  operation of the BE. In some cases, a BE is
             not bootable until after you have run the command.


     The luactivate command performs the following tasks:

       o



SunOS 5.10          Last change: 20 Nov 2003                    1






System Administration Commands                     luactivate(1M)



          The first time you boot from a newly created  BE,  Live
          Upgrade  software synchronizes this BE with the BE that
          was last active. (This is not necessarily the  BE  that
          was the source for the newly created BE.) "Synchronize"
          here means that certain system  files  and  directories
          are  copied  from  the  last-active  BE to the BE being
          booted. (See synclist(4).) Live Upgrade  software  does
          not  perform  this synchronization after a BE's initial
          boot, unless you use the -s option, described below.

       o  If luactivate detects conflicts between files that  are
          subject  to  synchronization,  it  issues a warning and
          does not perform the synchronization for  those  files.
          Activation  can complete successfully, in spite of such
          a conflict. A conflict can occur if you upgrade one  BE
          or  another to a new operating system version or if you
          modify system files (for example, /etc/passwd)  on  one
          of the BEs.

       o  luactivate  checks  to  see  whether  upgrade  problems
          occurred.   For  example,  packages  required  for  the
          correct operation of  the  operating  system  might  be
          missing. The command can issue a warning or, if a BE is
          incomplete, can refuse activation.

       o  luactivate determines  whether  the  bootstrap  program
          requires  updating  and takes steps to update if neces-
          sary. If a bootstrap program changed from on  operating
          release  to  another,  an  incorrect  bootstrap program
          might   render   an   upgraded   BE   unbootable.   See
          installboot(1M).

       o  luactivate modifies the root partition ID on a  Solaris
          x86  disk  to enable multiple BEs to reside on a single
          disk. In this configuration, if you do  not  run  luac-
          tivate,  booting  of  the BE will fail. See fmthard(1M)
          and dkio(7I).


     The luactivate command requires root privileges.

OPTIONS
     The luactivate command has the following options:

     -l error_log

         Error and status messages  are  sent  to  error_log,  in
         addition to where they are sent in your current environ-
         ment.






SunOS 5.10          Last change: 20 Nov 2003                    2






System Administration Commands                     luactivate(1M)



     -o outfile

         All command output is sent to outfile,  in  addition  to
         where it is sent in your current environment.



     -s

         Causes synchronization to occur (see  DESCRIPTION)  even
         if  next boot of a specified BE is not the first boot of
         that BE. Use this option with great caution, because you
         might  not  be aware or in control of changes that might
         have occurred in the last-active BE.

         If using -s, take special care when booting to  an  ear-
         lier  release  of  Solaris than what is installed on the
         last-active BE. For example,  consider  that  the  last-
         active  BE contains Solaris 9 and you want to activate a
         BE that contains Solaris 2.6. If you forced synchroniza-
         tion  with  the -s option, the BE containing Solaris 2.6
         might be synchronized with files that, while  compatible
         with Solaris 9, might not work under Solaris 2.6.



     -X

         Enable XML output. Characteristics of XML are defined in
         DTD,  in  /usr/share/lib/xml/dtd/lu_cli.dtd.<num>, where
         <num> is the version number of the DTD file.



OPERANDS
     BE_name

         Name of the BE to be activated.



EXIT STATUS
     The following exit values are returned:

     0        Successful completion.



     >0       An error occurred.






SunOS 5.10          Last change: 20 Nov 2003                    3






System Administration Commands                     luactivate(1M)



FILES
     /etc/lutab

         list of BEs on the system



     /usr/share/lib/xml/dtd/lu_cli.dtd.<num>

         Live Upgrade DTD (see -X option)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWluu                     |
    |_____________________________|_____________________________|


SEE ALSO
     lu(1M),    lucancel(1M),    lucompare(1M),     lucreate(1M),
     lucurr(1M),    ludelete(1M),    ludesc(1M),    lufslist(1M),
     lumake(1M),   lumount(1M),    lurename(1M),    lustatus(1M),
     luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)


























SunOS 5.10          Last change: 20 Nov 2003                    4





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:26:11 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5334 hits)
(openSUSE 10.2)

svn man page (5209 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)

CPAN man page (4607 hits)
(Suse Linux 10.1)

ssh man page (4342 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2884 hits)
(Solaris 10 11_06)

netcat man page (2717 hits)
(Suse Linux 10.1)

pprosetup man page (2492 hits)
(Solaris 10 11_06)

startproc man page (2471 hits)
(Suse Linux 10.1)

signal man page (2408 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Summer Activities :: Prototype Electronic Assembly :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum