Sun N1 Service Provisioning System User's Guide for OS Provisioning Plug-In 3.1

Chapter 9 Target Hosts for OS Provisioning

When you provision the operating system, you have to know something about the hardware that you are provisioning. To simplify this process, the OS provisioning plug-in provides a set of target host definitions. The OS provisioning plug-in uses this information to remotely manage the target servers and perform functions such as power off, power on, getting console capability, and setting boot mode of the target.

This chapter explains the types of target hosts that you can easily provision and provides several detailed examples. The chapter contains the following information:

Target Host Types

Different mechanisms are used to remotely manage different hardware types. As a result, you need to know some specific information before you can effectively configure the operating system for that kind of hardware. The OS provisioning plug-in provides the following hardware groups for you to use for your OS provisioning targets:

Each target host type has a specific set of variables that apply to that host type. For detailed information about the variables that apply to each target host type, see Appendix A, Target Host Variables.

As an alternate means to IP connectivity, the OS Provisioning Plug-In supports the use of the Cisco Terminal Server 2621 series and Cyclades Alterpath ACS Terminal Server series terminal server or concentrator types to connect to the Network Management controllers. In the variable set for your target host, you can specify a terminal server for the target host to use. For more information about terminal server support and the variables for these terminal servers, see Terminal Server Support.

Target Host Types by Platform

The following table lists some of the platforms and targets that the OS provisioning plug-in supports. For each hardware platform, the table shows the following information:

Table 9–1 Target Hosts by Platform

Target Platform  

Firmware or Service Processor  

Configuration Requirements  

Information Needed for OS Provisioning Target Variables 

Target Host Type 

SunFire x4100, x4200 family 

SP version 6464 

  • Provide IP (static) to Network Management port (routable from OS provisioning server)

  • Service Processor IP

  • ssh user/password

  • ipmi user/password

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface

Sun IPMI target  

SunFire x2100 family 

SP v4.11 

  • Provide IP (static) to Network Management port (routable from OS provisioning server)

  • Service Processor IP

  • ipmi user/password

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface

Sun IPMI target  

SunFire v480, v880 family 

 

RSC 2.2.3, RSCboot 

  • Provide IP (static) to RSC port (routable from OS provisioning server) or connect RSC serial port to terminal server (Terminal server IP should be routable from OS provisioning server)

  • Enable Telnet (for IP-based managment)

  • RSC IP, or terminal server information (ip, type, port connected to RSC serial port)

  • RSC user/password

  • MAC address of target provisioning interface

Sun RSC target  

SunFire v240, v210 family 

SunFire T1000, T2000 family 

Sun Advanced Lights Out Manager 1.3 (ALOM)  

  • Provide IP (static) to ALOM port (routable from OS provisioning server) or connect ALOM serial port to terminal server (Terminal server IP should be routable from OS provisioning server)

  • Enable Telnet (for IP-based management)

  • SunFire T1000/T2000 only: Set OBP diag-switch? variable to false

  • ALOM IP, or terminal server information (ip, type, port connected to ALOM serial port)

  • ALOM user/password

  • MAC address of target provisioning interface

Sun ALOM target  

SunFire v120 family  

Sun Lights Out Manager version: v3.12 (LOM)  

  • Connect LOM port to terminal server (Terminal server IP should be routable from OS provisioning server)

  • To share Serial A/LOM between the LOM and the Console, setup console connections to both the Serial A/LOM and the Serial B port

    For example, from the Solaris command line:


    eeprom input-device=ttya
           eeprom output-device=ttya
           reboot
  • LOM user/password (if any)

  • MAC address of the target provisioning interface

  • Terminal server information (type, ip, port connected to Target LOM port)

Sun LOM target  

SunFire v20z, v40z family  

Sun IPMI v1.5 Service Processor, Version V2.1.0.10  

  • Provide IP (static) to Network Management port (routable from OS provisioning server)

  • Enable ssh

  • Enable ipmi, ipmi channel “lan”

  • Service Processor IP

  • ssh user/password

  • ipmi password

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface

Sun IPMI target  

SunFire B100s (sparc), B100x (x86) family  

