Вы находитесь на странице: 1из 37

Graphical Development

Environment
Release Notes

AB INITIO SOFTWARE LLC 201 Spring Street Lexington MA 02421 Voice +1 781.301.2000 Fax +1 781.301.2001 support@abinitio.com
PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488
NOTICE
This document contains confidential and proprietary information of Ab Initio. Use and disclosure are
restricted by license and/or non-disclosure agreements. You may not access, read, and/or copy this
document unless you (directly or through your employer) are obligated to Ab Initio to maintain its
confidentiality and to use it only as authorized by Ab Initio. You may not copy the printed version of
this document, or transmit this document to any recipient unless the recipient is obligated to
Ab Initio to maintain its confidentiality and to use it only as authorized by Ab Initio.

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Graphical Development
Environment
VERSION 3.1.5

Release Notes

March 2013 Part Number AB2204

AB INITIO SOFTWARE LLC 201 Spring Street Lexington MA 02421 Voice +1 781.301.2000 Fax +1 781.301.2001 support@abinitio.com
PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488
Intellectual Property Rights & Warranty Disclaimer

CONFIDENTIAL & PROPRIETARY


All provided documentation is confidential and a trade secret of Ab Initio. This documentation is furnished under a license and may be used only
in accordance with the terms of that license and with the inclusion of the copyright notice set forth below.

COPYRIGHTS
Copyright 1997-2013 Ab Initio. All rights reserved.
Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under copyright law or license from
Ab Initio.

TRADEMARKS
The following are worldwide trademarks or service marks of or licensed to Ab Initio (those marked are registered in the U.S. Trademark
Office, and may be registered in other countries):

> Conduct>It EME Portal Meta>Operating System


Ab Initio Continuous Flows Engine by Ab Initio Meta OS
Ab Initio I>O Continuous>Flows Enterprise Meta>Environment Meta>OS
Abinitio.com Cooperating Enterprise Enterprise Metadata Environment Plan>It
BRE Cooperating System Enterprise MetaEnvironment Re>Posit
Co>Operating Enterprise Cooperating GDE Re>Source
Co>Operating System Data>Profiler Graphical Development Environment Server++
Co>Operating Director Graph It Server+Server
Co>Operation Dynamic Data Mart Graph>It Shop for Data
Co>Operative E2E I>O The Company Operating System
Co>OpSys EME Init.com
Co>Ordinate EME Desktop Portal INIT

Certain product, service, or company designations for companies other than Ab Initio are mentioned in this documentation for identification
purposes only. Such designations are often claimed as trademarks or service marks. In instances where Ab Initio is aware of a claim, the
designation appears in initial capital or all capital letters. However, readers should contact the appropriate companies for more complete
information regarding such designations and their registration status.

RESTRICTED RIGHTS LEGEND


If any Ab Initio software or documentation is acquired by or on behalf of the United States of America, its agencies and/or instrumentalities (the
Government), the Government agrees that such software or documentation is provided with Restricted Rights, and is commercial computer
software or commercial computer software documentation. Use, duplication, or disclosure by the Government is subject to restrictions as
set forth in the Rights in Technical Data and Computer Software provisions at DFARS 252.227-7013(c)(1)(ii) or the Commercial Computer
Software Restricted Rights provisions at 48 CFR 52.227-19, as applicable. Manufacturer is Ab Initio Software LLC, 201 Spring Street,
Lexington, MA 02421.

WARRANTY DISCLAIMER
THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE. AB INITIO MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. AB INITIO SHALL NOT BE LIABLE FOR
ERRORS CONTAINED HEREIN OR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGE IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL.

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


CONTENTS
About the GDE Release Notes 8
Whats new in the GDE 9
Whats new in Version 3.1.5 9
Notice of future changes to backward compatibility 9
Debugging 10
Execute Command window 11
Plans 11
Dataset lineage 11
DML for record formats and transforms 11
Text view editors 12
Fonts for editor trees and grids 12
Multiple selection in the Sandbox View 12
Windows 8 support 12
Menu updates 12
Whats new in Version 3.1.4 13
Starting the GDE without a host connection 13
Debugging PDL 13
Evaluating DML expressions 13
Identifying non-breaking spaces 14
Finding the site of an error during DML validation 14
Encrypting Package for Support files 14
Editing component labels 14
Managing files in the Sandbox View 14
Importing WSDL 14
Changing saved passwords 15
Working in text view of the SQL Editor 15
Enabling EME connections 15
Preferences for plans 15
Flow appearance 15
Profile Viewer 15
Menu updates 15
System requirements 16
Whats new in Version 3.1.3 17
Customized help 17
Debugging 17
Inserting components on flows 17
Online Discussion Browser 18
Preferences 18
Subscribe and publish to queue symbol 18
Tracking 18
Transform Editor 18
UI support for SPLIT and COMBINE components 19
Update Components dialog 19

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 5

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


View data 19
What new in Version 3.1.2 20
Setup Wizard 20
Recovery files 20
Connecting flows 20
DML error message warning level 21
Enhanced search options 21
Info bubbles 21
Micrograph deployment 21
Scientific notation 21
Accessibility compliance 21
GDE bridge connections 21
Ab Initio Help Library 22
Computer-based training 22
Menu commands 22
Whats new in Version 3.1.1 23
Appearance 23
Legacy graphs 24
Detail layers 24
Info bubbles 24
Inserting and connecting components and flows 25
Canvas Overview window 25
Help 25
Text view editors 25
Grid view editors 26
Docking windows 26
Organizer 26
Sandbox View 26
Dependency Analysis Viewer 27
Reusable datasets 27
Custom validation 27
Landed SQL 27
Ab Initio Environment data directories 27
Performance 27
View Data Unformatted 28
Menu commands 28
Main menu updates 29
Requirements 31
Hardware requirements 31
System software requirements 31
Ab Initio software requirements 32
Installing and upgrading the GDE 33
Prerequisites 33
System requirements 33
Exit applications 33
Working with Microsoft .NET 33

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 6

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Installing the GDE under Citrix or Windows Terminal Server 34
Installing the GDE 34
Additional setup 35
Upgrading the GDE 35
Troubleshooting 36
If GDE files are in use 36
Completing the installation if automatic rollback is disabled 36
Installation logs 36
Running a silent installation 37

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 7

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


