NEC 320Fc manual To configure a custom action, Control Types for Custom Actions Purpose

Page 63

Configuring Custom Actions

2.Executable files for custom actions must be located on a system disk. If a executable file is located on an external or network disk, the Upgrade Side loses access to the file while the system is in split mode.

3.For information about writing your own programs for custom actions, see “Programming Notes for Custom Actions” on page 3-15.

To configure a custom action

1.On the Custom Actions page, do one of the following:

Next to File, type the full path name and file name of the executable file you want to run. (The file must already exist on the system.) For example:

C:\bin\mybatchfile.bat

Click Browse to locate the executable file using a file browser. Click the file name in the file browser, then click Open to select the file.

2.Next to Arguments, type any arguments that you need to run with your executable file.

No arguments are required; however, see “Programming Notes for Custom Actions” on page 3-15for information about optionally passing Active Upgrade environment variables to your executable file.

3.In the drop-down list for Control type, select the option that best describes when the Active Upgrade console should execute your custom action, as described in Table 3-3.

Table 3-3. Control Types for Custom Actions

Control Type

Purpose

 

 

Start Application

Executes the custom action whenever the Active Upgrade console

 

needs to start applications. For example, the console needs to restart

 

applications on the Upgrade Side when you merge the system.

 

 

Stop Application

Executes the custom action whenever the Active Upgrade console

 

needs to stop applications. For example, the console needs to stop

 

applications on the Upgrade Side when you split the system. It also

 

stops applications on the Production Side when you merge the

 

system.

 

 

Readiness Check

Executes the custom action once during the readiness check, before

 

you initiate the Active Upgrade process. This control type allows you

 

to build your own verifications into the readiness check.

 

 

Configuring the Active Upgrade Process 3-13

Image 63 Contents
Express5800/320Fc Active Upgrade User’s Guide Manual Name Express5800/320Fc Active Upgrade User’s Guide Contents Troubleshooting Performing the UpgradeIndex GlossaryFigures Tables Tables Vi Express5800/320Fc Active Upgrade User’s Guide Purpose of This Manual AudienceNotation Conventions R N I N G U T I O N Typographical ConventionsCall the RegisterDeviceNotification function Http//support.microsoft.com Getting HelpPreface Express5800/320Fc Active Upgrade User’s Guide Chapter Overview FeaturesRelated Topics Overview of the Active Upgrade ProcessMirror Duplexed System4Express5800/320Fc Active Upgrade User’s Guide Merged System Committing the Upgrade Aborting the Active Upgrade ProcessAborting the Upgrade Active Upgrade State Model Active Upgrade State ModelT E Page Software Upgrade Support Chapter Preparing for the Active Upgrade ProcessSystem 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 Installing the Active Upgrade Software To install the Active Upgrade consoleOpen My Computer To configure Windows Firewall Configuring Windows Firewall for the Active Upgrade ProcessWindows Firewall Exceptions To set the enclosure with A-side power as primary Installing Java Runtime Environment Configuring IP address in Virtual Technician Module VTMChanging VTM IP address Configuring the VTM IP address Configuring the network for Remote KVM Connection b,cConfiguring the network for Remote Desktop Connection d,e Gathering Information Active Upgrade Process Worksheet Value Custom actions to run Log files to back up Copying Software Installation Packages to the System Configuring Windows Automatic UpdatesTo configure Automatic Updates Automatic Updates Control Panel Automatic Updates Icon in System Tray To verify the list of updatesStarting and Exiting the Active Upgrade Console Title Bar Understanding the Active Upgrade Console InterfaceNavigation Bar Navigation Bar ConfigurationNavigation Bar Active Upgrade Navigation Bar Links Main Window Main Window Configuring the Active Upgrade ProcessMain Window Activity Log Status Bar10. Status Bar Creating and Managing Configuration Files Chapter Configuring the Active Upgrade ProcessCreating a Configuration File Loading a Configuration File Performing an Upgrade with No Configuration File Editing an Existing Configuration FileSelecting Disks to Upgrade Saving a Configuration FileTo save the current configuration file Hard Disk Color Coding Description To select system and data disks Selecting Other Configurations to IncludeTo 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 Control Types for Custom Actions Purpose To configure a custom actionTiming for the Advanced Control Type Purpose BackupStarting and Stopping Applications Programming Notes for Custom ActionsEnvironment Variables for Custom Actions Description Using Active Upgrade Environment VariablesGenerating Exit Values Viewing Standard Output and Error Stream18Express5800/320Fc Active Upgrade User’s Guide Displaying the Upgrade Summary Providing a Description for a Configuration FileDisplaying the Upgrade Summary Performing a Readiness Check Click Retry on the Active UpgradeActivity Log Entries Icon Text Color Severity Description Splitting the System To split the system Click Split on the Active UpgradeManaging Upgrade Tasks on the Upgrade Side Remote KVM Connecting to the Desktop on the Upgrade SideTo initiate a Remote KVM session with the Upgrade Side Connecting to the Upgrade Side with Remote KVMConnecting to the Upgrade Side with Remote Desktop To terminate a Remote KVM session with the Upgrade SideTo terminate a Remote Desktop Connection to the Upgrade Side Windows Automatic Updates Running Software Installation ProgramsSelect Custom Install and click Next To apply the downloaded updatesRestarting the Upgrade Side Other Installation PackagesTo manually restart the Upgrade Side Managing Your Applications on the Production Side Merging the System Verifying the Upgrade Side Before Merging the SystemTo merge the system Verifying the Upgrade Side Before Committing the Upgrade Committing the Upgrade Aborting the Upgrade Finishing the Upgrade Activity Log Viewing Active Upgrade Process StatusActivity Log in Active Upgrade Console Activity Log Entries Icon Text Color Severity Description Activity Log Detail Status Hardware State Description Status BarStatus Operational State Description Status Upgrade State DescriptionPartner State Description Status Partner StatePage To save the activity log to a file Saving the Activity Log to a FileTo verify the status of a service Verifying the Status of Application ServicesService Control Manager Verifying the Status of Installed SoftwareAdd or Remove Programs Control Panel Verifying If RDR Disks Are Resynchronizing Troubleshooting Readiness Check Error Action General Problems and SolutionsTroubleshooting Readiness Check Troubleshooting Miscellaneous Problems Error/Problem Action Troubleshooting Custom Actions ErrorTroubleshooting Miscellaneous Problems Getting Help Commit upgrade Active Upgrade technologyApplication service Child configurationCustom action Configuration fileDuplex mode duplexed Critical system resourceEnclosure Fault-tolerant modeHigh priority update hotfix Installation programPersistent data file Nesting nested configuration filesParent configuration Merge systemSession ServiceSimplex mode simplexed Split modeVolume Upgrade SideIndexIndex Index Index Index-4Express5800/320Fc Active Upgrade User’s Guide Index Index Index-6Express5800/320Fc Active Upgrade User’s Guide