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

Creating RedHat Linux Images and Profiles With JET

The JumpStart Enterprise Toolkit (JET) is a set of utilities that simplifies the process of creating the profiles necessary to provision the RedHat Linux OS. Through the N1 SPS browser interface, you can generate the profile keywords and values that are required to perform an automated Kickstart installation of your target host.

If you prefer to not use JET, and create the profile values manually, you can create the RedHat Linux image and profile without using JET modules. See Creating Non-JET RedHat Linux Images and Profiles.

ProcedureHow to Create a RedHat Linux Provisioning Profile With JET (Browser Interface)

Before You Begin

Make sure the Linux image server exists and that the RedHat Linux operating system software is available to that server. For more information about creating the RedHat Linux image server, see Setting up the RedHat Linux Server.

Steps
  1. In the Common Tasks section of the provisioning software page, select OS Provisioning.

  2. On the OS Provisioning Common Tasks page, click Create Profile in the RedHat Linux Images 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 LinuxImage component row of the Plan Parameters table.

    • To create a new variables set, click Select from List in the LinuxImage 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 following table describes the additional variables and their default values.

        Variable Name 

        Description 

        Default Value/Example 

        osp_server

        Virtual server representing the OS provisioning service 

        masterserver-osp (Default)

        version

        Version of Linux to be deployed by this component 

        3U4 (Example)

        architecture

        Architecture of the physical system, for example, x86 


        Note –

        This value is used to name the profile component and OS image. The value of this variable is not validated or enforced by the provisioning software.


        x86 (Default)

        installPath

        RedHat Linux image name to attach 

        Linux:[version]_:[architecture]

        For example: Linux_3U4_x86

        description

        Optional description for this profile 

        test linux (Example)

        min_disk_size

        Minimum disk space required to provision the RedHat Linux OS 

        10GB (Default)

        boot_server_name

        Name of RedHat Linux boot and install server 

        masterserver (Example)

        boot_server_subnet_address

        Subnet served by the boot and install server 

        10.10.31.0 (Example)

        boot_server_subnet_ip_address

        IP address of the boot and install server on the subnet 

        10.10.31.1 (Example)

        image_subnet_mask

        Netmask of the provisioning subnet 

        255.255.255.0 (Default)

        kickstart_file

        (Non-JET profiles only) 

        Absolute path of the Kickstart file ks.cfg on the boot server

        Do not specify a value for this variable for JET-generated profiles. 

        N/A 

        pxe_boot_file

        (Non-JET profiles only) 

        Relative path from the /tftpboot directory of the pxelinux.0 boot file on the boot server

        Do not specify a value for this variable for JET-generated profiles. 

        N/A 

        pxe_configuration_file

        (Non-JET profiles only) 

        Relative path from the pxelinux.cfg directory of the PXE Linux configuration file on boot server

        Do not specify a value for this variable for JET-generated profiles. 

        N/A 

        linux_component_folder

        Location of autogenerated Linux Provision component folder 

        /com/sun/n1osp/autogen-:[target(..):sys.hostName]-linux (Default)

        image_path

        (JET profiles only) 

        NFS path to the OS image. 

        Do not specify a value for this variable for non-JET profiles. 

        nfs://10.10.31.1/export/install/RHEL3 (Example)

        kernel

        (JET profiles only) 

        Relative path to the kernel in the OS image 

        Do not specify a value for this variable for non-JET profiles. 

        images/pxeboot/vmlinuz (Default)

        initrd

        (JET profiles only) 

        Relative path to initrd in the OS image

        Do not specify a value for this variable for non-JET profiles. 

        images/pxeboot/initrd.img (Default)

      4. Save the variables set.

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

  5. On the Plan Details Run page, select the Linux image server on which to create the profile.


    Tip –

    The host name of the Linux image server ends in -linux.


  6. If needed, change the Profile Name.

  7. If needed, change the Profile Description.

  8. Update the list of the JET modules to use.

    The JET product modules are located on the JET server in the directory /opt/SUNWjet/Products.

    By default, the plan variable JET Modules Name(s) lists two JET modules to include in the RedHat Linux profile component:

    base_config is the required JET module for basic RedHat Linux installation. All other /opt/SUNWjet/Products modules are optional. Adding a module name to this list adds the module installation function and configuration variables to the newly created RedHat Linux provisioning profile.

  9. Verify that the Use the Jet Modules Specified Above checkbox is selected.

  10. Click Run Plan (includes preflight).

  11. To verify that the Linux profile is created to the Linux image server, click Components in the left pane of the N1 SPS browser interface.

    You should find a provision component in the folder /com/sun/n1osp/autogen-server-name-linux/provision/, where server-name is the Linux server name that you provided in the variable set. For example: /com/sun/n1osp/autogen-Linux3U4_x86-linux/provision/.

ProcedureHow to Create a JET RedHat Linux Provisioning Profile (Command-Line Interface)

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


    # cr_cli -cmd cdb.vs.add -comp NM:/com/sun/n1osp/untyped/LinuxImage \
    -name "redhat3" -u admin -p admin -vars "osp_server=masterserver-osp; \
    version=RedHat3.0;architecture=x86; \
    installPath=Linux:[version]_:[architecture];description=test linux; \
    min_disk_size=10GB;boot_server_name=bikickstart; \
    boot_server_subnet_address=10.42.42.0;boot_server_subnet_ip_address=10.42.42.3;\
    kickstart_file=/export/el30.cfg;pxe_boot_file=linux-install/pxelinux.0; \
    pxe_configuration_file=el30-console"
    
  2. To run the plan, type a command similar to the following example:


    # cr_cli -cmd pe.p.run -u admin -p admin \
    -PID NM:/com/sun/n1osp/untyped/LinuxImage-create-profile \
    -tar H:NM:bikickstart-linux -comp - -vs redhat3 -pto 30 -nto 10 \
    -f /tmp/redhat-profile
    

    Note the default N1 SPS user value you specified with the -u option. This user must exist after the OS installation for the N1 SPS Remote Agent software to start on the target host.