About the GDE Release Notes
This build of Version 3.1.5 of the Graph Development Environment (GDE) is a prerelease, intended
for those who want early access to new features available in Version 3.1.5.

The GDE Release Notes describe GDE Version 3.1.5 of the Graphical Development Environment
(GDE) as it functions when run with Version 3.1.5 of the Co>Operating System.

Audience
These release notes are for anyone who uses the GDE software.

Contents
These release notes contain the following sections:
Whats new in the GDE on page 9
Requirements on page 31
Installing and upgrading the GDE on page 33

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 8

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Whats new in the GDE
The following sections describe changes, new features, updates and improvements that have been
introduced in the GDE.
Whats new in Version 3.1.5 on page 13
Whats new in Version 3.1.4 on page 13
Whats new in Version 3.1.3 on page 17
What new in Version 3.1.2 on page 20
Whats new in Version 3.1.1 on page 23
Main menu updates on page 29

Whats new in Version 3.1.5


The following sections describe changes, new features, and improvements that have been introduced
in GDE Version 3.1.5:
Notice of future changes to backward compatibility
Debugging
Execute Command window
Plans
Dataset lineage
DML for record formats and transforms
Text view editors
Fonts for editor trees and grids
Multiple selection in the Sandbox View
Windows 8 support
Menu updates

Notice of future changes to backward compatibility


The GDE alerts you when you open graphs that use 1.13 or earlier format or that use GDE
1.13-compatible script generation.
When you open a graph that is in 1.13 or earlier format, the GDE alerts you that you should
resave the graph as Version 1.14 or later, and convert it to use Dynamic script generation rather
than GDE 1.13-compatible script generation.
When you open a graph that uses GDE 1.13-compatible script generation, the GDE alerts you
that you should convert the graph to use Dynamic script generation.

In future releases of the GDE, Ab Initio will begin to phase out support for older graphs.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 9

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


In 2013, version 3.2 of the GDE will drop the ability to read the 1.13 (and older) graph formats. The
same release will officially deprecate 1.13-compatible script generation, and prevent you from
creating new graphs that use it. A subsequent release, tentatively expected in 2014, will entirely
remove support for 1.13-compatible script generation.

Please note that these changes will affect the GDE only. There is no risk to your production graphs.
New Co>Operating System releases will continue to be able to execute 1.13-compatible graph
scripts, and you'll still be able to use older GDE releases to edit the graphs and deploy the scripts.
However, you should start updating your graphs now so that you can enjoy uninterrupted access to
GDE updates.

Converting a 1.13-or-older-format graph to a newer format is a simple matter of resaving the graph.
If you find a graph in an old format, Ab Initio recommends that you simply make a backup copy and
resave, without redeploying. If your graphs are stored in the EME Technical Repository, a checked-in
version is a sufficient backup. Testing is not necessary until you need to redeploy the script.

Converting a graph to dynamic script generation can be more involved, and it does require retesting.
The following practices tend to require more attention during the conversion process:
Using parameters that have not been declared in the project or graph
Setting parameters in the graph start script
Including multiple common projects that each declare the same parameter

We recommend that, where possible, you start using dynamic script generation for new graph
development. For existing graphs, you can reduce the amount of conversion effort required by
implementing the following suggestions, even while maintaining 1.13-compatible script generation:
Define graph or project parameters, rather than adding or modifying parameters in the start
script of a graph.
If it's practical for you, use the dependency analysis feature of the EME Technical Repository to
help reveal problems with parameter use.

To assess the conversion effort, your Ab Initio administrator should speak to your account manager
and contact Ab Initio Support.

Debugging
The following improvements have been made to debugging:
When the GDE is connected to Co>Operating System Version 2.15.4 or later, the Breakpoints
toolbar and the Watchers toolbar are independent of one another and are displayed separately.
The Enable breakpoints and watchers separately option has been removed from the Debug
category of the Preferences dialog.
NOTE: If the GDE is connected to a version of the GDE earlier than 2.15.4, the single Debug toolbar is
displayed.
For more information, see GDE Toolbars in the Guide to the GDE.
When the Debugger pane iin the Transform Editor reopens, it now displays the most recently
active tab and attempts to preserve the state of its various tabs during the current GDE session.
For more information, see Debugger pane in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 10

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Execute Command window
The Execute Command window has been enhanced, enabling you to enter multiple commands for
execution, each in its own shell. These commands are executed on the run host to which the GDE is
connected. For more information, see Execute Command window in the Guide to the GDE.

Plans
Numerous changes have been made to the GDE to better support working with plans.
Tasks are now color-coded to improve readability, and you can display numerous detail layers
and visual cues on the plan canvas.
For more information, see Working on the canvas in the in the Guide to the GDE.
Info bubbles have been enabled for plans. For more information, see Info bubbles in the Guide
to the GDE.
There are more alternatives for inserting tasks and creating control flows directly on the plan
canvas. For more information, see Inserting components and tasks and connecting flows and
Connecting Flows in the Guide to the GDE.
Plan tracking has been enhanced, as follows:
The Tracking Details window has been updated to be more consistent with the Tracking
Details window for graphs. For more information, see Tracking Details window for plans in
the Guide to the GDE.
The File > Tracking and Output > Load and Save menu commands have been enabled for
plans, enabling you to save and load tracking data from prior runs of a plan. For more
information, see Plan tracking and output in the Conduct>It Guide and Reference.

Dataset lineage
The GDE provides a new Dataset Lineage viewer that enables you to view the lineage for EME
datasets and the graphs that read or write them. The viewer also allows you to drill down into
individual graphs to view field-level lineage. For more information, see Dataset Lineage viewer in
the Guide to the GDE.

DML for record formats and transforms


The following improvements and additions in the GDE provide better support for DML as you create
and edit record formats and transforms:
The Import XML dialog has a new option Generate DML to File . In addition, you can now
open the Import XML dialog from the Sandbox View. For more information, see Import XML
dialog in the Guide to the GDE and How to use the generated DML in the XML Processing
Guide.
A new Use validation fields option in the Import XML Options dialog adds validation fields to the
generated DML and makes it easier to test whether incoming XML data is valid. For more
information, see "Import XML Options dialog in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 11

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