Sun Advanced Lights Out Manager for Blade Servers 1.2 (ALOM-B 1.2) 

  • Provide IP (static) to ALOM port (routable from OS provisioning server) or connect ALOM serial port to terminal server (Terminal server IP should be routable from OS provisioning server)

  • Enable Telnet (for IP-based managment)

  • ALOM IP, or terminal server information (ip, type, port connected to ALOM serial port)

  • ALOM user/password

  • MAC address of target provisioning interface

  • GUID of the provisioning interface (for B100x only)

Other Remotely Managed Target using b1600sc.jar as the Network Management HAL jar power, boot, and console services are all supported by this HAL

SunFire v60x, v65x family  

IPMI-enabled Baseboard Management Controller (BMC)  

  • Provide IP (static) to IPMI port (routable from OS provisioning server)

  • Enable ipmi, ipmi channel “lan”

  • Configure BIOS to boot from PXE-enabled NICs first

  • IPMI IP ipmi password

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface

Other IPMI target using ipmi.jar as the Network Management HAL jar only power, service is supported by this HAL

SunFire 3800, 4800 or 6800 domain  

System Controller: 

ScApp version: 5.18.1 

Build_01 RTOS version: 41  

  • Provide IP (static) to System Controller (routable from OS provisioning server)

  • Enable telnet

  • Platform SC IP address, user ID, and password

  • Domain name, user ID and password

  • MAC address of the target provisioning interface

Sun Mid Range Target  

HP Proliant DL Series (supporting iLO-based managment) 

iLO Integrated Lights Out Manager v 1.6.41  

  • Provide IP (static) to iLO port (routable from OS provisioning server)

  • Configure BIOS to boot from PXE-enabled NICs first

  • iLO ip, user/password

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface

HP iLO Target 

Other Targets 

-  

Configure BIOS to boot from PXE-enabled NICs first (x86 only)  

  • MAC address of the target provisioning interface

  • GUID of the provisioning interface (x86 only)

Generic Target (manual control)  

Example Tasks for Defining Target Hosts

The general process that you follow to define a target host is similar for all target host types. However, the details differ for each type. This section contains sample tasks for some, but not all, target host types.

Defining a Sun ALOM Target Host

Before you can install the image onto a system, often referred to as provisioning, you must inform the OS provisioning server about that system.

ProcedureHow to Create a Sun ALOM Target Host (Browser Interface)

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the Sun ALOM section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the SunALOM component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the SunALOM component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Verify variable values and change them, if needed.

        If you need more information that is provided by the prompts in the component variables table, see the detailed list of variables, along with default values and examples, in Sun ALOM Target Host Variables.

      4. Decide whether to enter passwords in the variables set or in the plan prompts.

        There are two methods for entering the passwords:

        • Type appropriate values in the following variables:

          alom_access_userid

          alom_access_password

          terminal_server_userid

          terminal_server_password

          For information about encrypting the passwords, see Password Encryption.

        • Leave the component variables blank and enter the password in the plan prompts provided in the Plan Details Run page.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the SunALOM component row of the Plan Parameters table.

  5. From the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. To encrypt the passwords from the plan, follow these steps on the Plan Details Run page.

    1. Click the checkbox next to “If you are specifying the ALOM password below.”

    2. Type the password in the Password to Access ALOM field.

      The password encrypts as you type.

    3. If the system is connected to a terminal server, click the checkbox next to “If you are specifying the terminal server password below.”

    4. Type the terminal server password in the Terminal Server Password field.

      The password encrypts as you type.

  7. Click Run Plan (includes preflight).

  8. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host test240, the virtual host is test240-target.

ProcedureHow to Create a Sun ALOM Target Host (Command-Line Interface)

