lurename

 

---

 
 
 
 Maintenance Commands                                 lurename(1M)
 
 
 


NAME
      lurename - change the name of a boot environment
 


SYNOPSIS
      lurename  -e BE_name   -n new_name  [  -l error_log  ]     [
      -o outfile ]
 


DESCRIPTION
      The lurename 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 lurename  command  renames  the  boot  environment  (BE)
      BE_name to new_name.
 
      The string new_name must not exceed 30 characters in  length
      and  must  consist only of alphanumeric characters and other
      ASCII characters that are not special to the Unix shell. See
      the "Quoting" section of sh(1). The BE name can contain only
      single-byte, 8-bit characters. Also, new_name must be unique
      on the system.
 
      A BE must have the status "complete" before you  rename  it.
      Use  lustatus(1M) to determine a BE's status. Also, you can-
      not  rename  a  BE  that  has  file  systems  mounted   with
      lumount(1M) or mount(1M).
 
      Renaming a BE is often useful when you upgrade the  BE  from
      one  Solaris  release  to another. For example, following an
      operating system upgrade, you might rename the  BE  solaris7
      to solaris8.
 
      The lurename command requires root privileges.
 


OPTIONS
      The lurename command has the options listed below.
 
      -e BE_name
            Name of the BE whose name you want to change.
 
      -l error_log
            Error and status messages are sent  to  error_log,  in
            addition  to  where  they  are  sent  in  your current
            environment.
 
      -n new_name
            New name of the BE. new_name must be unique on a given
            system.
 
      -o outfile
            All command output is sent to outfile, in addition  to
 
 
 
 SunOS 5.8           Last change: 22 Oct 2001                    1
 
 
 
 
 
 
 Maintenance Commands                                 lurename(1M)
 
 
 
            where it is sent in your current environment.
 
 EXIT STATUS
      The following exit values are returned:
 
      0     Successful completion.
 
      >0    An error occurred.
 


FILES
      /etc/lutab
            list of BEs on the system
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWluu                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      lu(1M),   luactivate(1M),    lucancel(1M),    lucompare(1M),
      lucreate(1M),    lucurr(1M),   ludelete(1M),   lufslist(1M),
      lumake(1M),   lumount(1M),   lustatus(1M),    luupgrade(1M),
      lutab(4), attributes(5), live_upgrade(5)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 22 Oct 2001                    2
 
 
 

---