The Evaluate DML expression pane of the Expression Editor now considers the context of
transforms and record formats of a component when you evaluate DML expressions. For more
information, see Evaluate DML expression in the Guide to the GDE.
A new Kind attribute in the Variables Editor replaces the previous Constant attribute. The Kind
attribute provides support for DMLs new Parameterized named constant. For more information,
see Variables Editor in the Guide to the GDE and Global variables and named constants in the
DML Reference.

Text view editors


New menu commands for autocompletion, outlining, and advanced editing have been added to
the Edit menu in the Transform Editor, Record Format Editor, Package Editor, and other GDE
text editors. For more information, see Text view menus in the Guide to the GDE.
The Help menu in text view editors includes a new menu command Editor Shortcuts, which
opens a help topic describing the various keyboard shortcuts you can use in the editor. For more
information, see Shortcuts for working with text editors in the Guide to the GDE.

Fonts for editor trees and grids


The Change font for trees and grid option in the Fonts/Sizes category of the Preferences dialog now
applies to the trees and grids in several GDE editors, including the Parameters Editor and the
Transform Editor. For more information, see Preferences: Fonts/Sizes category in the Dialog and
Wizard Reference.

Multiple selection in the Sandbox View


You can now select multiple items in the sandbox view. For information about the uses and
limitations of multple selections, see Using the Sandbox View in the Guide to the GDE.

Windows 8 support
The GDE is now supported on Windows 8. For more information, see System software
requirements on page 31.

Menu updates
There have been changes to menu commands in the File and View menus. For more information, see
Main menu updates on page 29.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 12

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Whats new in Version 3.1.4
The following sections describe changes, new features, and improvements that have been introduced
in GDE Version 3.1.4:
Notice of future changes to backward compatibility
Starting the GDE without a host connection
Debugging PDL
Evaluating DML expressions
Identifying non-breaking spaces
Finding the site of an error during DML validation
Encrypting Package for Support files
Editing component labels
Managing files in the Sandbox View
Importing WSDL
Changing saved passwords
Working in text view of the SQL Editor
Enabling EME connections
Preferences for plans
Flow appearance
Profile Viewer
Menu updates
System requirements

Starting the GDE without a host connection


You can now use a command-line option to start the GDE without a host connection. For more
information, see Starting the GDE from the command line in the Guide to the GDE.

Debugging PDL
The GDE has a new PDL Debugger that enables you to debug inline DML that is contained in a PDL
construct. For more information, see PDL Debugger in the Guide to the GDE.

Evaluating DML expressions


A new pane in the Expression Editor enables you to evaluate a DML expression, similar to the way
you can perform DML evaluations using the m_eval command utility. You can immediately see the
output so that you can verify the syntax and determine the logical correctness of the expression
without having to run the graph. For more information, see Evaluate DML expression in the Guide
to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 13

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Identifying non-breaking spaces
Non-breaking spaces that may have been inadvertently introduced typically by copying and
pasting text from another application can render transforms and record formats invalid. GDE text
editors now indicate non-breaking spaces with an notation that enables you to easily identify
and remove those invalid characters. For more information, see Non-printing characters in the
Guide to the GDE.

Finding the site of an error during DML validation


If an error is found when you validate the DML in text view of the Record Format Editor, the
Transform Editor, or the Package Editor and the error has an associated line number, the error
message box includes a new Go To Error button.
Clicking Go To Error closes the error message and automatically moves focus to the line in which
the error occurs.
Clicking OK closes the error message and leaves focus on that line.

Encrypting Package for Support files


A new preference enables you to encrypt Package for Support files. For more information, see
Creating a Package for Support file in the Graph Developers Guide.

Editing component labels


You can now edit component labels directly on the graph canvas itself, without having to open the
Properties dialog. For more information, see Customizing component labels in the Guide to the
GDE.

Managing files in the Sandbox View


New pop-up menu commands enable you to remove, rename, and copy files in the Sandbox View,
irrespective of whether the sandbox is associated with an EME technical repository. For more
information, see File-level menu commands in the Guide to the GDE.

Importing WSDL
The Options for Import WSDL dialog provides a new XML component kind setting that indicates the
type of XML component for which the Import WSDL dialog generates DML. This ensures that the
generated record format is compatible with the XML component that will be using it. For more
information, see Options for Import WSDL dialog in the Dialog and Wizard Reference.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 14

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Changing saved passwords
The Change Saved Passwords dialog has been redesigned to better identify host connections with
saved passwords. Using this dialog, you can change a password only for a host connection with a
previously saved password. You must use the Host Connection Settings dialog to create a password
for a host connection that does not have a previously saved password. For more information, see
Changing passwords for host connections in the Guide to the GDE.

Working in text view of the SQL Editor


Text view of the SQL Editor now allows you to do the following:
As you enter text, choose keywords, table names, or field names from a list of suggested
completions. For more information, see Autocompletion in text view in the Guide to the GDE.
Automatically generate a basic SQL statement for a component parameter. For more
information, see Generating default SQL in the Guide to the GDE.

Enabling EME connections


The Enable/Disable Current EME Connection menu command is now enabled, even when a graph or
plan is not open in the workspace. This lets you enable or disable the connection to the EME
technical repository for a currently open sandbox.

Preferences for plans


When a plan is the active document in the GDE workspace, only the options that apply to plans are
displayed in the Detail Layers and Appearance categories of the Preferences dialog.

Flow appearance
You can now view flow pattern symbols for only the flow patterns that have been explicitly set.
For more information, see Showing and hiding flow pattern symbols in the Guide to the GDE.
You can now choose to have flows drawn with right angles or with curves, and you can display
overlapping flows with a visual separation. For more information, see Adjusting flow display in
the Guide to the GDE.

Profile Viewer
The title bar of Profile Viewer now provides detailed information about the location of a watcher on
which you are viewing the dataset profile. For more information see Profiling data in the Graph
Developers Guide.

Menu updates
New menu commands have been added to the Edit, Project, View, and Settings menus. For more
information, see Main menu updates.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 15

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


System requirements
The .NET Framework system software requirements have been updated. For more information, see
System software requirements.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 16

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Whats new in Version 3.1.3
The following sections describe changes, new features, and improvements that have been introduced
in GDE Version 3.1.3:
Customized help
Debugging
Inserting components on flows
Online Discussion Browser
Preferences
Subscribe and publish to queue symbol
Tracking
Transform Editor
UI support for SPLIT and COMBINE components
Update Components dialog
View data