Steps
  1. To create a variable set for the SunALOM component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/SunALOM  \
    -name "testv240" -u admin -p admin -vars "installPath=testv240; \
    description=To test v240;ethernet_mac_address=0:3:ba:53:5b:5d; \
    ethernet_ip_address=10.42.42.100;ethernet_netmask=255.255.255.0;architecture=sun4u; \
    kernel_arch=sun4u;disk_size=20GB;alom_ip_address=10.5.133.150;alom_access_userid=admin; \
    alom_access_password="
    

    For more information about the variables, see Sun ALOM Target Host Variables.

  2. To set up the appropriate password access, create a file that contains the following entries:

    true
    root       
    true
    root

    Where:

    • The first line in the file corresponds to checking the “If you are specifying the ALOM password below” box in the plan variables section of the browser interface.

    • The second line in the file is the password to access ALOM.

    • The third line in the file corresponds to checking the “If you are specifying the terminal password below” box in the plan variables section of the browser interface.

    • The fourth line in the file is the password to access the terminal.

    Make sure to name the file something useful so that you can remember it for the next step. For example, you might name the file /tmp/testv240-target.

  3. To run the plan and create the target, type a command similar to the following example:


    # cr_cli -cmd pe.p.run -u admin -p admin \
    -PID NM:/com/sun/n1osp/targets/SunALOM-create -tar H:NM:masterserver-osp \
    -comp + -vs testv240 -pto 30 -nto 10 -f /tmp/testv240-target
    

Defining a Sun IPMI Target Host

The Sun IPMI target host type is used for several system families, including the Sun FireTM x2100, x4100, x4200, and V20z,systems.

ProcedureHow to Create a Sun IPMI Target Host (Browser Interface)

For this task, the target host is a Sun Intelligent Platform Management Interface (IPMI) system. Specifically, the example defines a x2100 target host.

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the Sun IPMI Targets sub-section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the SunIPMI component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the SunIPMI component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Verify variables and change them, if needed.

        The prompts in the component variables table are mostly self-explanatory. However, if you need more information, see the detailed list of variables, along with default values and examples in Sun IPMI Target Host Variables.

      4. Decide whether to enter passwords in the variables set or in the plan prompts.

        There are two methods for entering the passwords:

        • Type appropriate values in the following variables:

          ipmi_access_userid

          ipmi_access_password

          ssh_access_userid

          ssh_access_password

          For information about encrypting the passwords, see Password Encryption.

        • Leave the component variables blank and enter the password in the plan prompts provided in the plan run page.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the SunIPMI component row of the Plan Parameters table.

  5. From the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. To encrypt the password from the plan, follow these steps on the Plan Details Run page.

    1. Click the checkbox next to “If you are specifying the IPMI password below.”

    2. Type the password in the Password to Access IPMI field.

      The password encrypts as you type.

    3. Click the checkbox next to “If you are specifying the SSH password below.”

    4. Type the password in the SSH Password to Access the Remote Management Interface field.

      The password encrypts as you type.

  7. Click Run Plan (includes preflight).

  8. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host sunfire-x2100, the virtual host is sunfire-x2100-target.

ProcedureHow to Create a Sun IPMI Target Host (Command-Line Interface)

Steps
  1. To create a variable set for the SunIPMI component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/SunIPMI -name "x2100" \
    -u admin -p admin -vars "installPath=x2100host;description=test x2100 host; \
    device_type=sunfirex2100;ethernet_mac_address=00:09:3d:10:94:a6;ethernet_ip_address=10.42.42.110; \
    ethernet_netmask=255.255.255.0;architecture=x86;kernel_arch=i86pc; \
    guid={3AE45192-159D-11D8-AEF3-001083FDFE90};disk_size=20GB;ipmi_ip_address=10.5.133.134; \
    ipmi_access_userid;ipmi_access_password=;ssh_access_userid=admin;ssh_access_password= \
    console_service=false"
    

    For more information about the variables, see Sun IPMI Target Host Variables.

  2. To set up the appropriate password access, create a file that contains the following entries:

    true
    admin
    true
    admin

    Where:

    • The first line in the file corresponds to checking the “If you are specifying the IPMI password below” box in plan variables section of the browser interface.

    • The second line in the file is the password to access IPMI.

    • The third line in the file corresponds to checking the “If you are specifying the SSH password below” box in plan variables section of the browser interface.

    • The fourth line in the file is the SSH password to access the remote management interface.

    Make sure to name the file something useful so that you can remember it for the next step. For example, you might name the file /tmp/testv20z-target.

  3. To run the plan and create the Sun IPMI target, type a command similar to the following example:


    # cr_cli -cmd pe.p.run -u admin -p admin \
    -PID NM:/com/sun/n1osp/targets/SunIPMI-create -tar H:NM:masterserver-osp \
    -comp + -vs x2100 -pto 30 -nto 10 -f /tmp/test-x2100
    

    The previous example applies to the Sun Fire x2100.

