Equity Edge Diagnostic Utility

Equity Edge Diagnostic Utility The Equity Edge 7.0 release now supports the Equity Edge Diagnostic Utility (EEDU), a tool that you can use to troubleshoot the Equity Edge program. This chapter describes the Equity Edge Diagnostic Utility and how it can be used. It contains the following sections: About the Diagnostic Utility System Requirements Accessing the Utility Resolving Fixable Issues Dealing with Non-Fixable issues Exporting Diagnostics Data Installing an Equity Edge Database Update Scrambling Data Log Files 1

: Equity Edge Diagnostic Utility About the Diagnostic Utility The Equity Edge Diagnostic Utility (EEDU) is a tool that you can use to analyze the various components of the Equity Edge program machine, company database(s) associated with the Equity Edge program, connections, and the Equity Edge application itself. You can use the results of the analyses to troubleshoot any fixable issues that may arise in association with any of the component categories. This diagnostic tool can be installed on server and client machines for both Enterprise and Workgroup Editions of the Equity Edge program. Note that, if the same machine hosts both the client and server applications, the server conditions and messages take precedence over the client conditions and messages. The Equity Edge Diagnostic Utility provides you with the following functionality: Analyze: Use the Analyze functionality to take a snapshot of the current system (machine, database, connectivity, and application components). The results of an analysis identifies issues in the current state of the component that you are analyzing. Additionally, for each issue that it reports, the utility informs you whether it can or cannot fix that issue. Apply Fix: Use the Apply Fix functionality of the utility to correct those issues that the utility has identified as being fixable. Back Up: Use the Backup functionality of the utility to create a backup of your company database prior to applying any fixes on identified issues. The backup process in the Equity Edge Diagnostic Utility is identical to the backup process in Equity Edge. Note: You will need to use the Equity Edge program to restore the database from a backup file. Apply Update: Use the Apply Update functionality of the utility to install the various updates to a company database. Once you store an Equity Edge update in a specified directory, that update will be available for you to apply from within the Equity Edge Diagnostic Utility. When, from within the Equity Edge Diagnostic Utility you select an update and execute the Install Update function in the Equity Edge Diagnostic Utility, the utility will automatically apply the update to the Equity Edge database to which it is connected. Create a Scrambled Backup: Use the data scrambling function of the Equity Edge Diagnostic Utility to create a scrambled backup of your company s Equity Edge 6.2 and later versions of the Equity Edge program database. This function is especially useful in safeguarding non-public sensitive data associated with participants when you send your company s Equity Edge database to another location, for example, E*TRADE FINANCIAL s Corporate Support group. 2 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

About the Diagnostic Utility How Does the Diagnostic Utility Work? The Equity Edge Diagnostic Utility works to detect inconsistencies in the four main components of the Equity Edge program machine, database, connection, and application in the following manner. 1. The Equity Edge Diagnostic Utility runs on the server or the client machine as required by you. 2. When you run the Analyze option of the utility, it checks the available information about your Equity Edge configuration against the standard set of recommended configuration information. Note: This configuration will vary between Server and Client and between Enterprise and Workgroup Editions of Equity Edge. 3. The utility checks to see if the selected element is found, and issues a Not Found message if it fails to find the element. If the system element is found, the utility checks the version of the element (if applicable). 4. The utility provides a complete analysis of each inconsistency it encounters. It specifies whether the inconsistency is fixable or not, and displays a message based on the condition of the client or server (based upon your selection). 5. Wherever possible, the utility enables you to apply suitable corrective steps to address the related issue. 6. After reviewing the recommended corrective step, you can implement the corrective step by employing the Apply Fix option of the utility. 7. You can save the results of the diagnosis and the fixes that you made, and additionally generate related reports. Important! The Equity Edge Diagnostic Utility does not correct critical errors. For reviewing errors of this type, please contact your company s IT department and/or the Corporate Support staff at E*TRADE FINANCIAL Corporate Services. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 3

: Equity Edge Diagnostic Utility Example Analysis The following figure shows the results of an example analysis performed by the Equity Edge Diagnostic Utility. Component Selected For Analysis Details of Current Setup of Your Machine Indicator of Inconsistency Found by Utility Description of Inconsistency Figure 1 Details of an Example Analysis As the figure shows, for each component within each category selected for analysis, the Equity Edge Diagnostic Utility displays the setting or value it discovered in the current setup of Equity Edge on your system. The icon alerts you to every inconsistency in the component category selected for analysis. The final column indicates the details of the inconsistency detected by the utility. Where space limits a full description, the utility displays the complete details for an issue in a pop-up window (when you select the corresponding Issue icon). 4 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

About the Diagnostic Utility The Equity Edge Diagnostic Utility separates the inconsistencies into items that it can fix as Fixable and items that it cannot fix as Not Fixable. You may need to seek the help of the System Administrator at your installation for the items that the utility identifies as Not Fixable. You can select to resolve one/some/all of the issues that the utility has identified as being fixable. When the Equity Edge Diagnostic Utility completes its attempt to fix the issues that you have selected, it displays the results in the following window: Figure 2 Results of an Attempt to Resolve Selected Issues As shown infigure 2, of the three issues selected to be fixed, the utility was able to successfully resolve two issues related to database components Seed Data and Sequences. For each of these two components, the utility displays the entry Issue Fixed in the Result column and clears the corresponding Fix? checkbox. For the one issue in the above example that the utility did not fix, Invalid Objects, the utility displays in the Result column that the issue is not fixed and the Fix? checkbox continues to be selected for that entry. Whether you correct an issue with the help of the Equity Edge Diagnostic Utility, or otherwise, the corrections that result persist in the system. Subsequently, when you perform other analyses, the utility will display the updated values. Here is the display on analyzing the system after the utility resolved these issues. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 5

: Equity Edge Diagnostic Utility Figure 3 Example of Analysis Repeated After Resolving Issues When you compare the entries for Seed Data and Sequences in Figure 1 on page 4 with the entries in the above figure (Figure 2), you will see that the utility now no longer lists these two elements as issues to be resolved. Advantages of the Diagnostic Utility The Equity Edge Diagnostic Utility provides you with the following: Seamless incorporation of updates to Equity Edge database: You can use the File Database Apply Update command to apply updates to the company database. Diagnosis: You can run the Equity Edge Diagnostic Utility on the server or the client machine. If the client and the server are on the same machine, the server conditions and messages take precedence over the client conditions and messages. 6 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Security Data Integrity: Throughout the diagnosis and correction procedure, the utility maintains the integrity of the contents of your company database. The utility provides you with the command to back up your company database. Prior to applying a fix from within the Equity Edge Diagnostic Utility, you should back up the company s Equity Edge database. Note: If, after reviewing the fix, you desire to revert to the previous state of the company database, launch the Equity Edge program and use the File Database Restore command to restore the company s database. Internal Log: The Equity Edge Diagnostic Utility maintains an internal log file containing the set of internal errors (if any are encountered), and a complete record of each issue that you attempted to fix along with the timestamp of the attempt. If you attempt to fix a component more than once, the log file will maintain a record of the recurring attempts to fix the component. This internal log file is not accessible through the utility. Security Company Users of the Equity Edge program can log in to the Equity Edge Diagnostic Utility application. The following table lists the privileges based on the Company User profile: Table 1 Security Access Privileges for Equity Edge Diagnostic Utility Security Profile Analyze Apply Fix Backup Apply Update Company User (previously known as Equity Edge User) Yes No For Equity Edge 6.2 and earlier versions: Yes For Equity Edge 7.0 and later versions: If the Back Up checkbox has been selected in the Company User record No Company User who has System Security privilege Yes Yes Yes Yes Enterprise Edition Users Only: If the new Row-level Security feature has been enabled in the Equity Edge program, and you are assigned to a security group, you can resolve any issue by executing the Apply Fix function in the Equity Edge Diagnostic Utility. Note that, when the utility resolves an issue, that corrective step may affect all the related records in your Company database, not just those records in your Security Group. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 7