Customized help
The 3.1.3 version of Ab Initio Help allows you to document your shared components and DML, and
access that content from the GDE.

For more information, see Creating Custom Help in Ab Initio Help.

Debugging
To apply breakpoints to transforms that contain parameter references, you no longer need to
switch to Resolved View in text view of the Transform Editor. Whether in grid view, text view, or
resolved view, the Transform Editor allows you to set breakpoints and debug the transform.
When you run the graph in text view the resolved statements are displayed in the Breakpoints
Reached window. For more information, see Debugging transforms in the Graph Developers
Guide.
When first opened the Breakpoints Reached window now automatically docks itself in the lower
left corner of the GDE window.
When debugging graphs, in addition to stepping into a function, you can now step out of a
function and cause the graph to resume execution until it reaches the next executable rule or
statement in a calling function. For more information, see Stepping through transforms in the
Graph Developers Guide.

Inserting components on flows


When you drag and drop a component from the Organizer onto a flow that has special treatment
compression, encryption, disabled folding, explicit fanning, or a watcher you can now control
which of the two new flows inherits the special treatment. While the mouse pointer is over the flow

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 17

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


that displays the icon flagging the special treatment, the insertion icon appears so that you can drop
the component on one side of the flagging icon or the other. For more information, see To insert a
component in a flow that is flagged for special treatment in the Guide to the GDE.

Online Discussion Browser


It is no longer necessary to manually install the Ab Initio Online Discussion Browser. When you
install the GDE, the Online Discussion Browser is automatically included as well, and a shortcut is
added to the Start menu. For more information, see Ab Initio Online Discussion Browser in the Ab
Initio Help.

Preferences
The Preferences dialog now includes an Apply button that enables you to apply settings for each
category without having to reopen the dialog.

Subscribe and publish to queue symbol


The graph symbol for a component that subscribes or publishes to a queue for example,
SUBSCRIBE and PUBLISH has been changed from this to this .

Tracking
The Alt+F2 keyboard shortcut now loads the most recent tracking and output files from their remote
location in the Ab Initio Environment. This enables you to use the GDE to observe the progress of a
graph started outside the GDE for example, a graph run at the command line or started by a
script. For more information, see To load and view text tracking and tracking details in the GDE in
the Graph Developers Guide.

Transform Editor
The following improvements have been made to the Transform Editor:
Text view of the Transform Editor has new optional panes showing the input and output types,
enabling you to perform drag operations as you can in grid view.
You can now delete fields from the Outputs pane.
Lookups are now displayed in the Inputs pane.
Autocompletion is now available for lookup files and lookup templates.

For more information, see Transform Editor in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 18

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


UI support for SPLIT and COMBINE components
The GDE now enables you to configure the SPLIT and COMBINE components through a new Derived
Record Format dialog, rather than using command-line instructions through the split_dml utility. For
more information, see Deriving record formats from an existing record format in the Graph
Developers Guide.

Update Components dialog


The Update Components dialog has been redesigned to provide greater flexibility. You can now
choose which components to list all components, those that are different and need to be
updated, or those that are currently selected in the graph. In addition, you can sort the grid by
columns, and you can choose to display components in embedded subgraphs as a hierarchical tree or
flattened. For more information, see Update Components dialog in the Dialog and Wizard
Reference.

View data
The work flow for accessing the View Data window has been improved. New menu commands
enable you to open the View Data window directly for formatted or unformatted data without
first having to select settings in the View Data Options dialog. For more information, see Main
menu updates and Opening the View Data window in the Guide to the GDE.
NOTE: This changed behavior applies to viewing logs as well. For more information, see Viewing Log Files
in the Graph Developers Guide.

You can now double-click a watcher to view its data. For more information, see Opening the
View Data window in the Guide to the GDE.
You can now view the data in Ab Initio queues being processed by the SUBSCRIBE, BATCH
SUBSCRIBE, and PUBLISH components.
For more information, Viewing data from Ab Initio queues in the Graph Developers Guide.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 19

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


What new in Version 3.1.2
The following sections describe changes, new features, and improvements that have been introduced
in GDE Version 3.1.2:
Setup Wizard
Recovery files
Connecting flows
DML error message warning level
Enhanced search options
Info bubbles
Micrograph deployment
Scientific notation
Accessibility compliance
GDE bridge connections
Ab Initio Help Library
Computer-based training
Menu commands

Setup Wizard
The GDE Setup Wizard now prompts for permission to test the host connection, so that you are not
inadvertently locked out of the server if your password has changed.

In addition, new pages have been added, enabling you to choose whether to set up a new host
connection or use an existing host connection.

For more information, see Setup Wizard in the in the Dialog and Wizard Reference.

Recovery files
The General category of the Preferences dialog no longer includes When recovery files are found
options. When you run a graph and a recovery file already exists, the GDE detects the recovery file
immediately and asks you whether you want to roll back or resume from the last checkpoint. For
more information, see Restarting a failed graph from the GDE in the Graph Developers Guide.

Connecting flows
The GDE now enables you to delete a component with a single input flow and single output flow,
and automatically reconnect the flow to the adjacent upstream and downstream components. For
more information, see Connecting a flow when deleting a component in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 20

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


DML error message warning level
The Advanced category of the Preferences dialog now provides a Warning level setting, which
enables you to specify the level of warning for DML expressions that will be reported during
validation. For more information, see Warning level in the Dialog and Wizard Reference.

Enhanced search options


You can now refine the search for items in the Organizer, Sandbox View, and the Transform Editor.
For more information, see:
Searching in the Organizer in the Guide to the GDE.
Searching in the Sandbox View in the Guide to the GDE.
Searching in grid view in the Guide to the GDE.

Info bubbles
New options have been added to info bubbles allowing you to choose to view resolved values,
multiline format, and all parameters. For more information, see Working with info bubbles in the
Guide to the GDE.

Micrograph deployment
You can now deploy a micrograph in an environment that differs from the one in which it was
created by using a new Deploy micrograph including all referenced files option in the Run Mode
category of the Graph Settings dialog. For more information, see Deploy micrograph including all
referenced files in the Dialog and Wizard Reference.

