Diskless Client Management Overview

The following sections and Chapter 7, Managing Diskless Clients (Tasks) describe how to manage diskless client support in the Solaris Operating System (Solaris OS).

A diskless client is a system that depends on an OS server for its operating system, software, and storage. A diskless client mounts its root (/), /usr, and other file systems from its OS server. A diskless client has its own CPU and physical memory and can process data locally. However, a diskless client cannot operate if it is detached from its network or if its OS server malfunctions. A diskless client generates significant network traffic because of its continual need to function across the network.

Starting with the Solaris 9 release, the diskless client commands, smosservice and smdiskless, enable you to manage OS services and diskless client support. In the Solaris 8 release, diskless clients were managed with the Solstice^TM GUI management tools.

OS Server and Diskless Client Support Information

Caution - Attempts to add diskless client support using an OS client-server configuration where one system implements the new boot architecture, but the other system does not, can result in major incompatibilities. New boot (GRUB) was implemented on the x86 platform, starting with the Solaris 10 1/06 release and on the SPARC platform, starting with the Solaris 10 10/8 release. Note that adding diskless support on systems that are running a Solaris release that is more recent than that which is running on the OS server is also an unsupported configuration. To avoid potential problems, it is recommended that you install the latest Solaris release before adding diskless client support.

The Solaris releases and architecture types that are supported by the smosservice and smdiskless commands include the following:

SPARC based servers: Supported in the Solaris 8, Solaris 9, Solaris 10, and Solaris Express releases
SPARC based clients: Supported in the Solaris 8, Solaris 9, Solaris 10, and Solaris Express releases
x86 based servers: Supported in the Solaris 9, Solaris 10, and Solaris Express releases
x86 based clients: Supported in the Solaris 9, Solaris 10, and Solaris Express releases

The following table illustrates the x86 OS client-server configurations that are supported by the smosservice and smdiskless commands. This information applies to the Solaris 9 and the Solaris 10 FCS (3/05) release.

If you are running at least the Solaris 10 1/06 release, or a Solaris Express Community release, it is recommended that you install or upgrade to the same release before adding diskless client support.

Table 6-3 x86 OS Client-Server Support

	Diskless Client OS
Server OS	Solaris 10 3/05	Solaris 9
Solaris 10 3/05	Supported	Supported
Solaris 9	Not supported	Supported

The following table describes the SPARC OS client-server configurations that are supported by the smosservice and smdiskless commands. This information applies to the Solaris 8 and Solaris 9 releases, and the Solaris 10 release, up through the Solaris 10 5/08 OS.

If you are running at least the Solaris 10 10/08 release, or a Solaris Express Community release, it is recommended that you install or upgrade to the same release before adding diskless client support.

Table 6-4 SPARC OS Client-Server Support

	Diskless Client OS
Server OS	Solaris 10 3/05 through Solaris 10 5/08	Solaris 9	Solaris 8
Solaris 10 3/05 through Solaris 10 5/08	Supported	Supported	Supported
Solaris 9	Not supported	Supported	Supported
Solaris 8	Not supported	Not supported	Supported

Diskless Client Management Features

You can use the smosservice and smdiskless commands to add and maintain diskless client support on a network. By using a name service, you can manage system information in a centralized manner so that important system information, such as host names, do not have to be duplicated for every system on the network.

You can perform the following tasks with the smosservice and smdiskless commands:

Add and modify diskless client support
Add and remove OS services
Manage diskless client information in the LDAP, NIS, NIS+, or files name service environment

If you are performing a GRUB based boot on an x86 system, you need to manually set up the DHCP configuration. See x86: How to Prepare for Adding Diskless Clients in a GRUB Based Boot Environment for more information.

Note - You can only use the diskless client commands to set up diskless client booting. You cannot use these commands to set up other services, such as remote installation or profile services. Set up remote installation services by including diskless client specifications in the sysidcfg file. For more information, see Solaris Express Installation Guide: Custom JumpStart and Advanced Installations.

Working With Diskless Client Commands

By writing your own shell scripts and using the commands shown in the following table, you can easily set up and manage your diskless client environment.