: Equity Edge Diagnostic Utility System Requirements In order to run the Equity Edge Diagnostic Utility you will require one of the following versions of Microsoft TM Windows platform: Windows NT 4.0 Workstation Windows 2000 Professional Windows XP Professional Windows 2003 Server Equity Edge Versions Supported The Equity Edge Diagnostic Utility is available for the following versions of Equity Edge software: Equity Edge 7.0: By default, the Equity Edge Diagnostic Utility is installed along with the installation of Equity Edge 7.0. Equity Edge versions prior to Equity Edge 7.0: The Equity Edge Diagnostic Utility is also available as a separate install package for Equity Edge 6.x versions. It is not available for Equity Edge versions prior to Equity Edge 6.0. Default Location for the Utility The Equity Edge installer routine installs the Equity Edge Diagnostic Utility program under <DRIVE>:\PROGRAM FILES\. Utility installed with the Equity Edge program: If the Equity Edge Diagnostic Utility is installed on the same machine as the Equity Edge program, the installer routine installs the utility in the same directory where it installs the Equity Edge program. By default, the Equity Edge Diagnostic Utility will be a separate executable under Equity Edge in the directory <DRIVE>:\PROGRAM FILES\EQUITY EDGE\EEDU. Utility installed as Independent package: If the Equity Edge Diagnostic Utility is installed as an independent package, the installer routine installs the utility in the directory that you specify. By default, the Equity Edge Diagnostic Utility will be available in the directory <DRIVE>:\PROGRAM FILES\EEDU. 8 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Accessing the Utility Accessing the Utility Initial Access As stated earlier, any Company User can log in to the Equity Edge Diagnostic Utility. In order to access the Equity Edge Diagnostic Utility: Locate the eedu.exe file in the directory where you have installed the diagnostic utility. Double-click on the entry for the eedu.exe file. Or, Select START PROGRAMS EQUITY EDGE EEDU if you have installed the utility under the Equity Edge folder. Otherwise, select START PROGRAMS EEDU. When you initially launch the Equity Edge Diagnostic Utility, and there is no information pertaining to a company database currently stored on your machine, the utility will display one of the following versions of the Connection Manager window: Figure 2 Connection Manager Window Requiring Information By Equity Edge Version Note that, in the above windows, you need to enter all the information required to access a company database. Ongoing Access When information exists for one or more company database(s), the utility will display one of the following Logon windows: 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 9

: Equity Edge Diagnostic Utility Figure 3 Logon Window Requiring Company User Record Information Note that, in the Logon windows shown above, the utility requires only the Equity Edge Username and Equity Edge Password associated with a Company User record. For the remaining fields, the utility defaults to the information associated with the most recently accessed company database from the Equity Edge program. Enter the required values in the appropriate window and select OK. (The fields on the windows are described under Input Fields For Connection Manager and Logon Windows on page 12.) If the Equity Edge Diagnostic Utility validates your input, the utility displays the main window where you can perform the necessary analysis: Figure 4 Main Window of the Equity Edge Diagnostic Utility (Including Database) In this version of the main window, the Equity Edge Diagnostic Utility can be used to perform an analysis of the components related to machine, database, connectivity, and application. 10 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Accessing the Utility Access without a Company Database When you select the Cancel button in the Connection Manager window or in the Logon window of the Equity Edge Diagnostic Utility, the utility displays the following main window: Figure 5 Main Window of the Equity Edge Diagnostic Utility (excluding Database) Note that in this version of the window, the utility does not display the System Component category called Database and it allows you to perform an analysis of the remaining three components. Additionally, the Exclude Database Structure Analysis checkbox (Figure 1) is not displayed in this version of the window. Such an analysis would be especially useful when you have not yet set up any database connections. For instance, you may want to run this utility on a personal computer to check if it meets the minimum hardware requirement and so on. For this type of access, you do not need not log in to a company database. The utility will provide you with an analysis of the current state of your machine with respect to machine components, connectivity, and application components. Error Conditions If the Equity Edge Diagnostic Utility is unable to validate your entries in the Connection Manager window or the Logon window, it will issue an appropriate error message. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 11

: Equity Edge Diagnostic Utility Input Fields For Connection Manager and Logon Windows The following table shows the status of the fields in the Logon window (Figure 2) and Connection Manager window (Figure 3): Table 2 Input Fields on the Logon and Connection Manager Windows Field on Window Equity Edge 7.0 (and later) Equity Edge 6.2 (and earlier) Equity Edge Username Equity Edge Password Required Entry; Enter Equity Edge User ID Required Entry; Enter Equity Edge Password Required Entry; Enter Equity Edge User ID Not required; Enter Equity Edge Password Equity Edge Version Required field; Select appropriate Equity Edge version from drop-down list Required field; Select appropriate Equity Edge version from drop-down list Database Username Database Password Company Schema Connection Name Not required; Blank Display Not required; Blank Display Required Entry; Enter appropriate Equity Edge Company/Schema Required Entry; Workgroup Users: Enter appropriate Database connection name Enterprise Users: Enter appropriate TNS connect string to the Oracle database server Required Field; Enter appropriate Database User ID Required Field; Enter appropriate Database Password Not required; Blank Display Required Entry; Workgroup Users: Enter appropriate Database connection name Enterprise Users: Enter appropriate TNS connect string to the Oracle database server Command Buttons in the Logon and Connection Manager Windows The Logon and Connection Manager windows have the following command buttons: OK: When you select OK, if you have provided valid entries, the Equity Edge Diagnostic Utility will log you in and display the main window as shown in Figure 4 on page 10. If your input values are not valid for any currently stored connection information, the utility will issue an appropriate error message. Cancel: As already described, the Cancel button displays the main window where you can analyze the non-database related components. 12 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Performing an Analysis Performing an Analysis The Equity Edge Database utility can be used to obtain a complete picture of the four main system components of the Equity Edge program machine, database, connection, and application. Alternately, you can launch the utility to perform analysis of the non-database components. In either scenario, you can also select specific component(s) of the system and limit your analysis. When you execute the Analyze function in the Equity Edge Diagnostic Utility, it provides you with the required analysis. You can save this analysis and review it using an appropriate text editor application. Steps to Perform an Analysis In order to analyze one or more components of the Equity Edge program, 1. Launch the Equity Edge Diagnostic Utility. Based on your input, the main window appears (as shown in Figure 4 and Figure 5). 2. Select the Analyze tab. 3. Select the checkbox(es) corresponding to the System Component(s) you wish to analyze. 4. If the client and the server both reside on the same machine, then, by default, the checkbox to analyze as Server is selected. Select whether you wish to analyze the client or the server aspect of the system. Figure 3 Components Selected For Analysis 5. Select the Analyze System command button. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 13

: Equity Edge Diagnostic Utility 6. The Equity Edge Diagnostic Utility begins the analysis of your selection(s). A progress bar appears as shown below: Figure 4 Status Bar Showing Progress of an Analysis Note: If you select Cancel during an Analyze operation, the utility will abort the analysis and return you to the Analyze tab. However, the utility will display the results for those items for which it was able to complete the analysis (before it aborted the attempt). 7. When the utility completes the analysis, it populates the Analyze tab with its findings: Figure 5 Results of a Sample Analysis 8. Select the Save button. The utility displays a Save As browser window. 14 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Performing an Analysis 9. Select an appropriate location (and if necessary, enter a different name) for the results of the current analysis. By default, the file is called Analyze.txt and is in text format. 10. Select OK. The Equity Edge Diagnostic Utility saves the current analysis under the name you provided and in the location you selected. It displays a Confirmation message as shown below: Figure 6 Confirmation Message Indicating Success in Storing Contents of an Analysis 11. Select OK to close this window. The Equity Edge Diagnostic Utility closes the dialog window and returns you to the Analyze tab of the utility for further action. Contents of the Analyze Tab Figure 7 Analyze tab The following window elements are displayed under the Analyze tab. System Information Grid Exclude Database Structure Analysis Checkbox 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 15