Scientific notation
The Record Format Editor now supports scientific notation for decimals. For more information, see
Allow Exponent in the Guide to the GDE.

Accessibility compliance
Section 508 accessibility compliance has been enhanced to improve your experience when working
with plans. For more information, see About accessibility compliance in the Accessibility Guide.

GDE bridge connections


The Dependency Analysis Viewer and data profiling no longer require a bridge connection. The
connection is made directly through the Application Hub. In addition, these features now work with
a DCOM connection, as well as Rexec, Telnet and a wider variety of SSH connections for example,
with keys, and with or without passwords. For more information, see Setting up connections in the
Architects and Administrators Guide.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 21

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


NOTE: Versions of the GDE earlier than Version 3.1.2 still require a bridge connection. For more information, see
Running the Ab Initio bridge in the Architects and Administrators Guide.

Ab Initio Help Library


You can now access the Ab Initio Help Library from the Ab Initio Online Discussion Browser or
directly from the Start menu as follows:
1. Choose Start > All Programs > Ab Initio > Ab Initio Help.
2. In the resulting dialog, select the host connection of the help server.
3. Click OK.

Computer-based training
The Help > Training menu command is now enabled.

For more information, see Additional setup.

Menu commands
Changes have been made to the Help menu command on the GDE menu bar. For more information,
see Main menu updates on page 29.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 22

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Whats new in Version 3.1.1
The following sections describe changes, new features, and improvements that have been introduced
in GDE Version 3.1.1:
Appearance
Legacy graphs
Detail layers
Info bubbles
Inserting and connecting components and flows
Canvas Overview window
Help
Text view editors
Grid view editors
Docking windows
Organizer
Sandbox View
Dependency Analysis Viewer
Reusable datasets
Custom validation
Landed SQL
Ab Initio Environment data directories
Performance
View Data Unformatted
Menu commands

Appearance
The appearance of graphs on the GDE canvas has been improved to be more readable and more
consistent with other Ab Initio applications:
There is a new Ab Initio default color theme, and components are now color-coded and have
distinctive shapes to help you identify their purpose and usage.
NOTE: The color theme is automatically applied to graphs created with earlier versions of the GDE,
including previously customized colors.

Icons for to-do cues, keys, and so forth are positioned at consistent locations on components,
and the display of these details is now controlled by the viewer rather than the author of the
graph.
Linked subgraphs now have an identifying overlay icon so that you can easily distinguish
them from embedded subgraphs.
Graphs better maintain their appearance when scaled.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 23

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


For more information, see in the Guide to the GDE.

Legacy graphs
While GDE Version 3.1.1 attempts to preserve the approximate look of older graphs, it cannot
display them the way older GDEs displayed them.

When you open a graph that was created with a version of the GDE earlier than Version 3.1.1, it will
be displayed using the new style. In addition, any graph settings that controlled the view of the graph
including to-do cues, optional ports, layouts, propagation, phase breaks, and so forth will be
ignored. Those settings are now controlled by preferences that apply to all graphs opened in the
workspace.

Older graphs may be arranged in such a way that when viewed in GDE Version 3.1.1 components
overlap or legends do not retain their original relative positions. You should rearrange components
and legends and straighten flows so that the graph elements are laid out as you want them. The next
time you open the graph, your changes will be retained.

If you resave the graph to its original format and reopen it in the earlier version of the GDE, the
original graph settings will be preserved, but the arrangement of the elements on the canvas may be
altered. You may once again need to straighten flows or make other adjustments. For more
information, Saving graphs across GDE versions in the Graph Developers Guide.

Detail layers
The GDE provides new preferences and menu commands controlling the level of detail displayed on
the canvas. Detailed information includes such things as to-do cues, tracking data, port names, flow
names, phases, legends, the outer frames, and so forth. Rather than being stored as part of a graph,
these detail layers apply to all the graphs and to some extent to plans that are open in the GDE
workspace. You can choose how many or how few details to display on the canvas, keeping the view
as simple as possible. For more information, see Displaying detail layers in the Guide to the GDE.

Info bubbles
The GDE now includes an option that enables you to display interactive info bubbles on the canvas
when the mouse pointer hovers over a component. The info bubble provides the most important
information about a component at a glance. From the info bubble, you can do the following:
See a digest of all the component information at once
Open the editor for a transform, record format, key, parameter, or reusable dataset
Connect optional ports of the component without having to show optional ports everywhere
Jump to the component that is the source of a propagated record format or layout
Jump to the linked subgraph that is the source of a subgraph component
Open help for the component
Open the Properties dialog for the component

For more information, see Info bubbles in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 24

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Inserting and connecting components and flows
The canvas has been redesigned to make it easier to drag and connect a flow from a port of one
component to a port of another.
You can automatically connect a component by dragging it from the Organizer and dropping it
on a port of another component.
You can insert a component in the middle of an existing flow by dragging it from the Organizer
and dropping it in the middle of the flow. This severs the original flow and connects two new
flows to the new components first input and output ports.
You can drag a flow and drop it onto the middle of an existing component to display a list of all
available ports, where you can select the one you want to connect to. This eliminates the need to
always display optional ports.
You can add components to a graph so that they are automatically placed in logical positions.
You do this by selecting a component on the canvas and then, in the Organizer, double-clicking
the next component in the sequence.

For more information, see Inserting components and connecting flows in the Guide to the GDE.

Canvas Overview window


The GDE includes a Canvas Overview window that displays a miniaturized view of the entire canvas.
Using this window, you can pan and zoom the graph or plan. For more information, see Canvas
Overview window in the Guide to the GDE.

Help
The GDE online help is now delivered as a separate installable module to be included as part of
the new Ab Initio Help Library. The Help Library is a server-side Web application that hosts the
help for all of your Ab Initio software in one central location, which can be regularly updated with
the most recent Ab Initio help content. This centralized Help Library provides easy access and
allows you to search the entire Help Library. Your Ab Initio administrator will install and
configure the help on a designated server.
NOTE: This new delivery mechanism has reduced the size of the GDE installer package by 40%.

The GDE main window now includes a Help search box. When you type a string in the box and
press Enter, the Ab Initio Help Library opens and displays a list of topics that match the search.

