1.3 Before You Upgrade PlateSpin Forge

Before you upgrade the PlateSpin Forge Server software, ensure that you prepare your PlateSpin Forge environment by performing the prerequisite tasks in Table 1-3.

Table 1-3 Checklist for Preparing to Upgrade PlateSpin Forge Server

Status

Prerequisite Task

Notes

  1. Download the PlateSpinForgeSetup-11.3.0.xxx.exe file and copy it to the Forge Management VM.

See Section 1.3.1, Downloading the Setup Utility.

  1. Pause the replication schedules for all protected workloads, and ensure that no replications are running.

See Section 1.3.2, Pausing the Replication Schedule.

  1. Make a record of any customized PlateSpin Configuration parameters that control the server’s default behavior. You will need to restore these settings after the upgrade.

  1. Back up the Forge Management VM by taking a virtual machine snapshot as a restore point.

See Section 1.3.3, Backing Up the Forge Management VM.

  1. Back up your custom Linux blkwatch drivers. You will need to upload these drivers again after the upgrade.

See Section 1.3.4, Backing Up Your Custom Linux blkwatch Drivers Before Upgrade.

  1. Ensure that .NET Framework 4.5.2 is installed.

See Microsoft .NET Framework 4.5.2 (Offline Installer).

1.3.1 Downloading the Setup Utility

To perform the upgrade, you must use the PlateSpin Forge Setup utility (PlateSpinForgeSetup-11.3.0.xxx.exe). The upgrade will export and import data from your previous installation. This utility is available in the PlateSpin Forge 11.3 Appliance Rebuild Kit found on the Micro Focus Patch Finder website.

  1. Go to the Micro Focus Patch Finder website.

  2. (Conditional) If PlateSpin Forge is not pre-selected, select the PlateSpin Forge product and version, then click Search.

  3. In the search results, locate and expand PlateSpin Forge 11.3, then click PlateSpin Forge 11.3 Appliance Upgrade Kit.

  4. On the Download Description page, click proceed to download.

  5. When you are prompted for your Customer Care user identity, log in with the Customer Care user account that has the email address associated with the product purchase.

  6. In the component list, find the PlateSpinForgeSetup-11.3.0.xxx.exe utility, then click download next to the file name.

  7. Save the file to your computer.

  8. Copy this file to the Forge VM when you are ready to begin the upgrade.

1.3.2 Pausing the Replication Schedule

Before you create a snapshot or start the PlateSpin Forge upgrade software, use the following procedure to pause the replication schedules for the workloads protected by the PlateSpin Server and ensure that there are no running replications. You can wait for the in-progress replications to complete gracefully, or abort them.

  1. Log in to the PlateSpin Forge Web Interface.

  2. Click Workloads, click Select All, click Pause Schedule, and then click Execute to initiate a pause for all scheduled replications.

  3. On the Workloads page, ensure that the Schedule state of protected workloads is Paused.

  4. On the Workloads page, ensure that the Replication Status of each of the protected workloads is Idle. Wait for any replications that are underway to complete, or abort the running operations.

    If you do not perform this task before the upgrade, the upgrade software will automatically detect the running jobs before it executes the software upgrade, and will prompt you to perform the task before you continue. You can proceed with the upgrade process only when each workload’s Replication Status is Idle.

1.3.3 Backing Up the Forge Management VM

We recommend that you take a virtual machine snapshot of your Forge Management VM prior the upgrade in order to preserve its data in the event of a power failure or other problems. Use the VMware client to take the snapshot. See Managing Snapshots of the Forge VM on the Appliance Host in the PlateSpin Forge User Guide.

  1. From the Workloads page of PlateSpin Forge Web Interface, pause your replication schedules and ensure that there are no running replications. See Section 1.3.2, Pausing the Replication Schedule.

    This ensures there are no incomplete replications saved with the snapshot.

  2. Use the vSphere Client to access the appliance host.

  3. Use the standard Windows procedure to shut down the VM (Start > Shut Down).

    Allow the server to shut down gracefully.

  4. In the inventory panel at the left, right-click the PlateSpin Forge Management VM item and select Snapshot > Take Snapshot.

  5. Type a name and a description for the snapshot, then click OK.

  6. After the snapshot is complete, power on the Forge Management VM.

The snapshot of the Forge Management VM preserves your Forge management data as well as the Microsoft SQL Server database file that resides on the PlateSpin Forge Server. You can use the snapshot if you need to roll back.

1.3.4 Backing Up Your Custom Linux blkwatch Drivers Before Upgrade

During the upgrade, the PlateSpin Protect installation program will overwrite custom Linux blkwatch drivers that you previously added to PlateSpin Protect. Consider saving a copy of your custom Linux blkwatch drivers prior to the upgrade.

  1. Log in to the PlateSpin Server host machine as the Administrator user.

  2. Navigate to the PlateSpin application's installation directory, such as C:\Program Files\PlateSpin Protect Server\.

  3. Open the .\Packages\9D470BFF-E30F-4015-83D8-4D308A8C8B1B\ folder and copy the 1.package file out of this folder to a temporary directory.

  4. Rename 1.package with the .zip file extension (1.zip), then extract the contents of the file to this temporary directory.

  5. Save your CustomKernel* content to another temporary location.

Proceed with the upgrade, as detailed in Upgrade Procedure.

After the upgrade, you should upload again any custom Linux blkwatch drivers you need for future migrations. See KB Article 7005873.