JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
System Administration Guide: Oracle Solaris Containers-Resource Management and Oracle Solaris Zones
search filter icon
search icon

Document Information

Preface

Part I Resource Management

1.  Introduction to Solaris 10 Resource Management

2.  Projects and Tasks (Overview)

3.  Administering Projects and Tasks

4.  Extended Accounting (Overview)

5.  Administering Extended Accounting (Tasks)

6.  Resource Controls (Overview)

7.  Administering Resource Controls (Tasks)

8.  Fair Share Scheduler (Overview)

9.  Administering the Fair Share Scheduler (Tasks)

10.  Physical Memory Control Using the Resource Capping Daemon (Overview)

11.  Administering the Resource Capping Daemon (Tasks)

12.  Resource Pools (Overview)

13.  Creating and Administering Resource Pools (Tasks)

14.  Resource Management Configuration Example

15.  Resource Control Functionality in the Solaris Management Console

Part II Zones

16.  Introduction to Solaris Zones

17.  Non-Global Zone Configuration (Overview)

18.  Planning and Configuring Non-Global Zones (Tasks)

19.  About Installing, Halting, Cloning, and Uninstalling Non-Global Zones (Overview)

20.  Installing, Booting, Halting, Uninstalling, and Cloning Non-Global Zones (Tasks)

21.  Non-Global Zone Login (Overview)

22.  Logging In to Non-Global Zones (Tasks)

23.  Moving and Migrating Non-Global Zones (Tasks)

24.  Solaris 10 9/10: Migrating a Physical Solaris System Into a Zone (Tasks)

25.  About Packages and Patches on a Solaris System With Zones Installed (Overview)

26.  Adding and Removing Packages and Patches on a Solaris System With Zones Installed (Tasks)

27.  Solaris Zones Administration (Overview)

28.  Solaris Zones Administration (Tasks)

29.  Upgrading a Solaris 10 System That Has Installed Non-Global Zones

30.  Troubleshooting Miscellaneous Solaris Zones Problems

Part III lx Branded Zones

31.  About Branded Zones and the Linux Branded Zone

32.  Planning the lx Branded Zone Configuration (Overview)

33.  Configuring the lx Branded Zone (Tasks)

34.  About Installing, Booting, Halting, Cloning, and Uninstalling lx Branded Zones (Overview)

35.  Installing, Booting, Halting, Uninstalling and Cloning lx Branded Zones (Tasks)

36.  Logging In to lx Branded Zones (Tasks)

zlogin Command Overview

lx Branded Zone Login Methods

Login Procedures for Branded Zones (Task Map)

Logging In to an lx Branded Zone

How to Log In to the lx Branded Zone Console

How to Use Interactive Mode to Access a Branded Zone

How to Verify the Running Environment

How to Use Non-Interactive Mode to Access an lx Branded Zone

How to Exit the lx Branded Zone

How to Use Failsafe Mode to Enter an lx Branded Zone

How to Use zlogin to Shut Down an lx Branded Zone

37.  Moving and Migrating lx Branded Zones (Tasks)

38.  Administering and Running Applications in lx Branded Zones (Tasks)

Glossary

Index

Logging In to an lx Branded Zone

Use the zlogin command to log in from the global zone to any zone that is running or in the ready state. See the zlogin(1) man page for more information.

You can log in to a zone in various ways, as described in the following procedures. You can also log in remotely, as described in Remote Login.

How to Log In to the lx Branded Zone Console

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Use the zlogin command with the -C option and the name of the zone, for example, lx-zone.
    global# zlogin -C lx-zone
    [Connected to zone 'lx-zone' console]

    Note - If you start the zlogin session immediately after issuing the zoneadm boot command, boot messages from the zone will display:

    INIT: version 2.85 booting
                        Welcome to CentOS
                        Press 'I' to enter interactive startup.
        Configuring kernel parameters:  [  OK  ]
        Setting hostname lx-zone:  [  OK  ]
        [...]
        CentOS release 3.6 (Final)
        Kernel 2.4.21 on an i686

  3. When the zone console displays, log in as root, press Return, and type the root password when prompted.
    lx-zone console login: root
    Password:

    Note - Recall that the root (superuser) password is root when the zone is installed from the Sun tarball. The root (superuser) password is unset (blank) when the zone is installed from ISO images or a CD.


How to Use Interactive Mode to Access a Branded Zone

In interactive mode, a new pseudo-terminal is allocated for use inside the zone.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. From the global zone, log in to the zone, for example, lx-zone.
    global# zlogin lx-zone

    Information similar to the following will display:

    [Connected to zone 'lx-zone' pts/2]
    Last login: Wed Jul  3 16:25:00 on console
    Sun Microsystems Inc. SunOS 5.10 Generic July 2006
  3. Type exit to close the connection.

    You will see a message similar to the following:

    [Connection to zone 'lx-zone' pts/2 closed]

How to Verify the Running Environment

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Log in to the zone, for example, lx-zone.
    global# zlogin lx-zone
  3. Verify that you are running in a Linux environment under the Solaris Operating System.
    [root@lx-zone root]# uname -a

    You will see a display similar to the following:

    Linux lx-zone 2.4.21 BrandZ fake linux i686 i686 i386 GNU/Linux 

How to Use Non-Interactive Mode to Access an lx Branded Zone

Non-interactive mode is enabled when the user supplies a command to be run inside the zone. Non-interactive mode does not allocate a new pseudo-terminal.

Note that the command or any files that the command acts upon cannot reside on NFS.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. From the global zone, log in to the lx-zone zone and supply a command name.

    Replace command with the name of the command to be run inside the zone.

    global# zlogin lx-zone command

Example 36-1 Using the Command uptime in the Zone lx_master

global#  zlogin lx_master uptime
    21:16:01  up  2:39,  0 users,  load average: 0.19, 0.13, 0.11
    fireball#

How to Exit the lx Branded Zone

See Also

For more information about zlogin command options, see the zlogin(1) man page.

How to Use Failsafe Mode to Enter an lx Branded Zone

When a connection to the zone is denied, the zlogin command can be used with the -S option to enter a minimal environment in the zone.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. From the global zone, use the zlogin command with the -S option to access the zone, for example, lx-zone.
    global# zlogin -S lx-zone

How to Use zlogin to Shut Down an lx Branded Zone


Note - Running init 0 in the global zone to cleanly shut down a Solaris system also runs init 0 in each of the non-global zones on the system. Note that init 0 does not warn local and remote users to log off before the system is taken down.


Use this procedure to cleanly shut down a zone. To halt a zone without running shutdown scripts, see How to Halt a Zone.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Log in to the zone to be shut down, for example, lx-zone, and specify shutdown as the name of the utility and init 0 as the state.
    global# zlogin lx-zone shutdown -y -g0 -i0

    Your site might have its own shutdown script, tailored for your specific environment.

Using shutdown in Non-Interactive Mode

You cannot use the shutdown command in non-interactive mode to place the zone in single—user state at this time. See 6214427 for more information.

You can use an interactive login as described in How to Use Interactive Mode to Access a Branded Zone.