Text view editors


Text view editors automatically suggest possible completions of characters and symbols as you
type. The choices are based on context and can include DML reserved words, function names,
field names, and parameter names. The autocompletion feature is controlled by a new preference
in the Preferences: Text Editor category, or you can use the Ctrl+space keyboard shortcut to
display the pop-up list of possible options. For more information, see Autocompletion in text
view in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 25

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Text view editors now enable you to easily find the definition of the user-defined DML function,
type, or global variable near the cursor in the text editor. This is particularly useful in cases where
those are defined in some other file, such as AB_INCLUDE_FILES. You can access the Go to
definition menu command from the Edit menu, from the pop-up menu, or by pressing F12.
Text view of the Transform Editor now includes a new Edit > Edit Expression menu command,
which opens the Expression Editor where you can create DML expressions.

Grid view editors


The Expression Editor and Transform Editor now display icons next to each field in the Input
pane. The icons indicate the type of the field record, string, numeric, date, and date/time. For
more information, see Expression Editor and Transform Editor in the Guide to the GDE.
The Transform Editor, Package Editor, Expression Editor, and Key Specifier Editor now each
include Search fields that enable you to easily find fields, symbols, or functions that match the
characters you type.
For more information, in the Guide to the GDE, see:
Searching in grid view
Searching in the Package Editor
Searching in Expression Editor
Searching in the Key Specifier Editor

Docking windows
The GDE provides enhanced functionality for docking or floating windows in the GDE workspace.
You can dock windows to the edge of the GDE workspace, to edges of other windows in the
workspace, or to each other in clusters that can be floated as a single unit. You can also hide docked
windows so that they appear as tabs along the edge of the GDE workspace. For more information,
see Docking or floating windows in the GDE in the Guide to the GDE.

Organizer
The Component Organizer has been renamed Organizer. It displays the list of available components
or plan tasks, and now features a search field that enables you to type in names or keywords to
quickly display components you are looking for. For more information, see Searching the Organizer
in the Guide to the GDE.

Sandbox View
The Sandbox View pane now includes a search field that enables you to type characters to quickly
find objects in the sandbox. For more information, see Searching in the Sandbox View in the Guide
to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 26

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Dependency Analysis Viewer
A new Dependency Analysis Viewer enables you to view the data lineage for a component. Within a
graph, the view shows how each value is derived (upstream dependencies) and where it applies
subsequently (downstream dependencies, or impacts). This view makes it easy to fix dependency
analysis errors. You access the viewer by right-clicking a component and choosing Show
dependencies from the pop-up menu. For more information, see Dependency Analysis Viewer in
the Guide to the GDE.

Reusable datasets
The GDE now allows you to create and use preconfigured, reusable datasets, which provide easy
access to data. Reusable datasets are usually created in common projects and shared among
developers working on a project. In the technical repository, reusable datasets participate in
dependency analysis and lineage. For more information, see Reusable datasets in the Graph
Developers Guide.

Custom validation
The GDE reports issues found by validation extensions (or validation tests) created by your Ab Initio
architect to test whether your graph meets the standards and best practices of your organization.
The GDE reports these issues on the Validation tab of the Application Output window, just as it
reports other validation errors. For more information, see Validation extensions in the Graph
Developers Guide.

Landed SQL
You can now use external SQL files when specifying data on the Table Properties dialogs Data tab
for components such as INPUT TABLE. For more information, see Using databases in graphs in the
Graph Developers Guide.

Ab Initio Environment data directories


By default, only the owner of the project directories above the $AI_TEST_FLAG level is allowed to
create data directories. Unless your Ab Initio administrator has configured your environment to
ignore the data directory owner, you must ask your administrator to create the data directories for
any private sandbox you create. For more information, see Creating data directories from the GDE
in the Ab Initio Environment Guide and Reference.

Performance
Using functionality provided by Application Hub Version 3.1.1, the GDE compresses streamed data.
This compression improves runtime performance, including such things as the dynamic display of
graph tracking information. This is particularly helpful over slow connections.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 27

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


View Data Unformatted
The View > Data Unformatted dialog and menu command are obsolete and have been removed
from the GDE. You can continue to view unformatted data by choosing View > Data and then, in the
Interpret As field of the View Data Options dialog Display tab, selecting Unformatted Records. For
more information, see View Data Options:Display tab in the Dialog and Wizard Reference.

Menu commands
Changes have been made to the Edit, Insert, Run, Settings, and View menu commands on the
GDE menu bar. For more information, see Main menu updates on page 29.
In the context menu for the Sandbox View, the Include Common Project menu command has
been changed to Include Common Sandbox, and the Stop Including Common Project menu
command has been changed to Stop Including Common Sandbox.
New Edit menu commands have been added for the text view of the Transform Editor and the
Record Format Editor:
Go To Definition
Bookmarks > Set/Clear, Previous, Bookmark, Next Bookmark
Edit Expression
For more information see Text view menus in the Guide to the GDE.
Menu commands that were previously available from the context menu are now also available
from the View menu for the text view of the Transform Editor and the Record Format Editor:
Zoom > Zoom In, Zoom Out, Reset Zoom
Syntax Highlighting
Whitespace
Wrapped Lines
Line Numbers
Bookmarks
Outlining
Expand All/Collapse All
For more information see Text view menus in the Guide to the GDE.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 28

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Main menu updates
Menu Change Introduced
Debug No change 3.1.1
Edit A new Label menu command has been added. This command highlights the label of the selected 3.1.4
component and enables you to edit the label directly without having to open the Properties
dialog.

The Script > Start menu command has been changed to Script > Start Script. 3.1.1
The Script > End menu command has been changed to Script > End Script.
The Subgraph > Expand menu command has been changed to Subgraph > Replace with
Contents.
A new Save as Reusable Dataset command opens the Create Reusable Dataset Wizard, where
you can to save the current component as a reusable dataset.
A new Link to Reusable Dataset command opens a file browser, so you can select a reusable
dataset to link to the current component.
A new Unlink Dataset command breaks the link between a dataset-linked component and the
associated reusable dataset.
File The Tracking and Output > Load and Save menu commands have been enabled for plans, enabling 3.1.5
you to save and load tracking data from prior runs of a plan.
Help The Tutorial menu command has been changed to Training to better reflect the contents of the 3.1.2
training module.
Insert In addition to enabling you to insert components you can access by browsing through the Open 3.1.1
dialog, the Component menu command now provides cascading menu commands for all the Ab
Initio components in each of the Organizer folders.
Project A new Recent Sandboxes menu command opens a submenu of recently opened sandboxes from 3.1.4
which you can select a sandbox to open.
Run The Deploy Script menu command deploys the script for graphs that use GDE 1.13- 3.1.4
compatible script generation.
A new Deploy Wrapper Script menu command has been added. This menu command deploys
the wrapper script for graphs that use Dynamic script generation

