9.2 Setting Up a Control File with OES Components

The control file is an XML file that contains an installation profile for the target computer. This installation profile contains all the information to complete software installation and configuration on the target computer.

To create a control file:

  • You can create the control file manually in a text editor (not recommended).

  • When you complete an installation, you can click Clone for AutoYaST. If you use this option, the resulting file is /root/autoinst.xml. This file must be edited manually before using it.

  • You can create or modify a control file by using the AutoInstallation module in YaST. For procedures, see Section 9.2.1, Using the AutoInstallation Module to Create the Control File.

    This system depends on existing modules that are usually used to configure a computer after OES 2023 is installed on a server.

9.2.1 Using the AutoInstallation Module to Create the Control File

The following procedure contains a quick list of steps to create the control file by using the AutoInstallation module in YaST on a server running OES 2023.

  1. On a server that has OES 2023 installed, click Computer > YaST Administrator Settings.

  2. Click Miscellaneous > Autoinstallation.

    The AutoYaST Configuration Management System application window opens, referred to hereafter as the main window.

  3. Click Tools > Create Reference Profile.

  4. In the Create a Reference Control File dialog box under Select Additional Resources, select the Network Settings check box, then click Create.

    AutoYaST probes the server it is running on for software, partitioning, boot loader, network card information, language settings, mouse, and other system settings. After the information has been collected, the status messages cease and only the main window is displayed.

  5. Verify the package selections:

    1. In the left frame of the main window, click Software, then under Available Modules, click Package Selection.

    2. On the Package Selection page, make sure the items are the same as you previously installed on the server. For more information on the add-ons (software selections) that are selected in the base selections or patterns, see Deciding What Patterns to Install. If the configuration contains the packages and selections you need, skip to Step 7. If not, continue with Step 6.

  6. If necessary, change the package selections for the target servers:

    1. In the Package Selection dialog box, click Configure.

    2. On the Software Selection page, click Patterns in the Filter field.

    3. Select the specific software items that you want to be added, then click Accept.

    4. If you are prompted to accept the AGFA Monotype Corporation End User License Agreement, click Accept.

    5. Accept the automatic changes by clicking Continue in the Changed Packages dialog box.

  7. Specify the Partitioning parameters for the target server:

    1. In the left frame of the main window, click Hardware, under Available Modules, click Partitioning, then click the Edit button.

    2. Set up partitioning on the first drive as desired, then click Finish.

      See the online help for details about limitations.

      For more information on partitioning options, see “Partitioning” in Automatic Linux Installation and Configuration with Yast2.

  8. Specify the settings for the graphics card and monitor:

    1. In the left frame of the main window, click Hardware, under Available Modules, click Graphics Card and Monitor, then click the Configure button.

    2. In the General Options field of the X11 Configuration page, specify the settings that you want.

    3. In the Desktop field of the X11 Configuration page, select the settings that you want for the Display Manager and Window Manager, then click Next.

    4. On the Configure Monitor page, select the applicable monitor vendor and model, then click Next.

    5. Verify the X11 settings. If they are not correct, repeat Step 8.a and Step 8.d.

      If you skip this step, the server keyboard mappings might be German.

  9. (Optional) Insert a script to perform a task that you want, such as a script for removing partitions:

    For more information on custom user scripts, see “Custom User Scripts” in SUSE Auto YaST guide.

    1. In the main window, click Miscellaneous > Custom Scripts > Configure.

    2. On the User Script Management page, click New.

    3. In the File Name field, specify a descriptive name for the script, such as hello_world_script.

    4. In the Script Source field, specify commands such as the following example script:

      #!/bin/sh
      'echo "hello world" > /tmp/post-script-output'
    5. Click the Type drop-down box, then select Post.

      This script runs after the installation is complete. For additional options, see the online help for this dialog box.

    6. Click Save.

    7. Make sure your script appears in the Available Scripts section of the User Script Management page, then click Finish.

    8. Make sure your script appears in the Post Scripts section of the Custom Scripts page.

  10. Set the password for the root user:

    1. From the main window, click Security and Users > User Management > Configure.

    2. Click Set Filter, then select Select System Users from the drop-down menu.

    3. Select user root, then click Edit.

    4. Type a password for the root user in the Password and Verify Password fields, click Accept, then click Finish.

    5. Verify that the root user appears in the Users section of the User Management dialog box.

  11. Configure OES Services:

    1. From the main window, click Open Enterprise Server > module_name > Configure.

      All OES services are in the Open Enterprise Server category.

      We recommend configuring eDirectory first. Although there are dependencies for some of the components, in this release AutoYaST does not verify whether one module is configured or not.

      See the following table for category names and dependencies. You should configure all the modules that were selected for the software selections in Step 5. For more information about which modules are in each pattern, see Deciding What Patterns to Install.

      Pattern

      Other Module Dependencies

      OES Backup/Storage Management Services (SMS)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Business Continuity Cluster (BCC)

      • OES Cluster Services (NCS)

      • OES Linux User Management (LUM)

      • OES Backup/Storage Management Services (SMS)

      • OES Remote Manager (NRM)

      OES CIFS

      • OES Backup / Storage Management Services (SMS)

      • OES eDirectory

      • OES Storage Services (NSS)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      • OES NCP Server

      OES Cluster Services (NCS)

      • OES Backup/Storage Management Services (SMS)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES DHCP

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES DNS

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Domain Services for Windows

      • OES Backup / Storage Management Services (SMS)

      • OES eDirectory

      • OES DNS

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES eDirectory

      • OES Backup/Storage Management Services (SMS)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES FTP

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      NetIQ iManager

      • OES Backup/Storage Management Services (SMS)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES iPrint

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      iPrint Advanced

      • OES iPrint

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Linux User Management (LUM)

      • OES Backup/Storage Management Services (SMS)

      • OES Remote Manager (NRM)

      OES NCP Server / Dynamic Storage Technology

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Pre-Migration Server

      • OES Backup / Storage Management Services (SMS)

      • OES eDirectory (without a replica)

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Remote Manager (NRM)

      • OES Backup/Storage Management Services (SMS)

      • OES Linux User Management (LUM)

      OES Storage Services (NSS)

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES NCP Server

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Storage Service AD Support

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES NCP Server

      • OES Storage Services (NSS)

      • OES CIFS Services

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

      OES Unified Management Console (UMC)

      • OES Backup/Storage Management Services (SMS)

      • OES eDirectory

      • OES Linux User Management (LUM)

      • OES Remote Manager (NRM)

    2. Type or select the information for each field requested on each page, then click Next until a summary of settings is displayed for that service.

    3. Verify that the settings for each module are what you want.

      If not, click Reset Configuration and provide the corrected settings.

    4. Repeat Step 11.a through Step 11.c until all the required modules have been configured, then continue with Step 12.

  12. Save the file.:

    1. Click File > Save.

    2. Browse to a location that you want to save the file to.

    3. Type filename.xml, then click Save.

      Replace filename with an appropriate name to identify the control file for the installation you are performing.

      By default, the file is saved in the /var/lib/autoinstall/repository/ directory.

      For additional filename requirements and recommendations, see “The Auto-Installation Process” in Automatic Linux Installation and Configuration with Yast2.

  13. Exit the configuration management tool by clicking File > Exit.

  14. Proceed with Setting Up an Installation Source.