5.6 Using AutoYaST for an OES 11 SP3 Upgrade

If you are a system administrator who needs to upgrade multiple OES 2, OES 11, OES 11 SP1, or OES 11 SP2 servers, it can be time-consuming and inconvenient to repeat the process of swapping installation discs and providing necessary upgrade information. You can now use AutoYaST to upgrade an OES 2 (64-bit), OES 11, OES 11 SP1 or OES 11 SP2 server to OES 11 SP3 with no user intervention. Ensure that you use the integrated OES 11 SP3 ISO (OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso) for the upgrade.

IMPORTANT:Information provided in this section is critical. Failing to meet the prerequisites and follow the procedures as outlined might result in loss of data or the OES server becoming unrecoverable. Before performing these procedures in a live environment, we strongly recommend that you try them in a test environment to become familiar with the unattended upgrade process.

5.6.1 Prerequisites

Identify the 64-bit OES 2 SP3, OES 11, OES 11 SP1, or OES 11 SP2 server that you want to upgrade, and ensure that the latest patches are applied before starting the upgrade. Ensure that you meet all the OES 11 SP3 upgrade requirements specified in Section 5.3, Meeting the Upgrade Requirements.
Ensure that you have the eDirectory replica server IP address and eDirectory credentials.
Ensure that the replica server is reachable over the network.
Ensure that the correct eDirectory replica server's IP address is present in the eDirectory install configuration file (for OES 2 SP2, the file name is edir2_sp2, for OES 2 SP3, it is edir2_sp3, for OES 11, it is edir11, for OES 11 SP1, it is edir_oes11_sp1 and OES 11 SP2, it is edir_oes11_sp2) at /etc/sysconfig/novell/ as shown below:

CONFIG_EDIR_REPLICA_SERVER=" <specify the eDirectory Replica IP> "
Download the OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso, remove the add_on_products.xml, and then remaster the ISO. Use the remastered ISO for the upgrade. For more information, see Section 5.6.2, Remastering the Integrated ISO without the add_on_products.xml.
Create an answer file that provides the eDirectory password. For more information, see Section 5.6.3, Creating an Answer File to Provide the eDirectory and DSfW Passwords.

5.6.2 Remastering the Integrated ISO without the add_on_products.xml

For a truly unattended OES 11 SP3 upgrade from OES 2, OES 11, OES 11 SP1 or OES 11 SP2, use the remastered integrated ISO (OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso) that does not have the add_on_products.xml file.

To remaster the ISO:

Download the OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso and loop mount it under any directory using the following command:

mount -o loop OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso /mnt/autoupgrade

It is mounted in read-only mode.
Copy the autoupgrade folder to another location, and then delete the add_on_products.xml file.

cp -r /mnt/autoupgrade /tmp
Remaster the OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso without the add_on_products.xml file.

mkisofs -R -b boot/x86_64/loader/isolinux.bin -c boot.cat -no-emul-boot -boot-load-size 4 -boot-info-table -o /tmp/SLES11-with-OES11-SP3.iso /tmp/autoupgrade

5.6.3 Creating an Answer File to Provide the eDirectory and DSfW Passwords

During an AutoYaST upgrade, the system requires user input only to provide the eDirectory and DSfW passwords. This intervention can be eliminated with the help of an answer file.

WARNING:During the answer file creation, no validation is performed on the passwords you enter. If the wrong password is entered, the upgrade will fail and the server that you are upgrading will become unrecoverable.

To create an answer file, use any one of the following methods:

Directly Generating the Answer Key File

Log in to your OES 2 (64-bit), OES 11, OES 11 SP1 or OES 11 SP2 machine as a root user and execute the following command:
```
yast2 /usr/share/YaST2/clients/create-answer-file.ycp <eDirectory password> [<DsfW Administrator Password for a DsfW server upgrade>]
```
NOTE:This method is not recommended because the passwords are stored in the y2log file in clear text.

Exporting the Passwords to Variables