Defining a Sun RSC Target Host

The Sun RSC target host type is used for systems such as a Sun FireTM v490 or v890 system.

ProcedureHow to Create a Sun RSC Target Host (Browser Interface)

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the Sun RSC Targets section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the SunRSC component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the SunRSC component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Verify variable values and change them, if needed.

        If you need more information that is provided by the prompts in the component variables table, see the detailed list of variables, along with default values and examples, in Sun RSC Target Host Variables.

      4. Decide whether to enter passwords in the variables set or in the plan prompts.

        There are two methods for entering the passwords:

        • Type appropriate values in the following variables:

          rsc_access_userid

          rsc_access_password

          terminal_server_userid

          terminal_server_password

          For information about encrypting the passwords, see Password Encryption.

        • Leave the component variables blank and enter the password in the plan prompts provided in the Plan Details Run page.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the SunRSC component row of the Plan Parameters table.

  5. From the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. To encrypt the passwords from the plan, follow these steps on the Plan Details Run page.

    1. Click the checkbox next to “If you are specifying the RSC password below.”

    2. Type the password in the Password to Access RSC field.

      The password encrypts as you type.

    3. Click the checkbox next to “If you are specifying the terminal server password below.”

    4. Type the terminal server password in the Terminal Server Password field.

      The password encrypts as you type.

  7. Click Run Plan (includes preflight).

  8. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host test490, the virtual host is test490-target.

ProcedureHow to Create a Sun RSC Target Host (Command-Line Interface)

Steps
  1. To create a variable set for the SunRSC component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/SunRSC  \
    -name "testv490" -u admin -p admin -vars "installPath=testv490; \
    description=To test v490;ethernet_mac_address=0:3:ba:53:5b:5d; \
    ethernet_ip_address=10.42.42.100;ethernet_netmask=255.255.255.0;architecture=sun4u; \
    kernel_arch=sun4u;disk_size=20GB;rsc_ip_address=10.5.133.150;rsc_access_userid=admin; \
    rsc_access_password="
    

    For more information about the variables, see Sun RSC Target Host Variables.

  2. To set up the appropriate password access, create a file that contains the following entries:

    true
    root       
    false
    root

    Where:

    • The first line in the file corresponds to checking the “If you are specifying the RSC password below” box in the plan variables section of the browser interface.

    • The second line in the file is the password to access RSC.

    • The third line in the file corresponds to checking the “If you are specifying the terminal password below” box in the plan variables section of the browser interface.

    • The fourth line in the file is the password to access the terminal.

    Make sure to name the file something useful so that you can remember it for the next step. For example, you might name the file /tmp/testv490-target.

  3. To run the plan and create the target, type a command similar to the following example:


    # cat /tmp/RSC-target | cr_cli -cmd pe.p.run -u admin -p admin \
    -PID NM:/com/sun/n1osp/targets/SunRSC-create -tar H:NM:masterserver-osp \
    -comp + -vs testv490 -pto 30 -nto 10 -f /tmp/testv490-target
    

Defining an HP ILO Target Host

The following tasks show how to define an HP ILO host, for example an HP ProLiant series system.

ProcedureHow to Create an HP ILO Target Host (Browser Interface)

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the HP ILO Targets sub-section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the HPILO component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the HPILO component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Verify variables and change them, if needed.

        The prompts in the component variables table are mostly self-explanatory. However, if you need more information, see the detailed list of variables, along with default values and examples in HP ILO Target Host Variables.

      4. Decide whether to provide passwords in the variables set or in the plan prompts.

        There are two methods for providing the passwords:

        • Type appropriate encrypted values in the following variables:

          ilo_access_userid

          ilo_access_password

          For information about encrypting the passwords, see Password Encryption.

        • Leave the component variables blank and enter the password in the plan prompts provided in the plan run page.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the HPILO component row of the Plan Parameters table.

  5. On the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. To encrypt the password from the plan, follow these steps on the Plan Details Run page.

    1. Click the checkbox next to “If you are specifying the ILO password below.”

    2. Type the password in the Password to Access ILO field.

      The password encrypts as you type.

  7. Click Run Plan (includes preflight).

  8. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host hp-proliant-1, the virtual host is hp-proliant-1-target.