: Equity Edge Diagnostic Utility Analyze as Client Checkbox Analyze as Server Checkbox Analyze System Command Button Save Command Button The System Information is displayed under the following columns: System Components, Issue, Value, and Issue. System Components The System Components column lists the four component categories Machine, Database, Connectivity, and Application. Each System Component category is associated with a checkbox and an expandable field indicator with the icon. In order to view the items that belong to a component category, select on the icon. The diagnostic utility displays all the items in the category to which the selected icon belongs. (The + sign in the icon changes to a - sign.) By default, all the checkboxes are cleared. The diagnostic utility performs an analysis on a component category only if you have selected its corresponding checkbox. Issue (Icon) If an analysis discovers an inconsistency in one or more items in a component category, the Issue (Icon) column will display the icon both at the main level for the category and at the individual item level for which the inconsistency was found. Figure 8 Example of Database-Related Issues Discovered by an Analysis Note: When you save the contents of the System Information grid, the utility replaces each instance of the Issue icon with a Yes entry in the saved file. 16 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Performing an Analysis When you double-click on an Issue icon at the individual item level, the utility displays the corresponding details in a dialog box. For example, in the above window, the System Component entry called Missing Objects has an Issue icon and the corresponding entry in the Issue column reads Missing Objects (8). When the user double-clicks on the corresponding Issue icon (Missing Objects in the example), the utility displays the contents in a pop-up window named for the system component as shown below. When you see a hierarchical display as shown below, select each icon to expand that node in the hierarchy. Figure 9 Details of a Database Related Issue Select Close in the pop-up window to close it and return to the Analyze tab. Value For each individual item in a component category, the utility displays the current configuration as shown below. Figure 10 Example of the Contents of the Value Column for One Category 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 17

: Equity Edge Diagnostic Utility If there is an inconsistency, the utility displays the corresponding information as an issue. Issue (Details) The final column in the grid, Issue, displays the details of the inconsistency located at the individual item level in a selected component category. When the display details exceed the column width, the utility adds a... at the end of the text, as displayed for the Seed Data in Missing/changed seed data in RprtR... under the Issue column in Figure 11. When you double-click on the issue icon for such an entry, the utility displays the complete description in a pop-up window: Figure 11 Issue Details Expanded in Pop-up Window Select Close to close the pop-up window. Exclude Database Structure Analysis Checkbox This checkbox is displayed only if you are working with Equity Edge 7.0 database and later versions. By default, this checkbox is shown as selected, indicating that the program includes analysis of the database structure. Analysis of some database issues may tend to hang the Equity Edge Database Utility. As a result, in order to avoid this situation, clear the Exclude Database Structure Analysis checkbox before you execute an analysis. Analyze as Client (or Server) Checkboxes The two checkboxes Analyze as Client and Analyze as Server are mutually exclusive. If the client and server both reside on the same machine, then, by default, the Analyze as Server checkbox is selected. Select the required checkbox to perform the analysis on the client or the server machine. 18 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Fixable and Not Fixable Issues Command Buttons The Analyze tab contains the following command buttons: Analyze System: When you click the Analyze System command button, the diagnostic utility starts the analysis on the selected component category/categories. Save: When, after an analysis, you click the Save button, the diagnostic utility saves the results to a.txt file at a location specified by you. List of Diagnostic Messages A complete set of the diagnostic messages that the Equity Edge Diagnostic Utility displays can be found in the chapter titled Equity Edge Diagnostic Utility (Tables) in the Equity Edge 7.0 Supplement. Fixable and Not Fixable Issues The Equity Edge Diagnostic Utility breaks down inconsistencies into two categories: Fixable and Not Fixable. Fixable: The utility identifies an issue related to a System component as Fixable if it can resolve the inconsistency associated with that component. The Apply Fix function of the diagnostic utility is provided in order for you to easily resolve the inconsistency. Not Fixable: The Equity Edge Diagnostic Utility identifies an issue related to a System component as non-fixable, if it determines that the correction of the related inconsistency is beyond the scope of the utility. Such an issue will require further action on your part. For example, if the diagnostic utility detects that the Oracle client version at your installation is not the recommended version, it will not take any further action to correct this issue. In such a situation, you will need to contact the appropriate persons in your IT department and upgrade your system accordingly. In other situations associated with issues that are not fixable, you may need to contact the Corporate Support group of E*TRADE FINANCIAL Corporate Services. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 19

: Equity Edge Diagnostic Utility Resolving Fixable Issues The Apply Fix tab of the Equity Edge Diagnostic Utility displays the issues that the utility can fix. Beginning with the Equity Edge 7.0 release, the utility will display a cumulative record of all the issues that it has fixed. For the earlier versions of the Equity Edge program, the utility will display a cumulative record of all the issues that it has fixed for the duration of the current session only. The Equity Edge Diagnostic Utility enables the Apply Fix tab once it has completed an analysis. Steps to Resolve a Fixable Issue Figure 12 List of Fixable Issues Before you attempt to resolve any issue with the help of the Equity Edge Diagnostic Utility, check that your Equity Edge Company User record has been given the System Security privilege. Additionally, you should create a backup of your company s Equity Edge database before you proceed to resolve any issue with the help of the Equity Edge Diagnostic Utility. 20 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Resolving Fixable Issues The steps necessary to resolve an issue with the help of the utility are: 1. Select the Apply Fix Tab in the Equity Edge Diagnostic Utility. And within that tab, select the Fixable tab. The utility lists all the issues that the diagnostic utility has identified as fixable, and the component to which each issue belongs. As shown in Figure 12, if this is your initial attempt at applying a fix, the utility will not enable the Fixed tab at this time. This tab will be enabled once the utility succeeds in resolving an issue successfully. 2. By default, note that the utility displays the checkbox in the Fix? column as selected for every item displayed in the System Component column. Therefore, by default, the utility will attempt to fix every issue listed in the Fixable tab. If you do not wish to fix a specific issue at this time, clear the corresponding checkbox in the Fix? column for that issue. 3. Select the Apply Fix command button. 4. The diagnostic utility alerts you to create a backup of the Equity Edge database before proceeding with a correction. Figure 13 Warning to Back Up Database Before Reconciling an Issue To Create a Backup: If you have not already created a backup of your current company database, select No in the Back Up Warning window. Back up the company database as described in the section Installing an Equity Edge Database Update on page 32. Then select the Apply Fix command button. To Continue with the Apply Fix: Select Yes in the Back Up Warning window (see Figure 13). 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 21

: Equity Edge Diagnostic Utility 5. The diagnostic utility proceeds to resolve the issue(s) that you require fixed. A progress bar displays the status of the correction procedure. Note: If you select Cancel in this window, the utility will abort the correction procedure and return you to the Apply Fix tab. However, the utility will display the results for those items that it was able to fix (before it aborted the attempt.) 6. When the utility completes the correction procedure, it populates the Result column in the Fixable tab with the results of its actions. In addition, for each system component selected to be resolved, the utility displays a timestamp to identify when the utility attempted to resolve the issue. Figure 14 Results Displayed After Executing an Apply Fix Command Note that, once the utility has an entry in its record of issue(s) that it has fixed, the utility enables the Fixed tab in the above window. (Compare with Figure on page 20.) 7. Once you are satisfied with the results, if you wish to maintain a record of the results, select Save. A Save As browser window appears requiring you to select a location for the file. Select a location and, if necessary, a different name from the system default name fixable.txt for this file. 8. Select OK. The utility saves the contents of the display in the Fixable tab in a text file at the location and in the file you specified in the Save As window. 22 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Resolving Fixable Issues If you now return to the Analyze tab, select the component categories which you resolved, and select the Analyze System command, you will see the updated information in the resulting analysis. Figure 15 Results of Second Analysis (after resolving issues) For example, in the above figure, the entries in the Value and Issue columns for the two items, Seed Data and Sequences differ from what was shown by the utility before these issues were resolved ( Figure 5 on page 14). The following section describes the window elements of the Fixable tab. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 23

