Versions Compared

Version Old Version 1 New Version Current
Changes made by

Amit Munwes

Amit Munwes

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

For DPOD Appliance Mode users only:
The following instructions apply only after upgrading from 1.0.21.0 to 1.0.22.0 on DPOD appliance mode.

After applying the upgrade to 1.0.22.0 on DPOD version 1.0.21.0, it is required to migrate the operating system from CentOS to Rocky Linux.

  1. Inspect the existing operating system (CentOS) configuration and keep it for later:

    1. The server’s host name (use hostname command to display the host name).

    2. The server’s IP address and netmask (use ip a command to display the IP address and its prefix).

    3. The server’s default gateway (use route -n command to display the routing data).

    4. The primary and secondary DNS servers (use cat /etc/resolv.conf command to display the DNS servers).

    5. The NTP servers (use cat /etc/ntp.conf command to display the NTP servers).

    6. The server’s mount points (use cat /etc/fstab command to display the mount points) - look for any custom mount points that have been added to the server, such as NFS mount point for storing the DataPower gateway’s backup files, etc. The standard mount points include: /, /boot, /boot/efi, /var, /tmp, /app, /app/tmp, /data, /installs, /logs, and /shared.

  2. Download the ISO file and its md5 checksum file from Passport Advantage (file name is DPOD_Appliance_1.0.22.0.iso).
    Verify the ISO file integrity by calculating its md5 checksum and comparing it to the downloaded md5 checksum file.

  3. Shut down the server.

  4. Perform a full backup (including the operating system) of the DPOD server.

  5. Make sure the operating system disk size meets the required minimum (50 GB) documented in Hardware and Software Requirements. Expand it if necessary.

  6. Set the DPOD ISO file as your virtual/physical server's DVD.

  7. If the server is virtual, edit its settings and configure its guest OS as Rocky Linux (64-bit) or Red Hat Enterprise Linux 9 (64-bit).

  8. Make sure the server boots using the UEFI firmware (and not the Legacy boot).

  9. Make sure the DVD is configured before the hard drives in the boot order, to make sure the server will boot from the ISO file..

  10. Power on the virtual/physical server.

  11. Make sure the DPOD 1.0.22.0 installation is launched from the ISO file.

  12. Follow the instruction in the machine console and let the OS installation complete.

  13. Configure the network (using the information you kept before) and set passwords.

  14. When you've completed all the steps above, before you press ENTER to restart the machine, you should disable/eject your DVD from the virtual/physical server to make sure the installation is not launched again after the restart. Press ENTER and wait for the server to restart.

  15. Log in to the DPOD's server console with the user dpodadm (e.g.: using SSH, VMware console, a KVM switch, or the physical server console).

  16. Run the following command:

    Code Block
    languagebash
    sudo /opt/APPL-setup --restore-os-config

  17. Enable httpd:

    Code Block
    systemctl enable httpd

  18. In case custom mount points existed in /etc/fstab before the upgrade, restore them now by editing that file and adding the missing lines from the data that was collected in item 1 above.
    Be careful, as invalid content in /etc/fstab file may cause the server boot to fail.
    If any custom mount points were added to that file, reboot the server now to make sure it can boot and that the custom mount points are available again.

Now continue with the upgrade process as documented in All-in-One Upgrade.