ProcedureHow to Create an HP ILO Target Host (Command-Line Interface)

Steps
  1. To create a variable set for the HPILO component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/HPILO -name "hpProliant" \
    -u admin -p admin -vars "installPath=HP-Proliant;description=Test description; \
    ethernet_mac_address=00:0E:7F:FD:85:26;ethernet_ip_address=10.42.42.20; \
    ethernet_netmask=255.255.255.0;architecture=x86;kernel_arch=i86pc; \
    guid={4D303435-4C47-5037-3239-202020202020};disk_size=20GB;ilo_ip_address=10.5.133.166; \
    ilo_version=1.6.4;ilo_access_userid=admin;ilo_access_password="
    

    For more information about the variables, see HP ILO Target Host Variables.

  2. To set up the appropriate password access, create a file that contains the following entries:

    true
    admin123

    Where:

    • The first line in the file corresponds to checking the “If you are specifying the ILO password below” box in plan variables section of the browser interface.

    • The second line in the file is the password to access ILO.

    Make sure to name the file something useful so that you can remember it for the next step. For example, you might name the file /tmp/hp-proliant.

  3. To run the plan and create the target host, type a command similar to the following example:


    # cat /tmp/hp-proliant | cr_cli -cmd pe.p.run -u admin -p admin  \
    -PID NM:/com/sun/n1osp/targets/HPILO-create -tar H:NM:masterserver-osp -comp + \
    -vs hpProliant -pto 30 -nto 10 -f /tmp/hp-proliant
    

Defining an Other Remotely-Managed Target Host

Use the remotely-managed target host type to identify target hosts that do not match any of the predefined types but that have other forms of remote management, such as SunFire B100s and B100x blades. The option provides the greatest flexibility of providing information regarding a target but also requires several variables to be filled.

There are two sets of remote management information gathered for this type of target. The first set of remote management information ends with _1 suffix, and the second set ends with the _2 suffix. Each remote network management information set requires information about the type of network management and the associated hardware abstraction layer (HAL) JAR file that handles the remote network management capabilities. The HAL JAR files are located at /opt/SUNWn1osp/drivers on the OS provisioning server. You need to be aware of the services, such as power, boot and console, that is supported by each HAL JAR file. For example, the b1600sc.jar file includes support for power, boot, and console services for the Sun Fire B100s and B100x Blade series. Before you populate the variable sets for the remotely-managed host type, ensure that you are familiar with these services and the HAL JARs that support these services.

Each remote network management interface can have a terminal server connection, in which case the information about the terminal server also has to be entered. Depending on the type of network management, the network management might support power management, boot mode, and console support.

ProcedureHow to Create an Other Remotely-Managed Target Host (Browser Interface)

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the Other Remotely-Managed Targets sub-section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the Other component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the Other component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Verify variables and change them, if needed.

        The prompts in the component variables table are mostly self-explanatory. However, if you need more information, see the detailed list of variables, along with default values and examples in Other Remotely-Managed Target Host Variables.

      4. Decide whether to provide passwords in the variables set or in the plan prompts.

        There are two methods for providing the passwords:

        • Type appropriate encrypted values in the following variables:

          netmgmt_password_1

          terminal_server_access_password_1

          netmgmt_password_2

          terminal_server_access_password_2

          For information about encrypting the passwords, see Password Encryption.

        • Leave the component variables blank and enter the password in the plan prompts provided in the plan run page.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the Other component row of the Plan Parameters table.

  5. From the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. To encrypt the password from the plan, follow these steps on the Plan Details Run page.

    1. Click the checkbox next to the first “If you are specifying the password below.”

    2. Type the password to access the first network management interface in the Password to Access Management Interface 1 field.

      The password encrypts as you type.

    3. Click the checkbox next to the first “If you are specifying the terminal server password below.”

    4. Type the password to access the first terminal server in the Password to Access Terminal Server Password 1 field.

      The password encrypts as you type.

    5. Click the checkbox next to the second “If you are specifying the password below.”

    6. Type the password to access the second network management interface in the Password to Access Management Interface 2 field.

      The password encrypts as you type.

    7. Click the checkbox next to the second “If you are specifying the terminal server password below.”

    8. Type the password to access the second terminal server in the Password to Access Terminal Server Password 2 field.

      The password encrypts as you type.

  7. Click Run Plan (includes preflight).

  8. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host sunfire-b100s-1, the virtual host is sunfire-b100s-1-target.