: Equity Edge Diagnostic Utility Contents of the Fixable Tab Figure 16 The Fixable Tab The Fixable tab displays the information relevant to the fixable issues, and the Select All, Clear All, Apply Fix, and Save command buttons. Fixable Issues The grid in the Fixable tab (Figure 16) displays the details of each fixable issue under the following columns: Fix?: This column entry contains a checkbox which displays as selected or cleared indicating whether or not an issue relating to a component is to be fixed by the utility. If there is an entry in the System Component column, then, by default, the utility will display the checkbox in the Fix? column as selected indicating that the issue is to be fixed. If you click Apply when this checkbox is selected for a corresponding entry in the System Component column, the utility will attempt to fix the issue relating to that component. System Component: The System Component column displays the individual component within the main categories Machine, Database, Connectivity, and Application with which the utility detected an issue. This entry can also be seen in the results under the Analyze tab as shown in Figure 5 on page 14. Issue: The Issue column displays the inconsistency that the diagnostic utility detected with respect to the corresponding entry in the system component. This entry can also be seen in the results of the analysis for the corresponding entry under the Analyze tab as shown in Figure 5 on page 14. 24 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Resolving Fixable Issues Double-click on an entry in the Issue column to view its full description. The utility displays a pop-up window named for the selected item, as shown here: Figure 17 Detail Shown For a Selected Issue Select the Close button in the pop-up window to close it. Result: The Equity Edge Diagnostic Utility populates the Result column after it completes an Apply Fix command given by you (when you select the Apply Fix button). Each entry in this column indicates whether the correction procedure was successful or unsuccessful. If the utility was successful in correcting the issue related to the selected system component, it displays the entry Issue Fixed in this column. Otherwise, the utility displays the entry Issue Not Fixed in this column for that component. TimeStamp: The Equity Edge Diagnostic Utility populates the Timestamp column after it completes an Apply Fix command given by you (when you select the Apply Fix button). Each date and time entry in this column is in MM/DD/YY HH:MM:SS AM or PM format and indicates when the utility attempted to resolve the corresponding issue. Command Buttons The Fixable tab in the Equity Edge Diagnostic Utility contains the following command buttons: Select All: When you choose the Select All command button, the utility selects every checkbox displayed in the Fix? column. When you now select Apply Fix, the utility will attempt to fix every item displayed in the System Component column. Clear All: When you choose the Clear All command button, the utility clears every checkbox displayed in the Fix? column, indicating that you do not require any issue displayed on the grid to be fixed. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 25

: Equity Edge Diagnostic Utility Apply Fix: The Apply Fix command button in the Fixable Tab will be disabled if your Equity Edge Company User record has not be provided with System Security privilege. When you choose the Apply Fix command button, the utility attempts to fix every issue for which you have selected the corresponding checkbox in the Fix? column. Save: When you choose the Save command button, the utility saves the contents of the current display in a text file at a location selected by you. The name of the file is based on the current tab: Fixable: The default name for the text file saved from the Fixable tab is Fixable.txt. Fixed: The default name for the text file saved from the Fixed tab is Fixed.txt. Not Fixable: The default name for the text file saved from the Not Fixable tab is NotFixable.txt. Reviewing Fixed Issues For Equity Edge 7.0 release, the Equity Edge Diagnostic Utility maintains a history of the corrections it successfully makes to the various components of the Equity Edge program. (For earlier versions of the Equity Edge program, the utility maintains the history only for the duration of a single session.) This history is presented in a grid format under the Fixed tab. Figure 18 Fixed Tab 26 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Reviewing Fixed Issues The contents of the Fixed grid are previously explained under Fixable Issues on page 24. You can save the contents of the grid by selecting the Save command button and specifying a desired location. History of Issues Corrected by Utility For Equity Edge release versions prior to the Equity Edge 7.0 release, the Equity Edge Diagnostic Utility maintains a history of the issues that you fixed only for the current session, that is until you log out of the utility. When you log out of the Equity Edge Diagnostic Utility, the utility discards that list of fixed issues along with the results of any analysis it displayed for the session. Beginning with the Equity Edge 7.0 release, the Equity Edge Diagnostic Utility maintains a history of the issues that you fixed until you delete the entries from the Fixed tab using the Clear table command. Clearing Correction History The Clear Table command will clear all the entries in the grid shown in the Fixed tab. When you select this command, the utility requests a confirmation by displaying the following dialog box: Figure 19 Confirmation Required to Clear Correction History Yes: Select Yes to clear the entries. The Equity Edge Diagnostic Utility will clear the entries permanently from the Fixed tab. No: Select No to revoke the Clear Table command and close the Clear Table Warning window. The Equity Edge Diagnostic Utility continues to maintain and display the list of fixed issues in the Fixed tab. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 27

: Equity Edge Diagnostic Utility Dealing with Non-Fixable issues As stated earlier, a non-fixable issue is one which the Equity Edge Diagnostic Utility will not attempt to correct. Such an issue will require further action on your part. When you perform an analysis, the diagnostic utility reports all such non-fixable issues in the grid under the Not Fixable tab, as shown below. Figure 20 Not Fixable Issues Grid The contents of the Not Fixable grid have been described earlier on page 24. As with the remaining results of any analysis displayed by the utility, these entries persist only for the duration of your current session. When you exit from the current session of the Equity Edge Diagnostic Utility, it discards the entries. In order to resolve the issues identified by the utility as being non-fixable, 1. Select the Save command button on this tab. The utility displays the Save As browser window. 2. Select a desired location, and, if necessary, provide another name to override the system default NotFixable.txt. 3. Select the Save command in the Save As browser window. Use an appropriate text editor application to access the contents of the saved file and take further action to resolve each issue. In most cases, your IT department will be able to assist you in reconciling the inconsistencies reported by the Equity Edge Diagnostic Utility. However, there may be instances where you will need to contact Corporate Support. 28 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Exporting Diagnostics Data Creating a Backup of Your Database The Equity Edge Diagnostic Utility is equipped with the backup function currently in Equity Edge. Steps to Create a Backup Using the Equity Edge Diagnostic Utility The Backup function will create a.dmp file and place it in a location specified by you. In order to create a backup of your company s Equity Edge database from within the Equity Edge Diagnostic Utility, 1. Select File Database Back Up. 2. The application prompts you to specify a folder for the backup in the Back Up To window. 3. Select a desired location for the destination folder. (For databases that need to be accessed by more than one Test Machine, save this backup file on a network location.) 4. Enter an appropriate name. Note that there should be no blank spaces in the name you specify for the backup file. 5. Choose the Save button. The backup is complete when the Database Backup is Complete message appears. Note: The backup is complete when the Database Backup Completed message appears. If you receive the Error 53 File not found error during the database backup, please contact your DBA and confirm that the Oracle client 9.2.0.6 is installed and that the Oracle Utilities exp.exe program is also installed. Exporting Diagnostics Data The Equity Edge Diagnostic Utility enables you to export the diagnostic data through a set of reports. When you select a report for export, the utility opens the selected file in the window of an appropriate text editor application. The exports contain the information displayed in each of the tabs in the utility. Each report includes the date and time at which it was created. If there is no data available for a selected report, the Equity Edge Diagnostic Utility displays the message, No data found. The individual exports are: Analyze: The Analyze export contains the information displayed when you select the Analyze tab in the utility. Apply Fix-Fixable: The Apply Fix-Fixable export contains the information displayed when you select the Fixable tab under the Apply Fix tab in the utility. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 29

: Equity Edge Diagnostic Utility Apply Fix-Fixed: The Apply Fix-Fixed export contains the information displayed when you select the Fixed tab under the Apply Fix tab in the utility. Apply Fix-Not Fixable: The Apply Fix-Not Fixable export contains the information displayed when you select the Not Fixable tab under the Apply Fix tab in the utility. Combine All: This export combines all the above reports. If there is no data under any of the groups, the report displays no data under each section. Steps to Create an Export In order to create an export of the values displayed by the utility, 1. Select File Export. The File Export window appears as shown below. Figure 21 File Export window 2. Select the required file to export from the drop-down list for the Report Title field. 3. Select the Export Preview command. The utility opens the selected file in the window of an appropriate text editor application as shown below: Figure 22 Fixable Export 4. Use the text editor application commands to save the exported text file, if necessary. 5. Close the text editor application window to return to the Equity Edge Diagnostic Utility. 30 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Exporting Diagnostics Data File Export Window The File Export window contains the following elements: Report Title: This is a drop-down list of the set of reports available from the diagnostic utility. The available selections are: Combine All: Combines the data from all the reports available in the utility into one report. Analyze: Export the details of the current analysis displayed in the Analyze tab. Apply Fix - Fixable: Export the details of the fixable issues as currently displayed in the Fixable tab. Apply Fix - Fixed: Export the details of the issues that were fixed by the diagnostic utility as currently displayed in the Fixed tab. Apply Fix - Not Fixable: Export the details of the issues that cannot be fixed by the utility as currently displayed in the Not Fixable tab. Export Preview: This command button displays a preview of the selected report output. The preview is displayed in the window of an appropriate text editor application. Close: The Close button closes the File Export window. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 31

