NEC 320Fc manual Troubleshooting Custom Actions Error

Page 106

General Problems and Solutions

Table 5-2describes some common problems with custom actions.

Table 5-2. Troubleshooting: Custom Actions

Error

Action

 

 

The executable

Ensure that the executable file associated with your custom

filename does not

action is located in the directory you specified during the

exist.

configuration process. Also, ensure that the custom action is

 

located on a system disk, otherwise the Upgrade Side loses

 

access to the executable file while the system is in split

 

mode.

Custom action

Check the output for the custom action for errors. See

failed with exit

“Viewing Standard Output and Error Stream” on page 3-17

value n

for more information.

 

You must correct the problem and click Retry in the Active

 

Upgrade console to retry the current upgrade request (which

 

also runs the custom action again). The Active Upgrade

 

process cannot continue until the executable file for your

 

custom action runs successfully.

 

If possible, test and debug the executable file outside of the

 

Active Upgrade process. Ensure that it terminates with exit

 

value 0 and that it completes in a timely manner.

Table 5-3describes miscellaneous problems.

Table 5-3. Troubleshooting: Miscellaneous Problems

Error/Problem

Action

 

 

Active Upgrade console

Wait a minute, and try to start Active Upgrade console again.

fails to start

If the problem persists, it might mean that the Active

 

 

Upgrade console cannot communicate with related services

 

on your local system. If your system is running a network

 

firewall solution, check the firewall logs for blocked

 

communications and explicitly add these items to your

 

trusted zone. For information about configuring Windows

 

Firewall, see “Configuring Windows Firewall for the Active

 

Upgrade Process” on page 2-10.

5-8Express5800/320Fc: Active Upgrade™ User’s Guide

Image 106 Contents
Express5800/320Fc Active Upgrade User’s Guide Manual Name Express5800/320Fc Active Upgrade User’s Guide Contents Performing the Upgrade TroubleshootingGlossary IndexFigures Tables Tables Vi Express5800/320Fc Active Upgrade User’s Guide Audience Purpose of This ManualNotation Conventions Typographical Conventions R N I N G U T I O NCall the RegisterDeviceNotification function Getting Help Http//support.microsoft.comPreface Express5800/320Fc Active Upgrade User’s Guide Features Chapter OverviewOverview of the Active Upgrade Process Related TopicsDuplexed System Mirror4Express5800/320Fc Active Upgrade User’s Guide Merged System Aborting the Active Upgrade Process Committing the UpgradeAborting the Upgrade Active Upgrade State Model Active Upgrade State ModelT E Page Chapter Preparing for the Active Upgrade Process Software Upgrade SupportSystem Prerequisites U T I O N 4Express5800/320Fc Active Upgrade User’s Guide Recommendations Managing Critical Applications During the Upgrade Process Pre-Upgrade Tasks 8Express5800/320Fc Active Upgrade User’s Guide To install the Active Upgrade console Installing the Active Upgrade SoftwareOpen My Computer Configuring Windows Firewall for the Active Upgrade Process To configure Windows FirewallWindows Firewall Exceptions To set the enclosure with A-side power as primary Configuring IP address in Virtual Technician Module VTM Installing Java Runtime EnvironmentChanging VTM IP address Configuring the network for Remote KVM Connection b,c Configuring the VTM IP addressConfiguring the network for Remote Desktop Connection d,e Gathering Information Active Upgrade Process Worksheet Value Custom actions to run Log files to back up Configuring Windows Automatic Updates Copying Software Installation Packages to the SystemTo configure Automatic Updates Automatic Updates Control Panel To verify the list of updates Automatic Updates Icon in System TrayStarting and Exiting the Active Upgrade Console Understanding the Active Upgrade Console Interface Title BarNavigation Bar Configuration Navigation BarNavigation Bar Active Upgrade Navigation Bar Links Main Window Configuring the Active Upgrade Process Main WindowStatus Bar Main Window Activity Log10. Status Bar Chapter Configuring the Active Upgrade Process Creating and Managing Configuration FilesCreating a Configuration File Loading a Configuration File Editing an Existing Configuration File Performing an Upgrade with No Configuration FileSaving a Configuration File Selecting Disks to UpgradeTo save the current configuration file Hard Disk Color Coding Description Selecting Other Configurations to Include To select system and data disksTo call a child configuration file into the current file Selecting Application Services to Control Selecting Event Log Files to Back Up To preserve event log files Configuring Custom Actions To configure a custom action Control Types for Custom Actions PurposeBackup Timing for the Advanced Control Type PurposeProgramming Notes for Custom Actions Starting and Stopping ApplicationsUsing Active Upgrade Environment Variables Environment Variables for Custom Actions DescriptionViewing Standard Output and Error Stream Generating Exit Values18Express5800/320Fc Active Upgrade User’s Guide Providing a Description for a Configuration File Displaying the Upgrade SummaryDisplaying the Upgrade Summary Click Retry on the Active Upgrade Performing a Readiness CheckActivity Log Entries Icon Text Color Severity Description Splitting the System Click Split on the Active Upgrade To split the systemManaging Upgrade Tasks on the Upgrade Side Connecting to the Desktop on the Upgrade Side Remote KVMConnecting to the Upgrade Side with Remote KVM To initiate a Remote KVM session with the Upgrade SideTo terminate a Remote KVM session with the Upgrade Side Connecting to the Upgrade Side with Remote DesktopTo terminate a Remote Desktop Connection to the Upgrade Side Running Software Installation Programs Windows Automatic UpdatesTo apply the downloaded updates Select Custom Install and click NextOther Installation Packages Restarting the Upgrade SideTo manually restart the Upgrade Side Managing Your Applications on the Production Side Verifying the Upgrade Side Before Merging the System Merging the SystemTo merge the system Verifying the Upgrade Side Before Committing the Upgrade Committing the Upgrade Aborting the Upgrade Finishing the Upgrade Viewing Active Upgrade Process Status Activity LogActivity Log in Active Upgrade Console Activity Log Entries Icon Text Color Severity Description Activity Log Detail Status Bar Status Hardware State DescriptionStatus Upgrade State Description Status Operational State DescriptionStatus Partner State Partner State DescriptionPage Saving the Activity Log to a File To save the activity log to a fileVerifying the Status of Application Services To verify the status of a serviceVerifying the Status of Installed Software Service Control Manager Add or Remove Programs Control Panel Verifying If RDR Disks Are Resynchronizing General Problems and Solutions Troubleshooting Readiness Check Error ActionTroubleshooting Readiness Check Troubleshooting Custom Actions Error Troubleshooting Miscellaneous Problems Error/Problem ActionTroubleshooting Miscellaneous Problems Getting Help Child configuration Active Upgrade technologyApplication service Commit upgradeCritical system resource Configuration fileDuplex mode duplexed Custom actionInstallation program Fault-tolerant modeHigh priority update hotfix EnclosureMerge system Nesting nested configuration filesParent configuration Persistent data fileSplit mode ServiceSimplex mode simplexed SessionUpgrade Side VolumeIndexIndex Index Index Index-4Express5800/320Fc Active Upgrade User’s Guide Index Index Index-6Express5800/320Fc Active Upgrade User’s Guide