ProcedureHow to Create an Other Remotely-Managed Target Host (Command-Line Interface)

The following CLI example creates a target host for a SunFire B100s system.

Steps
  1. To create a variable set for the Other component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/Other -name "b100s10" \
    -u admin -p admin -vars "installPath=Blade-S10;description=S10 b100s blade target; \
    ethernet_mac_address=00:03:ba:29:e4:ea;ethernet_ip_address=10.216.0.11; \
    ethernet_netmask=255.255.255.192;architecture=sun4u;kernel_arch=sun4u;disk_size=30GB; \
    netmgmt_type_1=b1600sc;netmgmt_version_1=1.0; \
    netmgmt_hal_jar_1="file:///opt/SUNWn1osp/drivers/sun/b1600sc.jar"; \
    netmgmt_ip_address_1=10.216.0.60;netmgmt_protocol_1=telnet;netmgmt_port_1=s10; \
    power_service_true_false_1=true;boot_service_true_false_1=true; \
    console_service_true_false_1=true;netmgmt_userid_1=admin;netmgmt_password_1=Clz6pK2b6qw="
    

    For more information about the variables, see Other Remotely-Managed Target Host Variables.

  2. To set up the appropriate password access, create a file that contains the following entries:

    false
    admin
    false
    admin
    false
    admin
    false
    admin

    Where:

    • The first line in the file corresponds to the first “If you are specifying the password below” box in the plan variables section of the browser interface.

    • The second line in the file is the password to the first management interface.

    • The third line in the file corresponds to the first “If you are specifying the terminal server password below” box in the plan variables section of the browser interface.

    • The fourth line in the file is the password to the first terminal server..

    • The fifth line in the file corresponds to the second “If you are specifying the password below” box in the plan variables section of the browser interface.

    • The sixth line in the file is the password to the second management interface.

    • The seventh line in the file corresponds to the second “If you are specifying the terminal server password below” box in the plan variables section of the browser interface.

    • The eighth line in the file is the password to the second terminal server..

    Make sure to name the file something useful so that you can remember it for the next step. For example, you might name the file /tmp/b100s.

  3. To run the plan and create the target host, type a command similar to the following example:


    # cat /tmp/b100s | cr_cli -cmd pe.p.run -u admin -p admin \
    -PID NM:/com/sun/n1osp/targets/Other-create -tar H:NM:masterserver-osp -comp + \
    -vs b100s10 -pto 30 -nto 10 -f /tmp/b100s
    

Defining a Generic Target Host

You can manually power off and power on targets that do not have any remote management interfaces, such as workstations or desktop systems. To identify these targets for OS provisioning, use the Generic Target Host option.

ProcedureHow to Create a Generic Target Host (Browser Interface)

Steps
  1. In the Common Tasks section of the N1 SPS browser interface, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create in the Generic Targets sub-section of the Target Hosts section.

  3. On the Plans Details page, click Run.

  4. Choose variables to use for this plan.

    • To use an existing variables set, select a name from the drop-down menu in the Target component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the Target component row of the Plan Parameters table.

      1. Click Create Set.

      2. Type a name for the variables set.

      3. Determine whether to call the OSP Control Service.

        For a generic target host, pay special attention to the osp_control_service variable. If you set this variable to TRUE and the system has a manual HAL, the N1 SPS software stops and waits for you to perform the appropriate function. If you monitor the status of the installation through the status feature, the OS provisioning control service lets you know when to power off and power on the target host.

        If the target host is on a private network and has no access to DHCP services, set this variable to FALSE.

      4. Verify other variables and change them, if needed.

        The other prompts in the component variables table are mostly self-explanatory. However, if you need more information, see the detailed list of variables, along with default values and examples in Generic Target Host Variables.

      5. Save the variables set.

      6. Select the variables set that you just saved from the drop-down menu in the Target component row of the Plan Parameters table.

  5. On the Plan Details Run page, select the provisioning server on which to define the target host.


    Tip –

    The host name of the OS provisioning server ends in -osp.


  6. Click Run Plan (includes preflight).

  7. To verify that the target host is created successfully, click the Hosts link in the left side of the N1 SPS browser interface.

    You should see the name of the virtual host appended with -target. For example, if you defined a provisioning target for host sunfire-v60x, the virtual host is sunfire-v60x-target.