In the terminal window, type the following commands:
- export OES_EDIR_DATA=<specify eDirectory Administrator Password>
- export OES-DSFW_DATA=<specify the DsfW Administrator Password for a DsfW server upgrade>
- yast2 /usr/share/YaST2/clients/create-answer-file.ycp

Using the GUI on OES 11 and Above

Using the GUI on OES 11 and above
1. In the terminal window, type the following command:
  
  yast2 /usr/share/YaST2/clients/create-answer-file.ycp
2. In the YaST2 dialog, provide the eDirectory and DSfW passwords, then click OK.

NOTE:DSfW password should be specified only if you are upgrading a DSfW server.

Once you have successfully generated the answer key file using any of the above stated methods, copy it from the current working directory to /opt/novell/oes-install/. For example, cp answer /opt/novell/oes-install/.

HINT:To invoke help for creating the answer key file, in the terminal window, type yast2 create-answer-file.ycp --help.

5.6.4 Upgrading an OES 2 (64-bit), OES 11, OES 11 SP1 or OES 11 SP2 Server to OES 11 SP3

Ensure that you have met all the requirements listed in Section 5.6.1, Prerequisites.

Use the remastered integrated iso (OES11-SP3-addon_with_SLES11-SP4-x86_64-DVD.iso) to boot the OES 2, OES 11, OES 11 SP1 or OES 11 SP2 machine that you want to upgrade.

In the installation screen, select Install, and specify the following information:

autoupgrade=1 autoyast=relurl://oes/autoupgrade.xml

For example:

autoupgrade=1 autoyast=relurl://oes/autoupgrade.xml

Press Enter.

The upgrade proceeds without any user intervention.

5.6.5 Upgrading an OES 2 (64-bit), OES 11, OES 11 SP1 or OES 11 SP2 XEN Guest Server to OES 11 SP3

Ensure that you have met all the requirements listed in Section 5.6.1, Prerequisites.

Shut down the guest machine.
Open the guest machine's XML file at /etc/xen/vm, delete the boot loader entry, then save the file.
Use the following command to delete the guest machine:
```
xm delete <guest machine>
```

Use the following command to start the virtual manager GUI:

os=sles11; vm-install --vm-settings /etc/xen/vm/<guest>.xml --os-type $os --os-settings http://<the web server IP>/download/autoupgrade.xml

In the Operating System Installation screen, select the appropriate SLES 11 options as shown in the following image.

By default, the autoupgrade.xml path is populated for the AutoYaST file.

NOTE:If you choose to upgrade using an ISO, in the Virtual Disk, select the path where the remastered ISO exists. If you choose to upgrade using a URL, specify the HTTP path where the integrated installation source exists in Network URL.
In the Additional Arguments text box, specify the parameter information for the host IP, gateway IP, and netmask.

For example:
```
autoupgrade=1 netsetup=hostip hostip=192.168.1.1 netmask=255.255.254.0 gateway=192.168.1.254
```
Click Apply.

The upgrade proceeds without any user intervention.

5.6.6 Troubleshooting an AutoYaST Upgrade

Providing the Correct eDirectory and DSfW Administrator Password

There is no validation for the passwords that you enter while creating the answer file. If you do not specify the correct passwords, the upgrade will not be successful and the server that you are upgrading will become unrecoverable.

For a Domain Services for Windows (DSfW) server upgrade, specify the DSfW Administrator password after the eDirectory password. For more information, see Section 5.6.3, Creating an Answer File to Provide the eDirectory and DSfW Passwords

Unattended Upgrade Scenarios That Require User Input

If you have not created the answer file, you will be prompted for the eDirectory and DSfW administrator passwords.

If the eDirectory replica server's IP address is not present in the eDirectory install configuration file (for OES 2 SP2, the file name is edir2_sp2, for OES 2 SP3, it is edir2_sp3, for OES 11, it is edir11 and for OES 11 SP1, it is edir_oes11_sp1) at /etc/sysconfig/novell/, you will be prompted for the same. For more information, see Section 5.6.1, Prerequisites.