The Start and Save Tracking menu command has been changed to Start and Save Graph Tracking 3.1.1
and Start and Save Plan Tracking, depending on the active document.
Settings The Enable/Disable Current EME Connection menu command is now available, even if no graph or 3.1.4
plan is open. This lets you enable or disable the EME connection for a currently open sandbox.

The Changed Passwords menu command is now Changed Saved Passwords. 3.1.1

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 29

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Menu Change Introduced
View The Tracking menu command for plans has been removed, because the same command is 3.1.5
available through the Detail Layers menu command.

The View > Detail Layers menu command has a new Show if Explicit submenu command. 3.1.4
Choosing this command causes flow pattern symbols to appear on only the flows that have been
explicitly set.

The View > Data menu command has been changed to the following: 3.1.3
View > View Data > Formatted that opens the View Data window displaying the
formatted records in grid view.
View > View Data > Unformatted that opens the View Data window displaying records as
unformatted text.
View > View Data > Options that opens the View Data Options dialog where you can
customize how records are displayed in the View Data window.

A new Detail Layers menu command provides cascading menu commands that replicate 3.1.1
options in the Detail Layers category of the Preferences dialog. Choosing these commands
enables you to show or hide visual cues and other information about graphs and components.
A new Toolbars > Layers toolbar command opens a new Layers toolbar that
contains buttons to show or hide the most frequently used options phases, optional ports,
outer frame, component types, info bubbles, and the dialog for the detail layer preferences.
A new Canvas Overview menu command opens the Canvas Overview pane in the workspace.
The Component Organizer menu command has been changed to Organizer.
The Optional Ports, Phases, Outer Frame and Tracking menu commands are now available
under the Detail Layers menu command.
The Data Unformatted menu command has been removed. You can continue to view
unformatted data by choosing View > Data, and in the Interpret As field of the Display tab of
the View Data Options dialog, selecting Unformatted records.
Window No change 3.1.1

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 30

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Requirements
Version 3.1.5 of the GDE has the following requirements:
Hardware requirements
System software requirements
Ab Initio software requirements

Hardware requirements
See also Installing the GDE under Citrix or Windows Terminal Server on page 34.

Category Requirement

Processor 1.5 GHz 32-bit (x86) or 64-bit (x64) or faster

RAM Recommended: 1 GB

Minimum available: 488 MB

Disk space for installation 200 MB

Screen resolution 1024 x 720

System software requirements


Category Requirement

Operating system Windows 8, Windows 7, Windows Vista, Windows XP with


Service Pack 2, Windows Server 2008, or Windows Server 2003

NOTE: You must have administrator privileges to install the GDE. The
installation adds the GDE to the list of firewall exceptions,
registers a number of COM components, and adds a TCP port
for the Identification Protocol (see RFC 1413).

Framework Microsoft .NET Framework .NET 2.0, 3.0, or 3.5

NOTE: .NET Framework 4.0 is not backward-compatible with these


versions and does not satisfy the GDE's requirement.

Download and install Microsoft .NET Framework Version 2.0,


3.0, or 3.5 Redistributable Package from:
http://www.microsoft.com/downloads

Support for data profiling Adobe Flash Player 10 or later for Windows Internet Explorer
and remote dependency
analysis viewer (optional) Download and install Adobe Flash Player 10 from:
http://get.adobe.com/flashplayer

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 31

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


