Skip Navigation Links | |
Exit Print View | |
Oracle Solaris 11 Express Automated Installer Guide Oracle Solaris 11 Express 11/10 |
1. Automated Installer Overview
2. Setting Up an AI Install Server
AI Server Hardware Requirements
AI Server Software Requirements
Set Up the Install Image and Install Service
Identify Space for Your AI Image Files
Install the AI Installation Tools
How to Set Up an AI Boot Image
Create an Install Service Without DHCP Setup
Create an Install Service Including Oracle Solaris DHCP Setup
Review the Default Installation Instructions
Add or Delete an Install Service
Enable or Disable an Install Service
Associate Clients With Install Services
Add a Client To an Install Service
Delete a Client From an Install Service
Associate Client-Specific Installation Instructions With Install Services
Modify Criteria for an Installation Instructions Manifest
Delete an Installation Instructions Manifest
Show Information About Install Services
List All Install Services on the Install Server
Show Information for a Specified Install Service
List Clients Associated With Install Services
List Clients Associated With a Specific Install Service
Show Information About Customized Installations
4. Specifying Installation Instructions
5. Configuring the Client System
8. Automated Installations That Boot From Media
A. Troubleshooting Automated Installations
After you have set up an AI install server, you might want to perform some of the following tasks. See also the installadm(1M) man page.
You need one install service for each AI boot image you want to use. You can create more than one install service associated with the same boot image. To create an install service, use the installadm create-service command as described in Create an AI Install Service.
Use the following command to delete an install service:
# installadm delete-service [-x] svcname
The svcname is the name of the service to delete. If you specify the -x option, then the associated install image is also deleted.
When you delete an install service, the associated DHCP macros remain in the DHCP table. The output of the installadm delete-service command tells you which DHCP macros to remove.
Use the following command to enable an install service.
# installadm enable svcname
The svcname is the name of the service to enable. This command also enables the web server associated with the service.
Use the following command to disable an install service.
# installadm disable svcname
This command also disables the web server associated with the service.
The installadm create-client command tells a client exactly which install service to use. See Setting Up an Install Client for more examples and sample output.
Use the installadm create-client command to associate a client with an install service. The following command adds the client with MAC address 00:14:4f:a7:65:70 to the s11-sparc install service.
# installadm create-client -e 00:14:4f:a7:65:70 -n s11-sparc
The following example adds an x86 client and redirects installation output to a serial console.
# installadm create-client -e c0ffeec0ffee -n s11-x86 -b 'console=ttya'
A client can be associated with only one install service. If you run the installadm create-client command more than once and specify the same MAC address each time, that client is associated only with the install service that was specified last.
Use the installadm delete-client command to delete a client from an install service. The following command deletes the client with MAC address 00:14:4f:a7:65:70. You do not need to specify the service name since a client can be associated with only one install service.
# installadm delete-client -e 00:14:4f:a7:65:70
You can specify multiple sets of installation and system configuration instructions for each install service, and you can specify which instruction set to use for each client. All of this information is associated with the install service.
Use the installadm add-manifest command to add a custom AI manifest to an install service.
# installadm add-manifest -m manifest -n service_name \ [-c criteria="value"|"range" ... \ | -C criteria_file]
The value of manifest is a full path and file name with .xml extension. The manifest file contains an AI manifest (installation instructions). The manifest file can also reference or embed an SC manifest (system configuration instructions).
To specify criteria to determine which clients should use the instructions in the specified manifest file, use the -c or -C option. The value of criteria_file is a full path and file name. Example criteria files are shown below and in Chapter 3, Customizing Installations.
If you replace the default.xml manifest for a service, do not specify client criteria. The default AI manifest is used to install all clients that do not match any custom manifest. See Review the Default Installation Instructions.
For all other AI manifests that you add, either the -c or the -C option is required. Only the default AI manifest has no associated client criteria. All other AI manifests are custom AI manifests for specified clients or groups of clients.
The following command adds the manifest_t200.xml manifest to the s11-sparc install service. The -c option specifies that any clients that are using this install service and identify themselves as Sun Fire T200 servers are assigned the manifest_t200.xml installation and configuration instructions.
# installadm add-manifest -m /rpool/ai/s11_sparc/manifests/manifest_t200.xml \ -n s11-sparc -c platform="SUNW,Sun-Fire-T200"
The following command is equivalent to the preceding command if the content of the criteria_t200.xml file is as shown.
# installadm add-manifest -m /rpool/ai/s11_sparc/manifests/manifest_t200.xml \ -n s11-sparc -C /rpool/ai/s11_sparc/manifests/criteria_t200.xml
Following is the content of the criteria_t200.xml file.
<ai_criteria_manifest> <ai_criteria name="platform"> <value>SUNW,Sun-Fire-T200</value> </ai_criteria> </ai_criteria_manifest>
The installadm add-manifest command verifies that criteria of the same type do not overlap. For example, if one criteria specification matches IP addresses from 10.0.0.0 to 10.255.255.255, installadm exits with an error if you try to add a criteria specification that matches IP address 10.10.10.10. For more information about criteria specifications, see Chapter 3, Customizing Installations.
Use the installadm set-criteria command to update the client criteria associated with an AI manifest that you already added to a service using installadm add-manifest.
Use installadm set-criteria with the -a option to add more criteria for using the specified manifest. The current criteria are retained, and the new criteria are added.
Use installadm set-criteria with the -c or -C option to overwrite the criteria for using the specified manifest. The current criteria are removed and replaced by the new criteria.
# installadm set-criteria -m manifest -n service_name \ -a criteria="value" | "range" ... \ | -c criteria="value"|"range" ... \ | -C criteria.xml
The value of manifest is the manifest name that the installadm list -m command returns. See List All Manifests.
The following command adds criteria to the manifest_t200.xml manifest from Add an AI Manifest.
# installadm set-criteria -m manifest_t200.xml -n s11-sparc -a mem="4096-unbounded"
The result of the two commands is that the manifest_t200.xml manifest is used by any client that is using this install service that is a Sun Fire T200 server and that has at least 4 Gbytes of memory.
You could achieve this same result by using the -C option instead of the -a option with the following criteria_t200.xml file.
<ai_criteria_manifest> <ai_criteria name="platform"> <value>SUNW,Sun-Fire-T200</value> </ai_criteria> <ai_criteria name="mem"> <range> 4096 unbounded </range> </ai_criteria> </ai_criteria_manifest>
Use the installadm delete-manifest command to remove an AI manifest from an install service. The value of manifest is the manifest name that the installadm list -m command returns. See List All Manifests.
You cannot delete the default AI manifest.
The following command removes the manifest_mac1.xml AI manifest from the s11-sparc install service.
# installadm delete-manifest -m manifest_mac1.xml -n s11-sparc
Use the installadm list command to show information about install services.
The following command displays all of the install services on this server. In this example, two enabled install services are found. (Disabled services have a Status value of off.)
# installadm list Service Name Status Arch Port Image Path ------------ ------ ---- ---- ---------- s11-sparc on sparc 46501 /rpool/ai/s11_sparc/target s11-x86 on x86 46502 /rpool/ai/s11_x86/target
The following command displays information about the install service specified by the -n option:
# installadm list -n s11-sparc Service Name Status Arch Port Image Path ------------ ------ ---- ---- ---------- s11-sparc on sparc 46501 /rpool/ai/s11_sparc/target
The following command lists all the clients that are associated with the install services on this install server. The clients were associated with the install services by using the installadm create-client command. See Add a Client To an Install Service.
# installadm list -c Service Name Client Address Arch Image Path ------------ -------------- ---- ---------- s11-sparc 00:14:4F:A7:65:70 sparc /rpool/ai/s11_sparc/target s11-x86 08:00:27:8B:BD:71 x86 /rpool/ai/s11_x86/target 01:C2:52:E6:4B:E0 x86 /rpool/ai/s11_x86/target
The following command lists all the clients that have been added to the specified install service. In the following example, one client is associated with the s11-sparc install service.
# installadm list -c -n s11-sparc Service Name Client Address Arch Image Path ------------ -------------- ---- ---------- s11-sparc 00:14:4f:a7:65:70 sparc /rpool/ai/s11_sparc/target
The commands in this section show which AI manifests are associated with a particular install service. These commands also show which client criteria are associated with each AI manifest. See the installadm add-manifest and installadm set-criteria commands in Associate Client-Specific Installation Instructions With Install Services.
The following command lists all custom AI manifests for all install services on this install server. The default AI manifest is not listed. If an install service has no associated custom AI manifests, then that service is not shown in this list.
The Manifest column displays the name of the manifest from the name attribute of the <ai_instance> tag. In this example, all custom AI manifests are displayed for two install services, s11-sparc and s11-x86.
# installadm list -m Service Name Manifest ------------ -------- s11-sparc manifest_mac1.xml manifest_t200.xml s11-x86 manifest_mac2.xml manifest_mac3.xml manifest_ipv41.xml manifest_ipv42.xml manifest_mem1.xml
The following example shows all custom AI manifests associated with the install service s11-x86. The Manifest column displays the name of the manifest from the name attribute of the <ai_instance> tag. The Criteria column shows the client criteria that are associated with each manifest.
# installadm list -m -n s11-x86 Manifest Criteria -------- -------- manifest_mac2.xml arch = i86pc mac = 01:C2:52:E6:4B:E0 manifest_mac3.xml arch = i86pc mac = 01:C2:52:E6:4B:E6 - 01:C2:52:E6:4B:E9 manifest_ipv41.xml arch = i86pc ipv4 = 192.168.168.12 manifest_ipv42.xml arch = i86pc ipv4 = 192.168.168.251 manifest_mem1.xml arch = i86pc mem = 2048 MB
On the AI server, the SMF service svc:/system/install/server:default is the service that represents the overall state of the AI server application and all install services. This SMF service contains the data specific to each install service.
Example 2-1 Enabling the AI SMF Service
The AI SMF service is enabled when you run the installadm create-service command. The AI SMF service also is enabled when you run any other installadm command that affects existing install services. To manually enable the AI SMF service, run the following command:
# svcadm enable svc:/system/install/server:default
The AI SMF service goes into maintenance mode if no install services are currently enabled on the install server.
Example 2-2 Disabling the AI SMF Service
To disable the AI SMF service, run the following command:
# svcadm disable svc:/system/install/server:default
Do not disable the AI SMF service if any AI install service is still enabled. See List All Install Services on the Install Server for information about how to see whether any install services are enabled.