: Equity Edge Diagnostic Utility Installing an Equity Edge Database Update The Equity Edge Diagnostic Utility also successfully installs updates to the Equity Edge 7.0 database and maintains an internal history of the updates that it applies. If you are working with a version of the Equity Edge database prior to Equity Edge 7, the program disables the required command from the File menu, as shown below: The utility will not install an update if that update is out of sequence. For example, if the current version of your company s Equity Edge database is 7.0.1, and if the Equity Edge Diagnostic Utility detects that you have not installed the 7.0.2 update version, it will not install an update with a version number 7.0.3. Important! This feature is available only for Equity Edge versions beginning with Equity Edge 7.0. Security In order to be able to install an Equity Edge database update with the Equity Edge Diagnostic Utility you need to have the appropriate security profile with System Security Administrator privilege. Important! When a Company user is attempting to correct an issue with the help of the Equity Edge Diagnostic Utility, no other Company user should access that Equity Edge database at the same time. The corrections made by the diagnostic utility may affect some or all of the accounts in the Company database. Types of Updates The Equity Edge Diagnostic Utility installs two types of updates General Equity Edge database updates and Customer-specific database updates. 32 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Installing an Equity Edge Database Update General Equity Edge Database Updates The General Equity Edge database updates result from changes that address general issues common to all customers and that affect the general schema. Whenever there is a new update, it will be made available for you to download from the Corporate Services website at https:// us.etrade.com/e/t/corporateservices. The Equity Edge Diagnostic Utility specifies the location where you need to place these updates when you download them from the website. (This is described in Required Storage Location For All Downloaded Updates on page 33.) General Equity Edge database updates are named as EEDBUpdateX.Y.Zsql or EEDBUpdateX.Ysql and so on (for example, EEDBUpdate7.0.2sql or EEDBUpdate7.1sql). The Equity Edge Diagnostic Utility installs each general Equity Edge database update only once. Customer-specific Equity Edge Database Updates Customer-specific Equity Edge database updates may result when a very specific change is made to address an issue relating to an individual customer s Company database. Such an update is made available only to the specific client for whom it was created and is not available from the Corporate Services website. You need to copy such an update to the same location that the Equity Edge Diagnostic Utility specifies for the general Equity Edge database updates. (This is described in Required Storage Location For All Downloaded Updates on page 33.) Customer-specific Equity Edge database updates are named as EEDBUpdateX.Y.Z.Csql (for example, EEDBUpdate7.0.1.2sql or EEDBUpdate7.1.0.3sql). In some instances, a Customer-specific Equity Edge database update file will be enabled to be installed multiple times. You can install such a Customer-specific Equity Edge update more than once, as is necessary. The Equity Edge Diagnostic Utility will maintain and display the count of the number of times that it has installed such a Customer-specific Equity Edge database update. Required Storage Location For All Downloaded Updates The installer routine creates a special directory called EEDU Updates under the EEDU directory. The Equity Edge Diagnostic Utility specifies this directory as the location where you must place the updates you download from the website or the customer-specific updates created to meet your special requirement. You should locate the updates that you download into the EEDU Updates only. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 33

: Equity Edge Diagnostic Utility Note: In order for the Equity Edge Diagnostic Utility to install your updates, you must use only the specified (EEDU Updates) directory to store the updates that you download from E*TRADE FINANCIAL s corporate service s website. Downloading an Equity Edge Update In order to download an update to the Equity Edge 7.X database, 1. Locate the required update in the E*TRADE FINANCIAL s Corporate Website: a) The installer file for each update will be located at the Corporate Services website at https://us.etrade.com/e/t/corporateservices. b) The installer file for the update will be located under the appropriate folder, for example EEDBUpdate7.1sql. c) In order to be able to download the installer file, enter your contact information and the access code provided by E*TRADE FINACIAL Corporate Support or the implementation team. 2. Check to see if the update you plan to download is in a compressed format (that is, the file name is EEDBUpdateX.Ysql.zip). Important! The Equity Edge Diagnostic Utility will not install updates that are stored as compressed files. Place only the extracted file in the EEDU Updates folder. Update in Compressed Format: If, for any reason, you receive an update that has been compressed then, a) Download the compressed file to another location (and not the EEDU Updates folder). b) Use the WinZip application to extract the update file (for example EEDBUpdateX.Ysql file.). 3. Save the extracted update file (for example, the EEDBUpdate7.1sql) in the required EEDU Updates folder on your computer. The EEDU Updates directory on your computer now contains the currently downloaded update to the Equity Edge database. 34 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Installing an Equity Edge Database Update Applying an Equity Edge Update Figure 23 Install Update Screen (Initial and Example Views) Initially, when you have not installed any updates through the Equity Edge Diagnostic Utility, you will see the screen shown on the left in the above figure. Once you have downloaded Equity Edge update(s), you will see the window populated by the names of the update(s) located in the EEDU Updates folder. Note that, the utility checks the EEDU Updates folder and displays the contents in the appropriate section of the Apply Equity Edge Update window. The figure on the right shows that there are two updates that are located in the EEDU Updates folder and available for installation. While both the updates are available to be installed, one of them EEDBUpdate7.0.3sql cannot be installed because the utility detects that the user needs to install another update before installing this update. In order to apply an Equity Edge update, 1. Ascertain that you have downloaded the required update(s) into the EEDU Updates directory. (Note that, if the downloaded update was in a compressed format, only the extracted file should be placed in this location.) 2. Ensure that, at the time you plan to install the update(s), no other Company User is logged into the Equity Edge database to which you are attempting to apply the update. 3. Start the Equity Edge Diagnostic Utility, if necessary. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 35

: Equity Edge Diagnostic Utility 4. Select File Database Apply Update. The Equity Edge Diagnostic Utility displays the Apply Equity Edge Update window as shown below: Figure 24 Apply Equity Edge Update (Example) 5. Select the Install Updates command button. 6. The Equity Edge Diagnostic Utility checks whether each update in the set of available updates is the next valid update in the sequence of updates. 7. If the selected update is valid, the utility proceeds with the update. 8. On successful completion, the utility updates the display to indicate the updated status. Error Conditions The Apply Update function will fail if the selected update is out of sequence and the utility determines that it is not the next to be applied. In such a situation, the Equity Edge Diagnostic Utility will display a warning. The following section describes the contents of the Apply Equity Edge Update window. 36 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Installing an Equity Edge Database Update Apply Equity Edge Update Window Figure 25 Apply Equity Edge Update window (at start) The Apply Equity Edge Update window contains two display sections Available Equity Edge Updates and Installed Equity Edge Updates and the Install Updates and Close command buttons. The program lists the general and any customer-specific Equity Edge database updates sorted in ascending order. Available Equity Edge Updates: The Available Equity Edge Updates section provides you with a sorted display of the General Equity Edge database updates and any Customerspecific Equity Edge database update packages that you have placed in the EEDU Updates folder. For each entry in this section, the utility displays a brief description of each package, and its status indicating whether the update is ready to install or it is not the next in sequence for installation (Incorrect Update). Once the Equity Edge Diagnostic Utility successfully installs a General Equity Edge update, it removes that entry from this section and displays it in the Installed Equity Edge Updates section. However, if a Customer-specific Equity Edge Update has been enabled to be installed more than once, it is retained in the Available Equity Edge section even after the utility has installed the update successfully. This is to enable you to repeat the custom update, if necessary. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 37

