Skip to main content

Install and boot node4

Contributors netapp-pcarriga netapp-aoife netapp-aherbin

You must install node4 in the rack, transfer node2 connections to node4, and boot node4. You must also reassign any node2 spares, any disks belonging to root, and any non-root aggregates that were not relocated to node3 earlier.

About this task

You must netboot node4 if it does not have the same version of ONTAP 9 that is installed on node2. After you install node4, boot it from the ONTAP 9 image stored on the web server. You can then download the correct files to the boot media device for subsequent system boots by following the instructions in Prepare for netboot

However, you are not required to netboot node4 if it has the same or later version of ONTAP 9 that is installed on node2.

Important information:

  • If you are upgrading a V-Series system or a system with FlexArray Virtualization Software that is connected to storage arrays, you need to complete Step 1 through Step 7, leave this section at Step 8 and follow instructions in Set the FC or UTA/UTA2 configuration on node4 as needed, entering the commands in Maintenance mode. You must then return to this section and resume the procedure at Step 9.

  • However, if you are upgrading a system with storage disks, you must complete this entire section and then proceed to the section Set the FC or UTA/UTA2 configuration on node4, entering commands at the cluster prompt.

Steps
  1. Take one of the following actions:

    If node4 will be in …​ Then…​

    A chassis separate from node3

    Go to Step 2.

    The same chassis with node3

    Skip Steps 2 and 3 and go to Step 4.

  2. Make sure that node4 has sufficient rack space.

    If node4 is in a separate chassis from node3, you can put node4 in the same location as node2. If node3 and node4 are in the same chassis, then node4 is already in its appropriate rack location.

  3. Install node4 in the rack, following the instructions in the Installation and Setup Instructions for the node model.

  4. Cable node4, moving the connections from node2 to node4.

    The following references help you make proper cable connections. Go to References to link to them.

    • Installation and Setup Instructions or FlexArray Virtualization Installation Requirements and Reference for the node4 platform

    • The appropriate disk shelf procedure

    • The High Availability management documentation

      Cable the following connections:

    • Console (remote management port)

    • Cluster ports

    • Data ports

    • Cluster and node management ports

    • Storage

    • SAN configurations: iSCSI Ethernet and FC switch ports

    Note You do not need to move the interconnect card/FC_VI card or interconnect/FC_VI cable connection from node2 to node4 because most platform models have unique interconnect card models.
  5. Take one of the following actions:

    If node4 is in…​ Then…​

    The same chassis as node3

    Go to Step 8.

    A chassis separate from node3

    Go to Step 6.

  6. Turn on the power to node4, and then interrupt the boot by pressing Ctrl-C to access the boot environment prompt.

    Note When you boot node4, you might see the following message:
    WARNING: The battery is unfit to retain data during a power
             outage. This is likely because the battery is
             discharged but could be due to other temporary
             conditions.
             When the battery is ready, the boot process will
             complete and services will be engaged.
             To override this delay, press 'c' followed by 'Enter'
  7. If you see the warning message in Step 6, take the following actions:

    1. Check for any console messages that might indicate a problem other than a low NVRAM battery and, if necessary, take any required corrective action.

    2. Allow the battery to charge and the boot process to finish.

      Warning Warning: Do not override the delay. Failure to allow the battery to charge could result in a loss of data.
  8. Take one of the following actions:

    If your system…​ Then…​

    Has disks and no back-end storage

    Skip Step 9 through Step 14 and go to Step 15.

    Is a V-Series system or has FlexArray Virtualization Software and is connected to storage arrays

    1. Go to the section Set the FC or UTA/UTA2 configuration on node4 and complete the sections Configure FC ports on node4 and Check and configure UTA/UTA2 ports on node4, as appropriate to your system.

    2. Return to this section and complete the remaining steps, beginning with Step 9.

    Important You must reconfigure FC onboard ports, UTA/UTA2 onboard ports, and UTA/UTA2 cards before you boot ONTAP on the V-Series system.
  9. Add the FC initiator ports of the new node to the switch zones.

    See your storage array and zoning documentation for instructions.

  10. Add the FC initiator ports to the storage array as new hosts, mapping the array LUNs to the new hosts.

    See your storage array and zoning documentation for instructions.

  11. Modify the World Wide Port Name (WWPN) values in the host or volume groups associated with array LUNs on the storage array.

    Installing a new controller module changes the WWPN values associated with each onboard FC port.

  12. If your configuration uses switch-based zoning, adjust the zoning to reflect the new WWPN values.

  13. Verify that the array LUNs are now visible to node4 by entering the following command and examining its output:

    sysconfig -v

    The system displays all the array LUNs that are visible to each of the FC initiator ports. If the array LUNs are not visible, you cannot reassign disks from node2 to node4 later in this section.

  14. Press Ctrl-C to display the boot menu and select Maintenance mode.

  15. At the Maintenance mode prompt, enter the following command:

    halt

    The system stops at the boot environment prompt.

  16. Configure node4 for ONTAP:

    set-defaults

  17. If you have NetApp Storage Encryption (NSE) drives installed, perform the following steps.

    Note If you have not already done so earlier in the procedure, see the Knowledge Base article How to tell if a drive is FIPS certified to determine the type of self-encrypting drives that are in use.
    1. Set bootarg.storageencryption.support to true or false:

      If the following drives are in use… Then…

      NSE drives that conform to FIPS 140-2 Level 2 self-encryption requirements

      setenv bootarg.storageencryption.support true

      NetApp non-FIPS SEDs

      setenv bootarg.storageencryption.support false

      Note

      You cannot mix FIPS drives with other types of drives on the same node or HA pair.

      You can mix SEDs with non-encrypting drives on the same node or HA pair.

    2. Go to the special boot menu and select option (10) Set Onboard Key Manager recovery secrets.

      Enter the passphrase and the backup information that you recorded earlier procedure. See Manage authentication keys using the Onboard Key Manager.

  18. If the version of ONTAP installed on node4 is the same or later than the version of ONTAP 9 installed on node2, enter the following command:

    boot_ontap menu

  19. Take one of the following actions:

    If the system you are upgrading…​ Then…​

    Does not have the correct or current ONTAP version on node4

    Go to Step 20.

    Has the correct or current version of ONTAP on node4

    Go to Step 25.

  20. Configure the netboot connection by choosing one of the following actions.

    Note You must use the management port and IP address as the netboot connection. Do not use a data LIF IP address or a data outage might occur while the upgrade is being performed.
    If Dynamic Host Configuration Protocol (DHCP) is…​ Then…​

    Running

    Configure the connection automatically by entering the following command at the boot environment prompt:
    ifconfig e0M -auto

    Not running

    Manually configure the connection by entering the following command at the boot environment prompt:
    ifconfig e0M -addr=filer_addr mask=netmask -gw=gateway dns=dns_addr domain=dns_domain

    filer_addr is the IP address of the storage system (mandatory).
    netmask is the network mask of the storage system (mandatory).
    gateway is the gateway for the storage system (mandatory).
    dns_addr is the IP address of a name server on your network (optional).
    dns_domain is the Domain Name Service (DNS) domain name. If you use this optional parameter, you do not need a fully qualified domain name in the netboot server URL; you need only the server's host name.

    Note Other parameters might be necessary for your interface. Enter help ifconfig at the firmware prompt for details.
  21. Perform netboot on node4:

    For…​ Then…​

    FAS/AFF8000 series systems

    netboot http://<web_server_ip/path_to_webaccessible_directory>/netboot/kernel

    All other systems

    netboot http://<web_server_ip/path_to_webaccessible_directory/ontap_version>_image.tgz

    The <path_to_the_web-accessible_directory> should lead to where you downloaded the
    <ontap_version>_image.tgz in Step 1 in the section Prepare for netboot.

    Note Do not interrupt the boot.
  22. From the boot menu, select option (7) Install new software first.

    This menu option downloads and installs the new Data ONTAP image to the boot device.

    Disregard the following message:

    This procedure is not supported for Non-Disruptive Upgrade on an HA pair

    The note applies to nondisruptive upgrades of Data ONTAP, and not upgrades of controllers.

    Note Always use netboot to update the new node to the desired image. If you use another method to install the image on the new controller, the incorrect image might install. This issue applies to all releases of ONTAP. The netboot procedure combined with option (7) Install new software wipes the boot media and places the same ONTAP version on both image partitions.
  23. If you are prompted to continue the procedure, enter y, and when prompted for the package, enter the URL:

    http://<web_server_ip/path_to_web-accessible_directory/ontap_version>_image.tgz

  24. Complete the following substeps:

    1. Enter n to skip the backup recovery when you see the following prompt:

      Do you want to restore the backup configuration now? {y|n}
    2. Reboot by entering y when you see the following prompt:

      The node must be rebooted to start using the newly installed software. Do you want to reboot now? {y|n}

      The controller module reboots but stops at the boot menu because the boot device was reformatted and the configuration data needs to be restored.

  25. Select maintenance mode 5 from the boot menu and enter y when you are prompted to continue with the boot.

  26. Before continuing, go to Set the FC or UTA/UTA2 configuration on node4 to make any necessary changes to the FC or UTA/UTA2 ports on the node. Make the changes recommended in those sections, reboot the node, and go into Maintenance mode.

  27. Enter the following command and examine the output to find the system ID of node4:

    disk show -a

    The system displays the system ID of the node and information about its disks, as shown in the following example:

    *> disk show -a
    Local System ID: 536881109
    DISK         OWNER                       POOL   SERIAL NUMBER   HOME
    ------------ -------------               -----  -------------   -------------
    0b.02.23     nst-fas2520-2(536880939)    Pool0  KPG2RK6F        nst-fas2520-2(536880939)
    0b.02.13     nst-fas2520-2(536880939)    Pool0  KPG3DE4F        nst-fas2520-2(536880939)
    0b.01.13     nst-fas2520-2(536880939)    Pool0  PPG4KLAA        nst-fas2520-2(536880939)
    ......
    0a.00.0                   (536881109)    Pool0  YFKSX6JG                     (536881109)
    ......
  28. Reassign node2's spares, disks belonging to the root, and any non-root aggregates that were not relocated to node3 earlier in section Relocate non-root aggregates from node2 to node3:

    Note If you have shared disks, hybrid aggregates, or both on your system, you must use the correct disk reassign command from the following table.
    Disk type…​ Run the command…​

    With shared disks

    disk reassign -s

    node2_sysid -d node4_sysid -p node3_sysid

    Without shared

    disks disk reassign -s

    node2_sysid -d node4_sysid

    For the <node2_sysid> value, use the information captured in Step 10 of the Record node2 information section. For node4_sysid, use the information captured in Step 23.

    Note The -p option is only required in maintenance mode when shared disks are present.

    The disk reassign command will reassign only those disks for which node2_sysid is the current owner.

    The system displays the following message:

    Partner node must not be in Takeover mode during disk reassignment from maintenance mode.
    Serious problems could result!!
    Do not proceed with reassignment if the partner is in takeover mode. Abort reassignment (y/n)? n

    Enter n when asked to abort disk reassignment.

    When you are asked to abort disk reassignment, you must answer a series of prompts as shown in the following steps:

    1. The system displays the following message:

      After the node becomes operational, you must perform a takeover and giveback of the HA partner node to ensure disk reassignment is successful.
      Do you want to continue (y/n)? y
    2. Enter y to continue.

      The system displays the following message:

      Disk ownership will be updated on all disks previously belonging to Filer with sysid <sysid>.
      Do you want to continue (y/n)? y
    3. Enter y to allow disk ownership to be updated.

  29. If you are upgrading from a system with external disks to a system that supports internal and external disks (A800 systems, for example), set node4 as root to confirm that it boots from the root aggregate of node2.

    Warning Warning: You must perform the following substeps in the exact order shown; failure to do so might cause an outage or even data loss.

    The following procedure sets node4 to boot from the root aggregate of node2:

    1. Check the RAID, plex, and checksum information for the node2 aggregate:

      aggr status -r

    2. Check the overall status of the node2 aggregate:

      aggr status

    3. If necessary, bring the node2 aggregate online:

      aggr_online root_aggr_from_node2

    4. Prevent the node4 from booting from its original root aggregate:

      aggr offline root_aggr_on_node4

    5. Set the node2 root aggregate as the new root aggregate for node4:

      aggr options aggr_from_node2 root

  30. Verify that the controller and chassis are configured as ha by entering the following command and observing the output:

    ha-config show

    The following example shows the output of the ha-config show command:

    *> ha-config show
       Chassis HA configuration: ha
       Controller HA configuration: ha

    Systems record in a PROM whether they are in an HA pair or a stand-alone configuration. The state must be the same on all components within the stand-alone system or HA pair.

    If the controller and chassis are not configured as ha, use the following commands to correct the configuration:

    ha-config modify controller ha

    ha-config modify chassis ha.

    If you have a MetroCluster configuration, use the following commands to correct the configuration:

    ha-config modify controller mcc

    ha-config modify chassis mcc.

  31. Destroy the mailboxes on node4:

    mailbox destroy local

  32. Exit Maintenance mode:

    halt

    The system stops at the boot environment prompt.

  33. On node3, check the system date, time, and time zone:

    date

  34. On node4, check the date at the boot environment prompt:

    show date

  35. If necessary, set the date on node4:

    set date mm/dd/yyyy

  36. On node4, check the time at the boot environment prompt:

    show time

  37. If necessary, set the time on node4:

    set time hh:mm:ss

  38. Verify the partner system ID is set correctly as noted in Step 26 under option.

    printenv partner-sysid

  39. If necessary, set the partner system ID on node4:

    setenv partner-sysid node3_sysid

    1. Save the settings:

      saveenv

  40. Enter the boot menu at the boot environment prompt:

    boot_ontap menu

  41. At the boot menu, select option (6) Update flash from backup config by entering 6 at the prompt.

    The system displays the following message:

    This will replace all flash-based configuration with the last backup to disks. Are you sure you want to continue?:
  42. Enter y at the prompt.

    The boot proceeds normally, and the system prompts you to confirm the system ID mismatch.

    Note The system might reboot twice before displaying the mismatch warning.
  43. Confirm the mismatch.
    The node might complete one round of rebooting before booting normally.

  44. Log in to node4.