ztC Edge Release 1.2.0.5 Release Notes

These Release Notes are for ztC Edge Release 1.2.0.5 (updated at 10:15 PM on 4/29/2021). See the following sections:

Accessing Stratus Knowledge Base Articles

The Stratus Customer Service Portal provides a searchable Knowledge Base with technical articles about all Stratus products, including ztC Edge. In some cases, the Release Notes directly reference these Knowledge Base articles (for example, KB-nnnn). You can access the Customer Service Portal and the Knowledge Base articles by using your existing service portal credentials, or by creating a new user account, as follows.

To access the Knowledge Base

  1. Log on to the Stratus Customer Service Portal at https://support.stratus.com.

    If needed, create a new account as follows:

    1. Click Register Account.
    2. Enter your company email address and contact info, and click Register.

      Your company email address must include a domain name (for example, stratus.com) for a company that is a registered customer of Stratus.

    3. Click the link in the email that you receive from Stratus.
    4. Enter a new password and finish configuring your account.

    If you need assistance creating an account, contact your authorized Stratus service representative.

  2. In the service portal, click Knowledge Base in the left pane.
  3. In the Keyword Search box, enter keywords associated with the information you need, and then click Search.

    To search for an article by its KB-nnnn number, click Advanced Search. Next to Search by ID, type the article ID number (nnnn) and click Display.

New Features and Enhancements

ztC Edge Release 1.2.0.5 includes the following new features:

Also, beginning in Release 1.2.0.5, the online Help is available in German, Japanese, and Chinese.

Important Considerations

Upgrading from ztC Edge Release 1.2.0.0

You can upgrade to the current release from ztC Edge Release 1.2.0.0 by following the instructions in Upgrading Stratus Redundant Linux Software.

Caution: All PMs and VMs must be in good health before you upgrade the Stratus Redundant Linux software. Before starting an upgrade, examine the ztC Console to verify that there are no alerts indicating PM or VM problems.
Note: Eject any VCDs or USB media from the VMs before upgrading. If VCD or USB media is still connected to the VMs, it prevents the system from migrating the VMs and putting the PMs into maintenance mode for the upgrade process.

Using Intel Active Management Technology (AMT) for Lights-Out Support

ztC Edge systems incorporate Intel Active Management Technology (AMT) lights-out support for remote power management, remote console, and remote media. For important information about AMT configuration and restrictions, see KB-8219.

Redeploying a ztC Edge System

Redeploying a ztC Edge system allows you to clear the network settings of the system to prepare it for deployment on a different network. If you need to move a system to a new network, redeploy and shut down the system before moving it, as described in Redeploying a ztC Edge System.

When you redeploy a system, note the following issues and workarounds:

Deploying ztC Edge Nodes at Separate Physical Sites

When you deploy a ztC Edge system, you must deploy both nodes at the same site and directly connect the A-links between the blue (•) and yellow (• •) network ports of each node. If you want to set up a ztC Edge system in a SplitSite configuration, where each node is located at a separate physical site for increased redundancy, contact your authorized Stratus service representative for assistance. Because of the geographic separation, a SplitSite configuration requires careful planning of component placement and networking topologies.

Other Important Considerations

For other important considerations about ztC Edge systems, see Important Physical Machine and Virtual Machine Considerations.

Known Issues

P2V/V2V Migration May Fail when Migrating a Windows-based VM

If you use the P2V client (virt-p2v) to migrate a PM or VM running Windows, the migration may fail with the message, "error: inspection could not detect the source guest (or physical machine)." For more information about this issue, contact your Stratus service representative and refer to KB-8290.

VM Network Remains Offline After Using P2V/V2V to Migrate from a VMware Source

If you use the P2V client (virt-p2v) to migrate a PM or VM from a source that is running VMware, the network driver might fail to install properly during the migration process, which leaves the VM network offline. If this happens, manually install the network driver in Device Manager. For instructions, see the Troubleshooting section of Migrating a Physical Machine or Virtual Machine to a System.

VM Network Remains Offline After Importing a Windows-based VM

If you import a Windows-based VM with the Import/Restore Virtual Machine Wizard, the VirtIO network driver may fail to install properly the first time you start the VM, which leaves the VM network offline. If this happens, manually install the network driver in Device Manager. For instructions, see the Troubleshooting section of Importing an OVF File.

Ensure that Both Nodes Are Connected to the Network Before Creating a VM

Before creating a VM, always ensure that the network you assign to the VM has an active network connection in each node of the system. You can verify the state of the networks on the Networks page of the ztC Console.

If you add a VM while one of the paired network interfaces is offline, the VM will not start. To start the VM, connect an active network cable to the offline interface, wait a few seconds, and start the VM.

Ensure that Both Nodes Are Running Before Removing a VM

To avoid downtime, before removing a VM, always ensure that both nodes are in the running state and that neither node is in maintenance mode or in the process of synchronizing.

If you remove a VM while one node is shut down in maintenance mode, the operation may stall with the error, "There was a problem deleting vm-name." To correct the problem, you must restart the only running node.

Invalid VM Names Prevent Some VM Operations from Executing

The ztC Console may improperly validate VM names to ensure that they meet the software requirements. If you are creating, reprovisioning, or renaming a VM with an unsuitable name, the operation may fail to execute.

To avoid any problems with VM operations, ensure that your VM names meet the following requirements:

Some Browsers Unable to Connect a VNC When Using https

If you are connected to the ztC Console using an https URL in a Microsoft Internet Explorer or Mozilla® FireFox® browser, and you click Console after selecting a running VM from the Virtual Machines page, the message VNC: Unable to connect, retrying in n seconds may appear. To enable the VNC connection, click the https link to the VNC console page in the upper right-hand corner of the masthead, and continue with the appropriate procedure below:

The VNC console appears.

Cannot Mount USB Media with exFAT File System

The Stratus Redundant Linux software on ztC Edge systems does not support the exFAT File system. If you need to mount a USB medium to import or export a VM, as described in Mounting a USB Device or Network-mounted Folder on the ztC Edge System, format the device with NTFS. (By default, most USB media are formatted with the FAT file system, which has a limited file size of 4 GB that may be too small for most VMs.)

Reboot Required when Changing Node IP Address or Netmask Network Settings

When you change the IP address or netmask settings of an ztC Edge node as described in Configuring IP Settings, you must reboot the node or the system for the changes to take effect. If you do not reboot the node or the system, both the new and old settings will remain in effect, which may cause routing or connection issues.

Changing the MTU of Business Networks Causes VM Migration and Possibly Node Failover

If you change the maximum transmission unit (MTU) setting of either network0 (P1) or network1 (P2), the system automatically migrates the VMs from one node to the other. If you change the MTU for network0 (P1) specifically, the system also automatically fails over from the primary node to the secondary node.

To avoid this issue, avoid changing the MTU setting of the business networks, or change the MTU only during a planned maintenance period.

Documentation Updates

The following changes were made late in the release:

Getting Help

If you have a technical question about ztC Edge systems, you can find the latest technical information and online documentation at the Downloads page at https://www.stratus.com/services-support/downloads/?tab=ztcedge. You can also search the Knowledge Base in the Stratus Customer Service Portal at https://support.stratus.com.

If you cannot resolve your questions with these online resources, and the system is covered by a service agreement, contact your authorized Stratus service representative. For information, see the ztC Edge Support page at https://www.stratus.com/services-support/customer-support/?tab=ztcedge.