Logging In to a 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 Create a Configuration Profile

Caution - Note that all data required must be supplied. If you provide a profile with missing data, then the zone is configured with missing data. This configuration might prevent the user from logging in or getting the network running.

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.

Create the profile using the sysconfig tool.

For an exclusive-IP zone

# sysconfig create-profile -o /path/sysconf.xml

For a shared-IP zone:

# sysconfig create-profile -o /path/sysconf.xml -g location,identity,naming_services,users

Use the created profile during zone install, clone, or attach operations.
```
# zoneadm -z my-zone install -c /path/sysconf.xml
```
If the configuration file is used, the system will not start the System Configuration Interactive (SCI) Tool on the console at initial zlogin. The file argument must be specified with an absolute path.

How to Log In to the Zone Console to Perform the Internal Zone Configuration

If a config.xml file was passed to the zoneadm clone, attach, or install commands, this configuration file is used to configure the system. If no config.xml file was provided during the clone, attach, or install operation, then the first boot of the zone will start the SCI Tool on the console.

To avoid missing the initial prompt for configuration information, it is recommended that two terminal windows be used, so that zlogin is running before the zone is booted in a second session.

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
Use the zlogin command with the -C option and the name of the zone, for example, my-zone.
```
global# zlogin -C my-zone
```
From another terminal window, boot the zone.
```
global# zoneadm -z my-zone boot
```
You will see a display similar to the following in the zlogin terminal window:
```
[NOTICE: Zone booting up]
```
Respond to the series of questions about configuration parameters for your newly installed zone. Parameters include system host name, time zone, user and root accounts, and name services. By default, the SCI Tool produces an SMF profile file in /system/volatile/scit_profile.xml.

Troubleshooting

If the initial SCI screen doesn't appear, you can type Ctrl L to refresh the SCI screen.

How to Log In to the Zone Console

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
Use the zlogin command with the -C option, the -d option and the name of the zone, for example, my-zone.
```
global# zlogin -C -d my-zone
```
Using the zlogin command with the -C option starts the SCI Tool if the configuration has not been performed.
When the zone console displays, log in as root, press Return, and type the root password when prompted.
```
my-zone console login: root
Password:
```

How to Use Interactive Mode to Access a Zone

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

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
From the global zone, log in to the zone, for example, my-zone.
```
global# zlogin my-zone
```
Information similar to the following will display:
```
[Connected to zone 'my-zone' pts/2]
Last login: Wed Jul  3 16:25:00 on console
```
Type exit to close the connection.
You will see a message similar to the following:
```
[Connection to zone 'my-zone' pts/2 closed]
```

How to Use Non-Interactive Mode to Access a 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 or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
From the global zone, log in to the my-zone zone and supply a command name.
The command zonename is used here.
```
global# zlogin my-zone zonename
```
You will see the following output:
```
my-zone
```

How to Exit a Non-Global Zone

To disconnect from a non-global zone, use one of the following methods.
- To exit the zone non-virtual console:
```
zonename# exit
```
- To disconnect from a zone virtual console, use the tilde (~) character and a period:
```
zonename# ~.
```
  Your screen will look similar to this:
```
[Connection to zone 'my-zone' pts/6 closed]
```
Note - The default escape sequence for ssh is also ~, which causes the ssh session to exit. If using ssh to remotely login to a server, use ~~. to exit the zone.

How to Use Failsafe Mode to Enter a 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 or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
From the global zone, use the zlogin command with the -S option to access the zone, for example, my-zone.
```
global# zlogin -S my-zone
```

How to Use `zlogin` to Shut Down a Zone

Note - Running init 0 in the global zone to cleanly shut down a Oracle 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 or a user with appropriate authorizations in the global zone to perform this procedure.

Become an administrator.
Log in to the zone to be shut down, for example, my-zone, and specify shutdown as the name of the utility and init 0 as the state.
```
global# zlogin my-zone shutdown -i 0
```
Your site might have its own shutdown script, tailored for your specific environment.

Skip Navigation Links
Exit Print View
	Oracle Solaris Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management Oracle Solaris 11 Information Library