: Equity Edge Diagnostic Utility Installed Equity Edge Updates: The Installed Equity Edge Updates section displays a list of the updates that you have already installed, a brief description of each package, and the timestamp of when it was installed. Update Name: This column contains the name of each Equity Edge update that you have downloaded into the EEDU Updates folder. The names are displayed sorted in ascending order. General Equity Edge updates: The names of General Equity Edge updates will appear in the Available Equity Edge Updates section only until you install them. Each entry will appear in the Installed Equity Edge Updates section after the utility has successfully installed the update. Customer-specific Equity Edge updates: The names of Customer-specific Equity Edge updates will appear in the Available Equity Edge Updates section even after you have completed installing them. The utility displays the name of each installed Customer-specific Equity Edge Update in the Installed Equity Edge Updates section. If you install a Customer-specific Equity Edge Update more than once, the utility will add a number to the name it displays in the Installed Equity Edge Updates section. For example, if you installed the EEDBUpdate7.0.1.1.sql update thrice, the utility will display the Update name as EEDBUpdate7.0.1.1.sql(3) to indicate that it has installed this update three times. Here is an example: Note: Once you are satisfied with the result of a Customer-specific update, move the file from the EEDU Updates folder to another folder. Create a folder specifically for this purpose. Update Description: This column displays a short description for the update. 38 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data Status: This column displays in the Available Equity Edge Updates section. Each entry indicates the status of the corresponding update. If an update is the next in sequence, the utility will show the status of that update as ready to be installed by the Equity Edge Diagnostic Utility. If an update is not the next in the current sequence of updates, the utility will display the status for this entry as Incorrect Update. Installation Date: This column displays in the Installed Equity Edge Updates section. Each entry indicates the date and time that the utility installed the corresponding update. When a Customer-specific Equity Edge Update has been installed more then once, this column will contain the timestamp of the most recent install. Install Updates: Initially, and until you download an Equity Edge update to the required folder, the Install Updates command button will be disabled as shown above in Figure 25. The utility will enable this button when there is an update file in the required directory, as shown in Figure 24 on page 36. The Install Updates command button launches the database installation for the updates listed in the Available Equity Edge Updates section. Close: The Close button closes the Apply Equity Edge Updates window. Scrambling Data You can use the Equity Edge Diagnostic Utility to create a scrambled backup of your company s Equity Edge 6.2 and later versions of the Equity Edge program database. This function is especially useful in safeguarding non-public sensitive data associated with participants when you send your company s Equity Edge database to another location, for example, E*TRADE FINANCIAL s Corporate Support. About the Data Scrambling Function The main features of the data scrambling function are: Equity Edge Versions Supported: The Equity Edge Diagnostic Utility will create scrambled backup files only for Equity Edge databases associated with Equity Edge 6.2 and later releases of the Equity Edge program. Input: The Equity Edge Diagnostic Utility accepts a.dmp file that you have created from an Equity Edge 6.2 or later version of the Equity Edge program database. Additionally, you should be logged into the Equity Edge Diagnostic Utility with the same version of the Equity Edge database as the version from which the input.dmp file was created. Temporary Workspace for Enterprise Edition: If you use the Enterprise Edition of the Equity Edge program, the Equity Edge Diagnostic Utility requires you to provide a temporary workspace schema for the duration of the execution of the data scrambling process. (For Workgroup Editions of the Equity Edge program, the utility will create the 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 39

: Equity Edge Diagnostic Utility necessary temporary workspace schema.) This temporary workspace schema should not contain any objects. Additionally, this schema should reside on the same database server you used to log in to the Equity Edge Diagnostic Utility. Before scrambling the data in the.dmp file that you provide, the program restores that data into the blank temporary workspace schema provided by you (Enterprise Edition), or one that the utility creates (Workgroup Edition). Treatment of Custom Objects (Enterprise Edition): If you are using the Enterprise Edition, during the course of your work with your current Equity Edge program database, you may have made additions to the database (for example, the addition of a Table, a View, or a Trigger) that will make your current schema different from the schema provided by E*TRADE FINANCIAL at the time of installation. The Equity Edge Diagnostic Utility identifies these additions to the installation schema as Custom objects, and, for the purpose of the data scrambling, removes these non-standard objects. The utility checks your restored database schema for all such Custom objects and deletes them from your input data before it proceeds with the data scrambling process. Data Scrambled: The Equity Edge Diagnostic Utility does not scramble every piece of information in your company s Equity Edge database. For a list of the Equity Edge data fields that the utility scrambles, see the chapter titled Equity Edge Diagnostic Utility (Tables) in the Equity Edge 7.0 Supplement. Output location: The Equity Edge Diagnostic Utility will store the backup of the scrambled database in a location and under a name specified by you. Important! The scrambling cannot be undone. Prerequisites In order for you to be able to scramble the data in the backup file of an Equity Edge database with the help of the Equity Edge Diagnostic Utility, your Company User record needs to have the privilege to create a backup of the Equity Edge database. For Users of Equity Edge 6.2 (Enterprise and Workgroup) If you are working with a Equity Edge 6.2 database, only a company user with the Admin privilege is able to create a backup of your company s Equity Edge database. As a result, only company users with the Admin privilege can create a scrambled backup of your company s Equity Edge database. For Users of Equity Edge 7.0 (Enterprise and Workgroup) If you are working with a Equity Edge 7.x database, your Company User record should have been granted the Back Up privilege from within the Equity Edge program. 40 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data Figure 26 Backup Privilege Required to Create Scrambled Backup Access the Security module within the Equity Edge program and view your Company User record using either the Company User Open Stack or the Company User Profile window. Check that the checkbox named Back Up under General Functionality is selected as shown above in Figure 26. For Enterprise Edition Users (7.0 and Later Releases) In order to successfully scramble the backup of your company s Equity Edge database, the Equity Edge Diagnostic Utility will require a temporary workspace schema for its use. This temporary workspace schema should be a blank schema, (that is, it should not contain any objects). In addition, this temporary schema should reside on the same database server as the Equity Edge database to which you are logged in from the Equity Edge Diagnostic Utility. For example, if you are logged in to the Equity Edge Diagnostic Utility with an Equity Edge 7.0 database and the server connection name is "ushdqtrsfingrp", the temporary workspace schema must also reside on that same server ushdqtrsfingrp. Your Oracle database administrator needs to provide you with the following necessary pieces of information: Name of a temporary workspace schema: The Equity Edge Diagnostic Utility requires the name of a temporary workspace schema that represents a blank schema with no objects in it. The Equity Edge Diagnostic Utility will check the schema referred to by the name you provided. If the Equity Edge Diagnostic Utility detects objects in that temporary workspace schema, it will issue a warning message and abort the data scrambling process. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 41

: Equity Edge Diagnostic Utility Password: Your Oracle database administrator should provide you with the password valid for this blank temporary workspace schema. If the Equity Edge Diagnostic Utility detects that the password you entered is not valid for the temporary schema name you provided, it will issue a warning message and abort the data scrambling process. Before you initiate the data scrambling, you should obtain the above information from your Oracle database administrator and keep this information readily available. Limitations The new Equity Edge Diagnostic Utility provides you with security protection by enabling you to scramble non-public participant information before you send the contents of your company s Equity Edge database to another location, for example, E*TRADE FINANCIAL s Corporate Support to research your issue. When the Equity Edge Diagnostic Utility creates a scrambled backup of your company s Equity Edge database that you provide, it will remove all identifying information from participant accounts, grants and so on, from that database. The following limitations will be present in the scrambled backup of the database: Row-level Security: This limitation will be present only if your company has the Enterprise Edition of Equity Edge 7.0 with the new Row-level Security feature enabled, and you are using this feature. Row-level Security will generally be based on fields that help to identify a participant, for example, Country, Account user-defined fields and so on. The data scrambling process will remove all such identifying information. As a result, when you access the data restored from such a scrambled backup, you will find that Row-level Security will no longer function as it did before. Audit Trail: This limitation will be present for both the Enterprise and Workgroup Editions of Equity Edge 7.0, if you have enabled the new Audit Trail feature. Before it scrambles the data, the Equity Edge Diagnostic Utility will clear the two tables associated with auditing information. As a result, if you access the data restored from such a scrambled backup, and attempt to create the Audit Log report, the report will not display any data. Note: If you are using Row-level Security or the Audit Trail feature, and your concerns cannot be resolved without sending in the unscrambled data, we recommend that you contact E*TRADE FINANCIAL s Corporate Support, for further assistance. 42 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data CSC Login Account: This limitation will be present for both the Enterprise and Workgroup Editions of Equity Edge 7.0, if you have access to the Exchange Manager from within the Equity Edge program and your Company User record contains CSC Connection information. In the course of the data scrambling process, the Equity Edge Diagnostic Utility will clear the details of your CSC account from the backup database. Warning! Data restored from a scrambled backup should not be sent to etrade.com. How the Utility Creates a Scrambled Backup The Equity Edge Diagnostic Utility creates a scrambled backup of your database in the following manner: It matches the Equity Edge database version of your input.dmp file against the version of the Equity Edge database with which you are currently logged into the utility. The data scrambling will proceed only if the two versions match. If the two versions do not match, the utility will issue a warning message to that effect and abort the data scrambling process. The utility will restore the data from your input.dmp file into the temporary workspace schema. If, for any reason, the utility is unable to restore the database from your input.dmp file, it will abort the data scrambling process. Once the database has been restored into the temporary workspace schema, the utility searches it for Custom objects, and deletes all such objects. The Equity Edge Diagnostic Utility then proceeds to scramble the data in the temporary workspace schema. Note that the data is merely scrambled and not altered in any other way. For a list of the fields that the utility scrambles, see Equity Edge Diagnostic Utility (Tables) in the Equity Edge 7.0 Supplement. The Equity Edge Diagnostic Utility makes appropriate entries in an internal log file during the actual scrambling of the data. When the scrambling is complete, the Equity Edge Diagnostic Utility checks the internal log file. If there was an error logged in that file, the utility aborts the data scrambling process at this point. It issues a warning to inform you that errors were encountered in the data scrambling, and does not create the scrambled output file. If there are no errors in the internal log file, the Equity Edge Diagnostic Utility proceeds to create a backup of the scrambled data in the temporary workspace schema. The utility saves this scrambled backup of the database as a.dmp file with the name provided by you and in the location specified by you. The utility then clears the temporary workspace and issues a message to inform you that it successfully created a scrambled backup of your input.dmp file. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 43