ProcedureHow to Create a Generic Target Host (Command-Line Interface)

Steps
  1. To create a variable set for the Target component, type a command similar to the following example:


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/targets/Target -name "mysystem" \
    -u admin -p admin -vars "installPath=Generic;target_host=:[installPath]-target; \
    description=Test description;ethernet_mac_address=00:0E:7F:FD:85:26; \
    ethernet_ip_address=10.42.42.20;ethernet_netmask=255.255.255.0;architecture=x86; \
    kernel_arch=i86pc;disk_size=20GB"
    

    For more information about the variables, see Generic Target Host Variables.

  2. To run the plan and create the target host, type a command similar to the following example:


    # cr_cli -cmd pe.p.run -u admin -p admin  -PID \
    NM:/com/sun/n1osp/targets/Target-create -tar H:NM:masterserver-osp -comp + \
    -vs mysystem -pto 30 -nto 10
    

Password Encryption

To provide a password for root access on a Solaris or Linux system, you need to use the operating system tools, rather than the OS provisioning tools, to encrypt the password.

Encrypting Passwords for OS Provisioning Variables

There are 3 ways to encrypt the password for OS provisioning variables:

Encrypting Passwords for OS Root Access

If you need to provide a password for root access on a Solaris or Linux system, you need to use the operating system tools, rather than the OS provisioning tools, to encrypt the password.

Tools differ by operating system and by specific version of the operating system. On a Solaris 9 system, for example, most users would simply copy the root password from the /etc/shadow file. Consult your operating system documentation for more information.

Terminal Server Support

As an alternate means to IP connectivity, the OS Provisioning Plug-In supports the use of the following terminal server or concentrator types to connect to the Network Management controllers.

The OS Provisioning Plug-In supports the telnet protocol (for Cisco Terminal Server 2621) and SSH protocol (for Cyclades Alterpath ACS Terminal Server) as the access protocols for these terminal servers/concentrators. See the vendor specific documentation for the technical specifications and setup instructions for these terminal servers.

In the OS Provisioning Plug-In, the Cisco 2621 is the default terminal server binding for the server network management controllers. To use the Cyclades Alterpath ACS terminal server, edit the appropriate terminal server variables for your target hosts. Table 9–2 lists the terminal server variables and the values for both the Cisco 2621 and Cyclades Alterpath ACS terminal servers.

Table 9–2 Terminal Server Variables and Values

Variable (Description) 

Cisco 2621 Variable Value 

Cyclades Alterpath Variable Value 

terminal_server_type (Terminal server type)

Cisco2621

cyclades

terminal_server_hal_jar (Terminal server hal jar )

file://:[targetableComponent:installPath]/SUNWn1osp/drivers/cisco/c2621.jar

file://:[targetableComponent:installPath]/SUNWn1osp/drivers/cyclades/cycladesTS.jar

terminal_server_port (Port of terminal server)

Port values of 2032 and above 

Port values of 7000 and above 

terminal_server_protocol (Terminal server access protocol)

telnet (ssh is not supported)

ssh (telnet is not supported)

In addition, you must provide values for the following variables to enable your target hosts to use terminal servers.

terminal_server_ip_address

Specifies the IP address of terminal server connected to the target host.

terminal_server_userid

Specifies the user ID for the terminal server.

terminal_server_password

Specifies the encrypted password for the terminal server.

For instructions about how to encrypt passwords, see Password Encryption.