Table 6-5 Diskless Client Commands

Command	Subcommand	Task
`/usr/sadm/bin/smosservice`	`add`	Add OS services
	`delete`	Delete OS services
	`list`	List OS services
	`patch`	Manage OS service patches
`/usr/sadm/bin/smdiskless`	`add`	Add a diskless client to an OS server
	`delete`	Delete a diskless client from an OS server
	`list`	List the diskless clients on an OS server
	`modify`	Modify the attributes of a diskless client

You can obtain help on these commands in two ways:

Use the -h option when you type the command, subcommand, and required options, as shown in the following example.
```
% /usr/sadm/bin/smdiskless add -p my-password -u my-user-name -- -h
```
View the smdiskless(1M) and smosservice(1M) man pages.

Required RBAC Rights for Diskless Client Management

You can use the smosservice and smdiskless commands as superuser. If you are using role-based access control (RBAC), you can use either a subset of or all of the diskless client commands, according to the RBAC rights to which they are assigned. The following table lists the RBAC rights that are required to use the diskless client commands.

Table 6-6 Required RBAC Rights for Diskless Client Management

RBAC Right	Command	Task
Basic Solaris User, Network Management	`smosservice list`	List OS services
	`smosservice patch`	List OS service patches
	`smdiskless list`	List diskless clients on an OS server
Network Management	`smdiskless add`	Add diskless clients
System Administrator	All commands	All tasks

Adding OS Services

A Solaris OS server is a server that provides operating system (OS) services to support diskless client systems. You can add support for an OS server or convert a stand-alone system to an OS server by using the smosservice command.

For each platform group and Solaris release that you want to support, you must add the particular OS service to the OS server. For example, if you want to support SPARC sun-4u systems running the Solaris Express release, you must add the Sun-4u/Solaris Express OS services to the OS server. For each diskless client that you support, you must add the OS service for that client to the OS server. For example, you would need to add OS services to support SPARC sun-4m systems or x86 based systems that run the Solaris 10 or Solaris 9 release, because they are different platform groups.

You must have access to the appropriate Solaris software CD or disk image to add OS services.

Adding OS Services When the OS Server Has Been Patched

When adding OS services to an OS server, you might see an error message stating that you have inconsistent versions of the OS running on the server and the OS that you are trying to add. This error message occurs when the installed version of the OS has packages that were previously patched, and the OS services being added do not have those packages patched, because the patches have been integrated into the packages.

For example, you might have a server that is running the current Solaris release or the Solaris 10 release. You might also have additional OS services loaded on this server, including the Solaris 9 SPARC sun-4m OS services that have been patched. If you try to add the Solaris 8 SPARC sun-4u OS services from a CD-ROM to this server, you could get the following error message:

Error: inconsistent revision, installed package appears to have been 
patched resulting in it being different than the package on your media. 
You will need to backout all patches that patch this package before 
retrying the add OS service option.

Disk Space Requirements for OS Servers

Before you set up your diskless client environment, ensure that you have the required disk space available for each diskless client directory.

In previous Solaris releases, you were prompted about diskless client support during the installation process. Starting with the Solaris 9 release, you must manually allocate an /export file system either during installation or create it after installation. See the following table for specific disk space requirements.

Table 6-7 Disk Space Recommendations for Solaris OS Servers and Diskless Clients

Server OS/Architecture Type	Directory	Required Disk Space
Solaris Express and Solaris 10 SPARC based OS server	`/export`	5 to 6.8 Gbytes
Solaris Express and Solaris 10 x86 based OS server	`/export`	5 to 6.8 Gbytes
Solaris Express and Solaris 10 SPARC based diskless client	`/export`	Reserve 200 to 300 Mbytes per diskless client.
Solaris Express and Solaris 10 x86 based diskless client	`/export`	Reserve 200 to 300 Mbytes per diskless client.

Note - Disk space recommendations can vary, depending on the Solaris release that is installed. For specific information about the disk space recommendations in the current Solaris release, see Disk Space Recommendations for Software Groups in Solaris Express Installation Guide: Planning for Installation and Upgrade.