: Equity Edge Diagnostic Utility Steps to Create a Scrambled Backup Use the following steps to create a scrambled backup of your company s Equity Edge database: 1. Create a backup of the required Equity Edge database. This has been described earlier in Creating a Backup of Your Database on page 29. 2. If you are working with the Enterprise Edition of the Equity Edge program, check to make sure that you have the name of the temporary workspace schema (that is currently a blank schema) and the password associated with it. (These should have been provided by your Oracle database administrator.) 3. Log in to the Equity Edge Diagnostic Utility with the Equity Edge database version that corresponds to the version of the database whose backup (.dmp file) you are planning to scramble. 4. Select File Database Create Scrambled Backup from the main menu of the Equity Edge Diagnostic Utility. 5. You will see one of the following Create Scrambled Backup windows, depending upon the type of your Equity Edge installation. Figure 27 Create Scrambled Backup window (Workgroup Edition) Figure 28 Create Scrambled Backup window (Enterprise Edition) 44 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data 6. Provide the Input the backup file you wish to encrypt. Choose the Browse button corresponding to the Input File entry on this window. The Equity Edge Diagnostic Utility displays the EEDU Data Scrambling Select Input File window. a) Locate the required backup file. b) Check that the pathname for this input file does not contain blank spaces. c) Select Open. 7. Specify the Output the name and location for the scrambled backup that the Equity Edge Diagnostic Utility will create. Note the following: The pathname for the Output file should not contain blank spaces. The name for the Output file should be distinct from the name of the input file. The Equity Edge Diagnostic Utility will not allow the scrambled backup to be saved under the same name as the input file. The specified location should not contain another file with the same name. Choose the Browse button corresponding to the Output File entry on this window. The Equity Edge Diagnostic Utility displays the EEDU Data Scrambling Provide Input File window. a) Select the desired location for the scrambled backup. b) Enter the name of the scrambled backup file to be created by the utility. c) Select Save. If the Equity Edge Diagnostic Utility finds another file with the same name at the specified location, it will issue the following warning that the existing file may be overwritten by the file being created. Select Yes to replace the existing file. Select No to close this message window and provide another name for the output file. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 45

: Equity Edge Diagnostic Utility 8. Enterprise Edition Users Only: At this point, provide the details of the temporary workspace schema, using the information provided by your Oracle database administrator. Temporary Schema Name: Enter the name of a valid, blank temporary schema that resides on the same database server as the Equity Edge database with which you logged into the utility. Password: Enter the password associated with the temporary workspace schema. Note: For Workgroup Editions, the Equity Edge Diagnostic Utility creates the required temporary schema. 9. The utility enables the Start button as shown below. Figure 29 Create Scrambled Backup window (Start enabled) 10. Check the entries in the Create Scrambled Backup window. 11. Select the Start button. Before the utility begins the creation of the scrambled backup of your input file, it displays the following message, requiring confirmation: Figure 30 Confirmation Required to Start the Data Scramble 12. If you wish to continue with the data scramble process, select Yes. If you wish to stop the process, select No. The Equity Edge Diagnostic Utility proceeds to create the scrambled backup of the input.dmp file provided by you. 46 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data If the utility is able to create a scrambled backup of the input.dmp file, you will see the following message: Figure 31 Message Displayed for Successful Completion of Data Scrambling The following section describes the elements of the Create Scrambled Backup window. Create Scrambled Backup Window Figure 32 Create Scrambled Backup Window at Start (Enterprise Edition) The Create Scrambled Backup windows for the two editions Workgroup and Enterprise are similar. Input File: This is a read-only display. Select the.dmp file for which you wish to create a scrambled backup. The corresponding Browse button enables access to the Data Scramble Select Input File window which you can use to locate the required file. Note that the pathname for the.dmp file must not contain any spaces. Output File: Provide the name and location for the scrambled version of the backup file. The corresponding Browse button enables access to the Data Scramble Provide Output File window which you can use to locate the folder where you wish to place the scrambled backup. Enter the name for the scrambled backup in this location. Note that the pathname must not contain any spaces. Additionally, check that the name of the Output file is distinct from the name of the Input file. The Equity Edge Diagnostic Utility will not allow the scrambled backup to be saved under the same name as the input file. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 47

: Equity Edge Diagnostic Utility the location you specify does not currently contain a file with the same name. If such a file exists, the utility will issue a warning that the existing file may be replaced by the file being created. Browse: The Browse button displays the Data Scramble Select Input File or the Data Scramble Provide Output File window. Temporary Schema Name: This field is available only for Enterprise Edition users. Enter a name for a temporary schema that currently does not contain any object. Additionally, it should reside on the same database server as the Equity Edge database with which you logged into the utility. (This schema name should have been provided to you by your Oracle database administrator.) Password: This field is available only for Enterprise Edition users. Enter a valid password associated with the temporary workspace schema name. (This should also have been provided to you by your Oracle database administrator.) Start: The Start command button will launch a confirmation window requesting you to confirm that you wish to start the data scrambling process. The Yes command button triggers the start of the data scramble process. The No command button closes this window and returns you to the Create Scrambled Backup window. Cancel: The Cancel command button will discard the entries in the Create Scrambled Backup window and return you to the main window of the Equity Edge Diagnostic Utility. Once the utility begins to scramble the data, the utility disables the Cancel button. Restoring Data From a Scrambled Backup As stated earlier, the data scrambling function is meant to assist you in providing sensitive data in a secure manner to E*TRADE FINANCIAL s Corporate Support group for analyzing any issue with your company s Equity Edge database. The Equity Edge Diagnostic Utility, during the process of scrambling the backup of your Company s Equity Edge database, will delete all Custom objects, Row-level Security related information (if any), Audit Trail information (if any), and other participant information that is not public in nature. As a result, the database restored from the scrambled backup.dmp file will no longer reflect the exact state of the database in the.dmp file that you provided to the Equity Edge Diagnostic Utility. Important!We recommend that you should not restore any data scrambled by the Equity Edge Diagnostic Utility for use in your company s production database. 48 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Scrambling Data Error Conditions If, while attempting to create a scrambled backup of your company s Equity Edge database, the Equity Edge Diagnostic Utility encounters any of the errors described below, it will issue an appropriate error message and abort the attempt to create the scrambled backup. The errors are: Equity Edge Version Not Supported Mismatched Database Versions Temporary Workspace Schema Not Accessible Temporary Workspace Schema Not Blank Errors During the Data Scrambling Process Equity Edge Version Not Supported The Equity Edge Diagnostic Utility will scramble the backups created from an Equity Edge Equity database that is associated with Equity Edge 6.2 and later releases of the Equity Edge program. If the utility discovers that you have provided it with the backup of an Equity Edge database prior to the Equity Edge 6.2 release, it will issue the following message: Figure 33 Message Indicating Version of Input Database is Incorrect Mismatched Database Versions The Equity Edge version for your input.dmp file must match the version of the Equity Edge database with which you currently logged into the Equity Edge Diagnostic Utility. If the utility discovers a discrepancy between the two versions, it will display the following message: Figure 34 Message Indicating Database Versions are Mismatched 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 49