WARNING! We cannot guarantee compatibility with other applications that inject and run their own code in
the GDE process (see http://en.wikipedia.org/wiki/DLL_injection). Such applications, if they have
software defects, can cause the GDE to crash randomly. For example, some versions of Tortoise
Subversion client (TortoiseSVN) have software defects that cause the GDE to crash; do not run the
GDE and TortoiseSVN on the same computer.

Ab Initio software requirements


Category Requirement

Server software Ab Initio server software Version 3.1 or later, including:


Application Hub Version 3.1 or later
Connecting through Application Hub Version 3.1, you can continue
to develop graphs and plans that run on Version 2.14 or later of the
Co>Operating System. However, If you want to take full advantage
of the newest components and features, use the most recent release
of Co>Operating System Version 3.1.
NOTE: If you want to use Co>Operating System Version 2.13 or earlier,
contact support@abinitio.com.
For more information, see About the Application Hub in the
Co>Operating System Architects and Administrators Guide.
EME Technical Repository (optional)
If the GDE will be connecting to an EME technical repository, ensure
that the repository has been prepared for use with GDE Version 3.1.
For more information, see Upgrading from Version 2.14 or later to
Version 3.1 in the EME Technical Repository Release Notes.

Key Server Key Server Version 1.2 or later


(optional)
Configuration of the Application Hub with key server information

For details, see the Key Server Installation and Administration Guide.

Support for data Application Hub Version 3.1 or later, configured to support data
profiling (optional) profiling, together with a properly activated key

Support for
dependency Application Hub Version 3.1 or later
analysis viewing

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 32

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Installing and upgrading the GDE
This section describes prerequisites and instructions for installing and upgrading the GDE. It includes
the following sections:
Prerequisites
Installing the GDE
Additional setup
Upgrading the GDE
Troubleshooting
Running a silent installation

Prerequisites
The following sections describe the prerequisites and considerations to be aware of before you install
the GDE.

System requirements
Ensure that you have reviewed and met the product requirements defined in Requirements on
page 31.

Exit applications
Before installing the software, exit all running instances of the GDE, as well as any associated
windows such as Ab Initio Help. In addition, we strongly recommend that you exit all other
applications.

Working with Microsoft .NET


Do not install the GDE on a network drive. Doing so creates a privilege issue for GDE features that
were developed with Microsoft .NET, including View Data, Tracking, Salesforce Editor, and SQL
Editors. This .NET "managed code" does not have sufficient privileges to run in the Local Intranet
Zone.

Instead, install the GDE on a local drive.

If you must install the GDE on a network drive, alter the .NET security policy to grant Full Trust
privileges to gde.exe. This operation requires administrator privileges.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 33

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Installing the GDE under Citrix or Windows Terminal Server
If the GDE is installed under Citrix or Windows Terminal Server, your Ab Initio and Citrix/Terminal
Server administrators must ensure that the following prerequisites are met:
The Windows server operating systems must be compatible with the GDE.
An Ab Initio key server must be configured to provide keys to all users who will be running the
GDE on this server. Computer keys are not supported.
For more information, your Ab Initio and Citrix/Terminal Server administrators should refer to the
Ab Initio Key Server Installation and Administration Guide.
The user's Windows account should be configured for a roaming user profile.
The user's GDE session must have read/write access to the registry key
HKEY_CURRENT_USER\Software\Ab Initio.
The user's GDE session must have read/write access to the following directories:
The directory where host connection files (.aic files) are stored. For example:
C:\Documents and Settings\%USERNAME%\My Documents\Ab Initio\Hosts
This location is designated in the Host connection locations field of the General category in
the GDE Preferences dialog.
The Ab Initio directory under the special directory called CSIDL_APPDATA. For example:
C:\Documents and Settings\%USERNAME%\Application Data\Ab Initio
The Ab Initio directory under the special directory called CSIDL_LOCAL_APPDATA. For
example:
C:\Documents and Settings\%USERNAME%\Local Settings\Application
Data\Ab Initio

Installing the GDE


To install from a CD-ROM or download site:

Run gde_3_1_5.msi in the Ab Initio GDE directory.


You can install the GDE in any local destination. During the installation setup, you are given three
options for the location of the installation folder:

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 34

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Installation folder Description

C:\Program Files(x86)\Ab Initio\Ab Initio The recommended location. By default, this


GDE 3.1.5\ option installs the GDE in a location identified
by its version number. This option makes it
easier to manage side-by-side installations of
different versions of the GDE.

C:\Program Files\Ab Initio\ This option installs the GDE in a folder that has
Ab Initio GDE\ no specified version number. You may want
use this option to install the new version of the
GDE over the version that already exists at this
location. This allows you to preserve and
maintain existing proprietary files that you
have created.

Other location This option lets you install the GDE in any
folder on your system. This option also enables
you to install the new version of the GDE over
the version that already exists in the
designated location.

Additional setup
In addition to installing the GDE you should also install the Ab Initio Help Library and the computer-
based training module.
Ab Initio Help Library Ab Initio Help is no longer distributed with the GDE. If help (F1) is not
working for you, your Ab Initio administrator may not have installed and configured it yet. Refer
the administrator to the Ab Initio Help Library Installation Guide.
Training If you want to install the training module, Graph Development Basics, refer your
administrator to the GraphDevBasics_ReleaseNotes.txt file and the Computer Based Training
Setup Guide included in the download package. After the Graph Development Basics training
module is visible in the help table of contents, open it and follow the instructions in the
introduction to complete the installation and setup.

Upgrading the GDE


We recommend that when upgrading you install the GDE in a new directory, not in a directory
containing an earlier version. The installer displays a suggested installation directory that contains
the GDE version number. This enables you to install multiple versions of the GDE side by side.

If you do choose to install the GDE in the same directory as an earlier version, after confirmation the
installer will uninstall the earlier version before installing the new one.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 35

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


Troubleshooting
This section provides troubleshooting information for installing and upgrading the GDE:
If GDE files are in use
Completing the installation if automatic rollback is disabled
Installation logs

If GDE files are in use


If any of the files in an existing GDE installation are in use, the installer may display a Files In Use
dialog. Shut down all listed Ab Initio applications and click Retry. If you click Ignore to continue the
installation while Ab Initio files or programs are open, the installer will prompt you to reboot the
system upon completion.

Completing the installation if automatic rollback is disabled


If your Ab Initio administrator has disabled the installers automatic rollback feature, the installer
may be unable to complete all the steps in the installation. Your Ab Initio administrator must
manually complete these steps at the conclusion of the installation.

To complete the installation:

1. Using Run as administrator, open a Command Prompt window.


2. At the command prompt, enter the following:
cd "C:\Program Files\Ab Initio\Ab Initio GDE 3.1.n\Program Files"
gde.exe /regserver
regsvr32 sapcustomeditor.dll

If the GDE cannot be properly installed, send the installation log files to support@abinitio.com. For
more information, see Installation logs next.

Installation logs
If the installer encounters a problem, you can use the two log files listed in the following table to
help debug the problem:

Name of the log file Location


abtrace_msi_gde.run %TEMP%

For example:

C:\Documents and Settings\username\


Local Settings\Temp

your_msi_logfile_name defined in the [your_path] defined in the msiexec command


msiexec command below below

The Ab Initio abtrace_msi_gde.run log file is automatically generated.

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 36

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488


You must generate the msi log file by rerunning the installation using the following command:
msiexec /i gde_3_1_5.msi /lvx* [your_path]\your_msi_logfile_name

Send the two files to support@abinitio.com.

Running a silent installation


You can run a silent installation either to a default location or to a specified location. For information
about further options, see the Microsoft documentation describing the Microsoft Windows Installer.

To run a silent installation of the GDE at the default location:

Execute the following command:


msiexec /i gde_3_1_5.msi /qn
This command installs the GDE in the following location:
C:\Program Files\Ab Initio\Ab Initio GDE 3.1.5
NOTE: The installation location is defined by the version number of the GDE.

To run a silent installation of the GDE at a specified location:

Execute a command with a defined installation path. For example:


msiexec /i gde_3_1_5.msi /qn INSTALLDIR="N:\Ab Initio\GDE 3.1.5"
This command installs the GDE in the specified location:
N:\Ab Initio\GDE 3.1.5

AB INITIO CONFIDENTIAL AND PROPRIETARY DO NOT COPY 37

PT. XL Axiata Tbk. : S/N: MPFTP-21257-1057271235.00488

Вам также может понравиться