: Equity Edge Diagnostic Utility Temporary Workspace Schema Not Accessible The Equity Edge Diagnostic Utility should be able to login to the temporary workspace schema. Enterprise Edition user: The name and password for the temporary workspace schema provided by your Oracle database administrator must be valid. For an invalid entry of the name and/or password, the utility displays the following message: Unable to login into temporary schema, please provide correct schema name/password. If you see this message, obtain the correct schema name and password from your Oracle database administrator. Workgroup Edition user: The utility should be able to log in to the database with the SYSTEM account. If the account details are invalid, the utility displays the message: If you see this message, obtain the correct schema name and password from your System administrator. Temporary Workspace Schema Not Blank The Equity Edge Diagnostic Utility requires that the temporary workspace schema contain no objects for it to restore the input.dmp file into that object. Enterprise Edition user: The temporary workspace schema provided by your Oracle database administrator must not contain any objects. If the schema is populated, the utility displays the following message: If you see this message, contact your Oracle database administrator and obtain the name and password for a temporary workspace schema that is blank. 50 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Log Files Workgroup Edition user: The utility should be able to create a workspace called <<Current Schema>>_EETemp, based on your current schema. If the utility discovers a schema with the identical name, it displays the message: If you see this message, call E*TRADE FINANCIAL s Corporate Support for further assistance. Errors During the Data Scrambling Process The utility creates a log file in which it enters messages during the data scrambling process. Once the scrambling of the data restored into the temporary workspace schema is complete, the utility checks this internal log file for errors. If there are any errors, the Equity Edge Diagnostic Utility will not create a backup of the scrambled data. It displays the following message: For more on the log file associated with this message, see Log File For Data Scrambling on page 53. Log Files The Equity Edge Diagnostic Utility maintains log files associated with the following: Apply Fix Data Scrambling Apply Updates Internal Errors The Equity Edge Diagnostic Utility creates each file at the first instance it requires to make a related entry in the corresponding file. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 51

: Equity Edge Diagnostic Utility Log File For Apply Fix The Equity Edge Diagnostic Utility maintains an internal log file in which it stores a history of every issue attempted to be fixed and the timestamp of the attempt. This log file is called ApplyFixInternalLog.txt. Figure 35 Contents of Log file pertaining to an Example Apply Fix Command The utility maintains only one instance of ApplyFixInternalLog. It appends the details from each attempt to resolve an issue to this file. When you choose the Apply Fix command button, the Equity Edge Diagnostic Utility inserts a timestamp to denote the beginning of the process. The utility enters the issues that were not resolved, followed by the fixed issues. It also enters the details for each issue. Location The Equity Edge Diagnostic Utility places the ApplyFixInternalLog.txt file in the directory called Log under the install directory for the utility. By default, the ApplyFixInternalLog.txt file is located in the directory called Log under C:\Program Files\Equity Edge\EEDU\Log. 52 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Log Files At the very first instance when the Equity Edge Diagnostic Utility executes an Apply Fix command, it looks for the parent Log folder under the install directory. If necessary, the utility creates the necessary Log folder, the ApplyFixInternalLog.txt file, and enters the details of the current error. If the Log folder contains the EEDUErrorLog.log file, the utility will access that file and append the details of the current error to it. Accessing ApplyFixInternalLog.txt The ApplyFixInternalLog.txt file is not accessible from the Equity Edge Diagnostic Utility application. View the contents of this file using an appropriate text editor application, as shown above in Figure 35. It is recommended that you do not rename or delete the ApplyFixInternalLog.txt file. Log File For Data Scrambling The Equity Edge Diagnostic Utility creates an internal log file in which it stores the details of every attempt that it makes to create a scrambled backup of your company s Equity Edge database. As stated earlier, after the utility completes the scrambling the data, it examines this file for error messages. If there are error messages, the utility will issue a warning and stop the process. It will not create the required output file the backup of the scrambled data. The utility names each log file by concatenating the temporary workspace schema name with the date and time of the data scrambling operation and giving it the.log extension, for example, EE62TempJun-14-06-18.02.02.log. The example name EE62TempJun-14-06-18.02.02.log indicates that the log file was created when the Equity Edge Diagnostic Utility created a scrambled backup at 18:02:02 hours on June 14 2006, using the temporary workspace schema called EE62Temp. (In this case the EE62Temp indicates an Equity Edge 6.2 database.) Viewing this file becomes necessary only when the Equity Edge Diagnostic Utility aborts the data scrambling operation with the message: Figure 36 Message Alert Indicating Failure to Scramble Data When you encounter this error, open the most recent log file with a text editor application and look for error messages. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 53

: Equity Edge Diagnostic Utility Location The Equity Edge Diagnostic Utility places the log file associated with a Create Scrambled Backup command in the directory called EEDUDataScrambleLog under the install directory for the utility. By default, if the utility is installed with the Equity Edge program, the directory called EEDUDataScrambleLog is located under C:\Program Files\Equity Edge\EEDU. Accessing the Log Files This log file, in text format, contains a series of messages entered by the data scrambling process as it works through the data in your input.dmp file. View the contents using an appropriate text editor application, as shown here: Figure 37 Example of Error Messages Entered During a Data Scramble Log File For Apply Updates The Equity Edge Diagnostic Utility maintains a log file for each of its attempts to apply an Equity Edge update that you select to install (by clicking the Install Update command button in the Apply Equity Edge Update window). The utility names each log file by concatenating the name of the selected Equity Edge update with the date and time when it installs the update and giving the file name the.log extension, for example, EEDBUPDATE7.0.1.1Jun-14-06-08.57.38.log. The example name EEDBUPDATE7.0.1.1Jun-14-06-08.57.38.log indicates that the log file was created when the Equity Edge Diagnostic Utility attempted to install the update called EEDBUPDATE7.0.1.1 at 08.57.38 hours on June 14 2006. 54 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.

Log Files Location The Equity Edge Diagnostic Utility places the log file associated with an Install Update command in the directory called Log under C:\Program Files\Equity Edge\EEDU\EEDU Updates, the directory for all Equity Edge updates downloaded by you for installation by the utility. At the very first instance when the Equity Edge Diagnostic Utility executes an Install Updates command, it looks for the parent Log folder under the C:\Program Files\Equity Edge\EEDU\EEDU Updates directory. If necessary, the utility creates the necessary Log folder, the log file, and enters the details of the current attempt to install the required update in that file. Accessing the Log Files The log files, created by the Equity Edge Diagnostic Utility while it installs an update, are not accessible from the Equity Edge Diagnostic Utility application. View the contents of this file using an appropriate text editor application. Figure 38 Contents of a Log File Created During an Install Update Internal Error Log File The Equity Edge Diagnostic Utility maintains an internal file of all errors that occur during its performance. This internal file is called EEDUErrorLog.log. The Equity Edge Diagnostic Utility maintains only one instance of EEDUErrorLog.log. It appends the details from each new error into this file. For every error encountered by the Equity Edge Diagnostic Utility, it inserts a time stamp, followed by a short description of the error. Location By default, the Equity Edge Diagnostic Utility places this internal file in the installation folder C:\Program Files\Equity Edge\EEDU\Log. 2007 E*TRADE FINANCIAL Corp. Equity Edge 7.1 Tech Alert 55

: Equity Edge Diagnostic Utility At the very first instance of an error, the Equity Edge Diagnostic Utility looks for the parent Log folder under the install directory. If necessary, the utility creates the necessary Log folder, the EEDUErrorLog.log file in this location, and enters the details of the current error. If the Log folder contains the EEDUErrorLog.log file, the utility will access that file and append the details of the current error to it. Accessing EEDUErrorLog.log This file cannot be accessed from the Equity Edge Diagnostic Utility application. You can access the contents of this file with the help of an appropriate text editor application. Figure 39 Contents of EEDUErrorLog.log file It is recommended that you do not rename or delete the EEDUErrorLog.log file. 56 Equity Edge 7.1 Tech Alert 2007 E*TRADE FINANCIAL Corp.