Informatica Database Download Manager - 1.0.0 - User Guide ...

Informatica AddressDoctor Database Download Manager (Version 1.0.0)

User Guide

Informatica AddressDoctor Database Download Manager User Guide

Version 1.0.0November 2014

Copyright (c) 2010-2014 Informatica Corporation. All rights reserved.

This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This Software may be protected by U.S. and/or international Patents and other Patents Pending.

Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013©(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable.

The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us in writing.

Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and Informatica Master Data Management are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.

Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights reserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rights reserved.Copyright © Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright © Meta Integration Technology, Inc. All rights reserved. Copyright © Intalio. All rights reserved. Copyright © Oracle. All rights reserved. Copyright © Adobe Systems Incorporated. All rights reserved. Copyright © DataArt, Inc. All rights reserved. Copyright © ComponentSource. All rights reserved. Copyright © Microsoft Corporation. All rights reserved. Copyright © Rogue Wave Software, Inc. All rights reserved. Copyright © Teradata Corporation. All rights reserved. Copyright © Yahoo! Inc. All rights reserved. Copyright © Glyph & Cog, LLC. All rights reserved. Copyright © Thinkmap, Inc. All rights reserved. Copyright © Clearpace Software Limited. All rights reserved. Copyright © Information Builders, Inc. All rights reserved. Copyright © OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo Communications, Inc. All rights reserved. Copyright © International Organization for Standardization 1986. All rights reserved. Copyright © ej-technologies GmbH. All rights reserved. Copyright © Jaspersoft Corporation. All rights reserved. Copyright © is International Business Machines Corporation. All rights reserved. Copyright © yWorks GmbH. All rights reserved. Copyright © Lucent Technologies. All rights reserved. Copyright (c) University of Toronto. All rights reserved. Copyright © Daniel Veillard. All rights reserved. Copyright © Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright © MicroQuill Software Publishing, Inc. All rights reserved. Copyright © PassMark Software Pty Ltd. All rights reserved. Copyright © LogiXML, Inc. All rights reserved. Copyright © 2003-2010 Lorenzi Davide, All rights reserved. Copyright © Red Hat, Inc. All rights reserved. Copyright © The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright © EMC Corporation. All rights reserved. Copyright © Flexera Software. All rights reserved. Copyright © Jinfonet Software. All rights reserved. Copyright © Apple Inc. All rights reserved. Copyright © Telerik Inc. All rights reserved. Copyright © BEA Systems. All rights reserved. Copyright © PDFlib GmbH. All rights reserved. Copyright ©

Orientation in Objects GmbH. All rights reserved. Copyright © Tanuki Software, Ltd. All rights reserved. Copyright © Ricebridge. All rights reserved. Copyright © Sencha, Inc. All rights reserved.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various versions of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or agreed to in writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.

This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software copyright © 1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License Agreement, which may be found at http:// www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.

The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine, and Vanderbilt University, Copyright (©) 1993-2006, all rights reserved.

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and redistribution of this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.

This product includes Curl software which is Copyright 1996-2013, Daniel Stenberg, <[email protected]>. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The product includes software copyright 2001-2005 (©) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http://www.dom4j.org/ license.html.

The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http://dojotoolkit.org/license.

This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.

This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at http:// www.gnu.org/software/ kawa/Software-License.html.

This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.

This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.

This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at http:// www.pcre.org/license.txt.

This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http:// www.eclipse.org/org/documents/epl-v10.php and at http://www.eclipse.org/org/documents/edl-v10.php.

This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://www.stlport.org/doc/ license.html, http:// asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/

license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html; http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http://forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/software/tcltk/license.html, http://www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/iODBC/License; http://www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.net-snmp.org/about/license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html; http://www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/Bitmap.js; http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://jdbc.postgresql.org/license.html; http://protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/LICENSE; http://web.mit.edu/Kerberos/krb5-current/doc/mitK5license.html; http://jibx.sourceforge.net/jibx-license.html; and https://github.com/lyokato/libgeohash/blob/master/LICENSE.

This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and Distribution License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary Code License Agreement Supplemental License Terms, the BSD License (http:// www.opensource.org/licenses/bsd-license.php), the new BSD License (http://opensource.org/licenses/BSD-3-Clause), the MIT License (http://www.opensource.org/licenses/mit-license.php), the Artistic License (http://www.opensource.org/licenses/artistic-license-1.0) and the Initial Developer’s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).

This product includes software copyright © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab. For further information please visit http://www.extreme.indiana.edu/.

This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject to terms of the MIT license.

This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110; 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422; 7,676,516; 7,720,842; 7,721,270; 7,774,791; 8,065,266; 8,150,803; 8,166,048; 8,166,071; 8,200,622; 8,224,873; 8,271,477; 8,327,419; 8,386,435; 8,392,460; 8,453,159; 8,458,230; and RE44,478, International Patents and other Patents Pending.

DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of noninfringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is subject to change at any time without notice.

NOTICES

This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software Corporation ("DataDirect") which are subject to the following terms and conditions:

1.THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.

2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

Part Number: AD-DUG-56000-0001

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iiInformatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii

Informatica My Support Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii

Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii

Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii

Informatica How-To Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Informatica Support YouTube Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Chapter 1: Introduction to Informatica AddressDoctor Database Download Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Informatica AddressDoctor Database Download Manager Overview. . . . . . . . . . . . . . . . . . . . . . 1

Informatica Passport Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Postal Reference Databases and Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 2: Informatica ADM Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Informatica ADM Client Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Smart Download and Overwrite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Downloading and Accessing the Informatica ADM Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Logging In to the Informatica ADM Client and Setting the Default Version of Informatica AddressDoctor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Downloading Reference Address Databases by Using the Informatica ADM Client. . . . . . . . . . . . . 8

Downloading the Reference Address Databases from the Device CLI. . . . . . . . . . . . . . . . . . . . 12

The Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

The Download File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 3: Informatica ADM Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Informatica ADM Portal Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Downloading the Reference Address Databases from the Informatica ADM Portal. . . . . . . . . . . . 20

Downloading Informatica AddressDoctor Software Packages and the Documentation. . . . . . . . . . 22

Chapter 4: Use Cases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Downloading All Your Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Downloading Only the Latest Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Overwriting Existing Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Table of Contents i

Preface

Welcome to the Informatica AddressDoctor Database Download Manager User Guide. This guide provides an overview of the Informatica AddressDoctor Database Download Manager (Informatica ADM) portal and client, and explains the process for downloading the Informatica AddressDoctor reference address databases.

Informatica Resources

Informatica My Support PortalAs an Informatica customer, you can access the Informatica My Support Portal at http://mysupport.informatica.com.

The site contains product information, user group information, newsletters, access to the Informatica customer support case management system (ATLAS), the Informatica How-To Library, the Informatica Knowledge Base, Informatica Product Documentation, and access to the Informatica user community.

The site contains product information, user group information, newsletters, access to the Informatica How-To Library, the Informatica Knowledge Base, Informatica Product Documentation, and access to the Informatica user community.

Informatica DocumentationThe Informatica Documentation team takes every effort to create accurate, usable documentation. If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation team through email at [email protected]. We will use your feedback to improve our documentation. Let us know if we can contact you regarding your comments.

The Documentation team updates documentation as needed. To get the latest documentation for your product, navigate to Product Documentation from http://mysupport.informatica.com.

Informatica Web SiteYou can access the Informatica corporate web site at http://www.informatica.com. The site contains information about Informatica, its background, upcoming events, and sales offices. You will also find product and partner information. The services area of the site includes important information about technical support, training and education, and implementation services.

ii

http://mysupport.informatica.com

mailto:[email protected]


http://www.informatica.com

Informatica How-To LibraryAs an Informatica customer, you can access the Informatica How-To Library at http://mysupport.informatica.com. The How-To Library is a collection of resources to help you learn more about Informatica products and features. It includes articles and interactive demonstrations that provide solutions to common problems, compare features and behaviors, and guide you through performing specific real-world tasks.

Informatica Knowledge BaseAs an Informatica customer, you can access the Informatica Knowledge Base at http://mysupport.informatica.com. Use the Knowledge Base to search for documented solutions to known technical issues about Informatica products. You can also find answers to frequently asked questions, technical white papers, and technical tips. If you have questions, comments, or ideas about the Knowledge Base, contact the Informatica Knowledge Base team through email at [email protected].

Informatica Support YouTube ChannelYou can access the Informatica Support YouTube channel at http://www.youtube.com/user/INFASupport. The Informatica Support YouTube channel includes videos about solutions that guide you through performing specific tasks. If you have questions, comments, or ideas about the Informatica Support YouTube channel, contact the Support YouTube team through email at [email protected] or send a tweet to @INFASupport.

Informatica MarketplaceThe Informatica Marketplace is a forum where developers and partners can share solutions that augment, extend, or enhance data integration implementations. By leveraging any of the hundreds of solutions available on the Marketplace, you can improve your productivity and speed up time to implementation on your projects. You can access Informatica Marketplace at http://www.informaticamarketplace.com.

Informatica VelocityYou can access Informatica Velocity at http://mysupport.informatica.com. Developed from the real-world experience of hundreds of data management projects, Informatica Velocity represents the collective knowledge of our consultants who have worked with organizations from around the world to plan, develop, deploy, and maintain successful data management solutions. If you have questions, comments, or ideas about Informatica Velocity, contact Informatica Professional Services at [email protected].

Informatica Global Customer SupportYou can contact a Customer Support Center by telephone or through the Online Support.

Online Support requires a user name and password. You can request a user name and password at http://mysupport.informatica.com.

The telephone numbers for Informatica Global Customer Support are available from the Informatica web site at http://www.informatica.com/us/services-and-training/support-services/global-support-centers/.

Preface iii




http://www.youtube.com/user/INFASupport


http://www.informaticamarketplace.com




http://www.informatica.com/us/services-and-training/support-services/global-support-centers/

C H A P T E R 1

Introduction to Informatica AddressDoctor Database Download Manager

This chapter includes the following topics:

• Informatica AddressDoctor Database Download Manager Overview, 1

• Informatica Passport Overview, 2

• Postal Reference Databases and Packages, 2

Informatica AddressDoctor Database Download Manager Overview

You can use Informatica AddressDoctor Database Download Manager (Informatica ADM) to select and download reference address databases for the Informatica AddressDoctor solution. Informatica ADM is available as a web portal and as a Java based client application that you can install on a device that has Internet access. You can access the Informatica ADM portal from the Informatica Passport dashboard. You can download the client application from the portal and install it on a device that has Internet access.

The Informatica ADM portal and client are integrated with the Informatica Passport single sign-on solution. You can use your Informatica Passport user profile to seamlessly access various Informatica tools and portals including Informatica ADM and Informatica AddressDoctor Data Quality Center (Informatica AddressDoctor DQC).

Note: If you do not have an Informatica Passport user profile, you must create an Informatica Passport user profile and assign your Informatica AddressDoctor DQC accounts to the Informatica Passport user profile before you can use Informatica ADM.

By default, the Informatica ADM portal and client display the list of reference address databases that your Informatica Passport user profile is authorized to download. You get download rights for reference address databases when you buy unlock codes for the databases. If multiple Informatica AddressDoctor DQC accounts have been mapped to the Informatica Passport user profile that you used to log in, Informatica ADM displays all the databases that the Informatica AddressDoctor DQC accounts associated with the Informatica Passport user profile are authorized to download.

From the Informatica ADM portal, you can download only one reference address database at a time. You can use the Informatica ADM client to download multiple databases together. You can use the default option of

1

Smart Download in the Informatica ADM client to download only those files that have been updated since you last downloaded the files.

You can also download the latest Informatica AddressDoctor software packages and documentation from the Informatica ADM portal.

Note: Informatica ADM returns a blank page in the following scenarios:

• Your Informatica Passport user profile does not have any Informatica AddressDoctor DQC account associated with it.

• The Informatica AddressDoctor DQC account that is associated with your Informatica Passport user profile does not have any valid unlock code provisioned for it .

You can use the filtering options available in the Informatica ADM portal and client to identify the databases that you need to download. You can also view the complete list of databases that are available for Informatica AddressDoctor customers by clearing the Show Allowed check box.

RELATED TOPICS:• “Informatica ADM Client Overview” on page 4

• “Informatica ADM Portal Overview” on page 17

• “Smart Download and Overwrite” on page 6

Informatica Passport OverviewInformatica Passport is a single sign-on solution that enables you to access Informatica portals, solutions, and products with a single sign-on.

Informatica Passport is powered by Okta and provides seamless access to Informatica My Support, Marketplace, and various Informatica applications and solutions, such as Informatica AddressDoctor DQC and Informatica ADM. Informatica Passport and Informatica ADM are integrated by using the Security Assertion Markup Language (SAML) data format.

If you do not have an Informatica Passport user profile, you can click the Register link at https://dqc.addressdoctor.com/SSO and create an account. For more information about creating an Informatica Passport user profile, see Informatica AddressDoctor Data Quality Center User Guide, which is available at the Informatica My Support portal.

Postal Reference Databases and PackagesInformatica AddressDoctor postal reference databases are proprietary-format databases that contain reference addresses from countries and territories that Informatica AddressDoctor supports for validation. The database names contain information about the country or territory to which the addresses belong, the process mode or enrichments supported, and the main version of Informatica AddressDoctor that the database is compatible with.

Informatica AddressDoctor supports validation of postal addresses from over 240 countries and territories. Informatica AddressDoctor provides reference address databases for supported countries and territories in .MD format, which is an Informatica AddressDoctor proprietary format. The reference address databases

2 Chapter 1: Introduction to Informatica AddressDoctor Database Download Manager

HTTPS://DQC.ADDRESSDOCTOR.COM/SSO

are read-only and platform-independent. You can use the same database on all platforms that support Informatica AddressDoctor.

The reference database file name follows the XXXYZZZZ.MD format, where XXX stands for the ISO 3166-1 alpha 3 code for the country or territory, Y the Informatica AddressDoctor main version, and ZZZZ the reference database type, such as BI for Batch and Interactive, FC for Fast Completion, or GCAP for High Precision Arrival Point Geocoding.

From Informatica ADM, you can download the postal reference databases that are provided as country- or territory-specific .zip packages. The .zip file names follow the DB5_XXXYZZZZ_YYMMDD.zip format. XXX in the file name stands for the ISO 3166-1 alpha 3 code for the country or territory. ZZZZ indicates the reference database type such as Batch and Interactive (BI), Fast Completion (FC), or High Precision Arrival Point Geocoding (GCAP). YYMMDD indicates the date the database was released.

Note: If a particular database is supported only up to a certain version of Informatica AddressDoctor, the last supported version is indicated in the file name. For example, the Singapore Batch and Interactive database has two versions: DB5_SGP5BI_529_140801.zip and DB5_SGP5BI_140801.zip. The first one, DB5_SGP5BI_529_140801.zip, is supported only up to Version 5.2.9 of Informatica AddressDoctor, whereas the second one, DB5_SGP5BI_140801.zip, is current and supported on Version 5.3.0 and later.

For example, you can decode the file name DB5_USA5BI_131110.zip as Informatica AddressDoctor Version 5 (DB5) Batch and Interactive (BI) mode database for the United States (USA) that was released on November 10, 2013 (131110).

Informatica AddressDoctor supports the following types of reference address databases:BI

Batch and interactive.

FC

Fast completion.

Cx

Certified. x is a numeric. For example, SERP-certified database for Canada addresses.

AC

Address code lookup.

GC

Standard geocoding.

GCAP

Arrival point geocoding.

GCPC

Parcel centroid geocoding.

CA

CAMEO.

Ex

Supplementary. x is a numeric. For example, INSEE code information for France addresses.

Informatica AddressDoctor provides multiple reference address databases for many of the countries and territories that are supported for address validation and enrichments. For example, DEU5BI.MD, DEU5FC.MD, and DEU5GC.MD are some of the reference address databases that are available for Germany addresses.

You need valid unlock codes, including specific codes for enrichment databases such as geocoding and CAMEO, to unlock these databases.

Postal Reference Databases and Packages 3

C H A P T E R 2

Informatica ADM ClientThis chapter includes the following topics:

• Informatica ADM Client Overview, 4

• Smart Download and Overwrite, 6

• Downloading and Accessing the Informatica ADM Client, 7

• Logging In to the Informatica ADM Client and Setting the Default Version of Informatica AddressDoctor, 8

• Downloading Reference Address Databases by Using the Informatica ADM Client, 8

• Downloading the Reference Address Databases from the Device CLI, 12

• The Properties File, 14

• The Download File, 15

Informatica ADM Client OverviewThe Informatica ADM client is a Java based application that you can use to select and download multiple reference address database. You can download the Informatica ADM client application from the Informatica ADM portal and install on a device that has Internet access. You can use the smart download option, which is enabled by default, in the Informatica ADM client to download all the files that have been updated since you last downloaded the databases.

The Informatica ADM client is integrated with the Informatica Passport single sign-on solution. You can use your Informatica Passport user credentials to log on to the Informatica ADM client. When you log in to the Informatica ADM client, you can save your authentication credentials and specify the version of Informatica AddressDoctor for which you want to download the reference address databases.

By default, the Informatica ADM client lists all the reference address databases that your Informatica Passport user profile is authorized to download. However, you can choose to view the complete list of reference address databases that Informatica AddressDoctor provides or filter the list of reference address databases based on one or more of the following filtering options.

Version

Informatica AddressDoctor version for which you want to view or download reference address databases.

Database Type

The type of reference address databases that you want to view or download. For example: Batch and Interactive (BI) or Fast Completion (FC).

4

Country

Name of the country for which you want to view or download reference address databases.

Database Release Date

The release date of the reference address databases that you want to view or download. You can choose from the following options:

• Latest Release. The latest updates available for the databases that meet the specified criteria. This is the default option.

• Last 1 Month. The files that have been updated in the last one month.

• Last 2 Months . The files that have been updated in the last two months.

• Last 3 Months. The files that have been updated in the last three months.

The Informatica ADM client displays the following details of the reference address databases.

Country Name

Name of the country.

Database Type

Type of the database, such as Batch and Interactive (BI) or Fast Completion (FC).

Database Release Date.

The date on which the database was released.

Supported Versions.

Informatica AddressDoctor version with which the database is compatible.

File Name

File name of the database.

Access

Whether your Informatica Passport user profile has permissions to download the database.

Size

Size of the database.

Account Number

The Informatica AddressDoctor DQC account for which the unlock code of the database has been provisioned.

RELATED TOPICS:• “Informatica AddressDoctor Database Download Manager Overview” on page 1


• “Downloading and Accessing the Informatica ADM Client” on page 7

• “Downloading Reference Address Databases by Using the Informatica ADM Client” on page 8

• “Downloading the Reference Address Databases from the Device CLI” on page 12

Informatica ADM Client Overview 5

Smart Download and OverwriteYou can use the smart download feature to ensure that you download only those databases that you have not downloaded previously. Smart download is enabled by default. You can enable overwrite if you want the Informatica ADM client to overwrite the files present in the download directory when you select the same files for download.

When the smart download option is enabled, the Informatica ADM client checks the downloadhistory.xml file associated with the user profile and downloads only those files that are not listed in downloadhistory.xml. The Informatica ADM client creates the downloadhistory.xml file when you first download reference address databases by using the client, and saves it to the location where you have saved the client. On subsequent downloads, the Informatica ADM client updates the downloadhistory.xml file to include information about files that you download.

The following example shows a typical downloadhistory.xml file:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><DownloadDetail> <FileDownloadInfo> <countryName></countryName> <fileName>DB5_CAN5FC_140901.zip</fileName> <status>Downloaded</status> <downloadDate>2014/09/17 11:19:11</downloadDate> </FileDownloadInfo> <FileDownloadInfo> <countryName></countryName> <fileName>DB5_USA5BI_140901.zip</fileName> <status>Downloaded</status> <downloadDate>2014/09/17 11:19:45</downloadDate> </FileDownloadInfo> <FileDownloadInfo> <countryName></countryName> <fileName>DB5_CAN5C1_140901.zip</fileName> <status>Downloaded</status> <downloadDate>2014/09/17 11:20:28</downloadDate> </FileDownloadInfo></DownloadDetail>

In the preceding example, you can see that the downloaded files include Canada Fast Completion database, Canada Certified database, and the United States Batch and Interactive database. So, next time if the user tries to download these files when smart download is enabled, the Informatica ADM client marks them as already downloaded and skips downloading these files. This way, the Informatica ADM client optimizes the download process and ensures that it downloads only those files that have not been downloaded previously.

To download all the files that you choose to download irrespective of whether those files have been downloaded previously, disable the smart download feature. To disable the smart download feature, clear the Smart Download check box from the Informatica ADM client window.

However, if the previously downloaded files are present in the download location, the Informatica ADM client does not overwrite those files unless you explicitly configure the client to overwrite old files. You can enable the overwrite option if you want the Informatica ADM client to overwrite the files present in the download directory when you select the same files for download again.

To enable overwrite, select the Overwrite Old Files check box from the Informatica ADM client window.

Note that the smart download option always takes precedence over the overwrite option. If you enable both smart download and overwrite, the Informatica ADM downloads and overwrites only those files that are not listed in the downloadhistory.xml file .

6 Chapter 2: Informatica ADM Client


• “Informatica AddressDoctor Database Download Manager Overview” on page 1


Downloading and Accessing the Informatica ADM Client

The Informatica ADM client is a Java based application that you can use to download the reference address databases for Informatica AddressDoctor. You can download the Informatica ADM client from the Informatica ADM portal and install it on a device that has Internet access.

Note: You must have the Java Runtime Environment version 7 or later installed on the device on which you want to install the Informatica ADM client.

1. Go to https://download.addressdoctor.com and enter your Informatica Passport credentials.The Informatica Passport dashboard appears.

2. Click the Informatica AddressDoctor Database Download Manager link.The Informatica ADM portal appears.

3. Click the Download link from the menu bar.The Download Section page appears.

4. Click the ADM Client link under the Informatica AddressDoctor Database Download Manager section.

5. Click Save (or Save As based on your browser settings) in the Download dialog box and specify a location to save the .zip file.

6. Extract the contents of the downloaded .zip file to a location of your choice. For example: C:\Program Files\AddressDoctor\ADM

The DownloadTool.zip package contains the DownloadTool.jar file and the lib directory, which contains several .jar files.

You can also download the Informatica ADM documentation from the Download Section page. To download the Informatica ADM documentation, click the Documentation link in the Informatica AddressDoctor Database Download Manager section.

To launch the Informatica ADM client GUI, double-click the DownloadTool.jar file from the directory to which you extracted the .zip file contents. When you launch the Informatica ADM client GUI, the Informatica ADM client adds the following files to the directory to which you saved DownloadTool.jar:

config.propertieslog.html

When the Informatica ADM client is open, log.html remains locked for editing. The Informatica ADM client releases the log file when you close the application.

You can also access the client from the command-line interface (CLI) of the device on which you installed the Informatica ADM client to complete database downloads. To access the client from the CLI, you must have valid instances of the properties file (config.properties) and the download file (download.xml) files on the device.

Downloading and Accessing the Informatica ADM Client 7

HTTPS://DOWNLOAD.ADDRESSDOCTOR.COM

Tip: Run the GUI version of the Informatica ADM client before you access the Informatica ADM client from the device CLI for the first time. When you run the GUI version of the Informatica ADM client for the first time, the Informatica ADM client creates an instance of the config.properties file on the device on which you installed the client.


Logging In to the Informatica ADM Client and Setting the Default Version of Informatica AddressDoctor

You can use your Informatica Passport user name and password to log in to the Informatica ADM client. When you log in to the client, you can also select the version of Informatica AddressDoctor that you want to designate as the default version on the Informatica ADM client. If required, you can change the default version from the Informatica AddressDoctor client window.

1. To open the Informatica ADM client, double-click DownloadTool.jar from the location where you extracted the contents of DownloadTool.zip.

The Informatica ADM client login window appears.

2. Enter your Informatica Passport user name and password.

3. Click Login. If you want Informatica ADM to save the credentials, select the Remember Me check box.

The Select Your Informatica AddressDoctor Version window appears.

4. Select the version of Informatica AddressDoctor that you want to designate as the default version in the Informatica ADM client, and click Select and Set as Default.

The Informatica ADM client window appears.

5. Optionally, to change the default version that you configured in the previous step, click Change Default Version, and repeat Step 4.

The Informatica ADM client updates the list of databases to match the default version you selected.

Downloading Reference Address Databases by Using the Informatica ADM Client

You can use the Informatica ADM client to download multiple reference databases together. By default, the Informatica ADM client displays a list of databases that your Informatica Passport user profile is authorized to download. You can use the filtering options available in the client GUI to search for and select reference address databases that match your requirements.

1. To log in to the Informatica ADM client, perform one of the following steps:

• Enter your Informatica Passport user name and password and click Login. From the Select the Engine Version window, select the version of Informatica AddressDoctor that you want to designate as the default version in the Informatica ADM client, and click Select and Set as Default.


• If you selected the Remember Me check box when you last logged in to the client, the Informatica ADM client uses your credentials from the config.properties file. To log in using the saved credentials, click Login.

• To log in with a different set of user name and password, clear the Use Saved Login check box, and enter the Informatica Passport credentials that you want to log in with. From the Select the Engine Version window, select the version of Informatica AddressDoctor that you want to designate as the default version in the Informatica ADM client, and click Select and Set as Default.

The Informatica ADM client window appears. The Informatica ADM client displays the list of databases that the Informatica AddressDoctor DQC accounts associated with your Informatica Passport user profile are authorized to download and are compatible with the Informatica AddressDoctor version you set as default.

2. Optionally, to see all the reference address databases that are available for the Informatica AddressDoctor version you set as default, clear the Show Allowed check box.

The Informatica ADM client returns the list of reference address databases available for the Informatica AddressDoctor default version that you selected.

3. Optionally, to view reference address databases that are available for Informatica AddressDoctor versions other than the default version you selected, select the Change Version check box and select an Informatica AddressDoctor version from the Versions list. To make multiple selections, hold down the CTRL key or the Shift key and select the versions.

The Informatica ADM client returns the list of reference address databases available for the selected Informatica AddressDoctor version.

Downloading Reference Address Databases by Using the Informatica ADM Client 9

4. Specify one or more of the following filtering criteria. To make multiple selections from the Country and Database type lists, hold down the CTRL key or the Shift key and select the values.

Setting Description

Country The country for which you want to view or download reference address databases.Available options include all countries and territories that Informatica AddressDoctor supports for address validation. You can select one or more countries. Default is All Countries.

Database Type The type of database, such as Batch and Interactive (BI) or Fast Completion (FC), that you want to view or download.You can select one or more of the following options:- All File Types- Fast Completion (FC)- Batch and Interactive (BI)- Geocoding (GC)- Point Geocoding Arrival Point (GCAP)- Point Geocoding Parcel Centroid (GCPC)- CAMEO (CA)- Supplementary (E1, E2, E3,...Ex)- Certified (C1, C2, C3,...Cx)- Address Code Lookup (AC)Default is All File Types.

Date The release date of the database that you want to download.You can select only one of the following options:- Latest Release. Returns the latest available version of the databases that

match the filtering criteria you specified. This is the least restrictive of the Date options that you can select. For example, if you set the Latest Release option for Austria, the results include the following files:- GCAP database released in March 2014- BI database released in September 2014- CAMEO database released in December 2013- FC database released in September 2014

- Last 1 Month. Returns the list of databases that have been updated since the beginning of the last calender month and match the filtering criteria you specified.

- Last 2 Months. Returns the list of databases that have been updated in the last two calender months and match the filtering criteria you specified.

- Last 3 Months. Returns the list of databases that have been updated in the last three calender months and match the filtering criteria you specified.

Default is Latest Release.

The Informatica ADM client returns a list of databases based on the filtering options you selected. By default, the Check All check box is selected and all the databases that match the filtering criteria you specified are marked for download.

5. Optionally, if you do not want to download all the databases that are marked for download, clear the Check All check box and then, select the databases that you want to download.

Note: You can select only those databases that your Informatica Passport user profile is authorized to download.

6. To add the selected files to the download queue, click Proceed to Download.

The Informatica ADM client displays the list of files selected for download and the download option. The download list shows the details of the selected files, such as file names, database type, and size, and


the status of the download request. When you click Proceed to Download, the Informatica ADM client writes the information about the selected databases to the download file, download.xml.

7. Optionally, to disable smart download, clear the Smart Download check box.

The smart download option is enabled by default. You can keep the smart download option enabled if you do not want the Informatica ADM client to download databases that are listed in the downloadhistory.xml file. If you disable the smart download option, the Informatica ADM client downloads all the selected files even if those files are listed in the downloadhistory.xml .

8. Optionally, to download files that are present in the download directory and overwrite the local files with files from Informatica AddressDoctor, select the Overwrite Old Files check box.

The overwrite option is disabled by default. If you enable the overwrite option, the Informatica ADM client overwrites files that are in the download directory if you have selected the same files for download again.

9. To specify the download location where you want to save the downloaded files, enter the download location in the File Save Path field.

You can either type the path to the location where you want to save the downloaded files or click the Browse button to navigate to the location. If you do not specify a download location, the Informatica ADM client creates a new directory called Downloads under the same directory to which the client is saved.

10. Optionally, to remove an entry from the download list, select the entry that you want to remove and click Remove.

Informatica AddressDoctor removes the selected entry from the download list and updates the list to reflect the change.

11. To download the selected files, click Start Download.

The Progress column in the Download list shows the progress of the download as a percentage of the file size. You can right-click an entry in the download list to pause or resume its download.

12. To stop the download process, click Stop.

The Informatica ADM client prompts you to confirm whether you want to stop the download process. To confirm, click Yes.

The Informatica ADM client stops the download process. To restart the download, click Start Download.

13. Optionally, to go back to the previous window and modify the download list, click Back.

Warning: If you click the Back button when a download is in progress, the Informatica ADM client aborts the download process.

The Informatica ADM client displays the list of databases and filtering options. After you make the changes, click Proceed to Download, and repeat step 8 onwards.

Downloading Reference Address Databases by Using the Informatica ADM Client 11

14. After you complete downloading the required databases, click Log Out to close the Informatica ADM client.

Warning: If you exit the client while a download is in progress, the Informatica ADM client terminates the ongoing download.



Downloading the Reference Address Databases from the Device CLI

You can download the reference address databases from the CLI of the device on which you installed the Informatica ADM client. From the device CLI, you can download either all the databases that your Informatica Passport user profile is authorized to download or only those databases that are listed in the download file. You can further filter the list of databases by modifying the FileType and Country parameters in the properties file.

To initiate the download of databases from the device CLI, enter the java -jar DownLoadTool.jar command along with one or more of the following options:

-NoGui or -ng

Validates the user credentials from the properties file, config.properties, and downloads databases that are listed in the download file, download.xml. The Informatica ADM client returns an error message and terminates the session in the following instances:

• The properties file is not present in the directory where the Informatica ADM client is installed.

• The properties file is present in the directory but does not contain user credentials.

If the download file is not found in the directory where you have installed the Informatica ADM client, the ADM client generates the download file with information about all the databases that your Informatica Passport user profile is authorized to download and starts downloading the databases.

-UserName or -un

Specifies your Informatica Passport user name. You can enter the user name preceded by -UserName or -un and a colon (:). For example:

java -jar DownLoadTool.jar -un:[email protected] you enter this command, the Informatica ADM client prompts you for your Informatica Passport password. You can also provide one or more of the following parameters along with the -UserName or -un option.

-PassWord or -pd

Specifies the password for your Informatica Passport user name. Along with the user name parameter, you can also provide the password parameter. You can specify the password preceded by -PassWord or -pd and a colon (:). For example:

java -jar DownLoadTool.jar -un:[email protected] -pd:Pwd#1234


Note that the password you enter for the -PassWord or -pd parameter appears on the screen as plaintext, whereas the password you enter at the password prompt of the Informatica ADM client is hidden. To protect the integrity of your password, you can omit the password parameter from the command and enter the password at the password prompt.

-OverWrite or -o

Indicates whether to overwrite the already downloaded files or not. The available options are yes and no. The default is no. For example:

java -jar DownLoadTool.jar -un:[email protected] -o:yesIf you set the overwrite parameter to yes, the Informatica ADM client overwrites the files that are available at the download location even if the files are identical.

-DownloadType or -dt

Specifies whether to download all the databases that your Informatica Passport user profile is authorized to download or only those databases that are listed in the download file. The available options are all and custom. For example:

java -jar DownLoadTool.jar -un:[email protected] -o:yes -dt:allIf you set the download type parameter to all, the Informatica ADM client updates the download file to include all the databases that your Informatica Passport user profile is authorized to download and downloads all those databases. If you set the download type parameter to custom, Informatica ADM downloads only those databases that are listed in the download file.

-Engine or -eg

Specifies the Informatica AddressDoctor version for which you want to download the databases. For example:

java -jar DownLoadTool.jar -un:[email protected] -o:yes -dt:all -en:5.4.0If you specify the Informatica AddressDoctor version, the Informatica ADM client downloads only those databases that are compatible with the specified version of Informatica AddressDoctor.

-Smart or -s

Specifies whether to enable smart download or not. The available options are yes and no. The default value is yes. For example:

java -jar DownLoadTool.jar -un:[email protected] -s:yes-dt:allWhen smart download is enabled, the Informatica ADM client downloads only those files that you have not downloaded previously. The client checks the downloadhistory.xml file to identify the files you downloaded and skips downloading those files even if those files are included in the download list.

-Remember or -rn

Specifies whether to save your settings or not. The available options are yes and no. The default value is yes. For example:

java -jar DownLoadTool.jar -un:[email protected] -s:yes-dt:all-rm:yesIf you set this parameter to yes, the Informatica ADM client saves your configuration settings in the config.properties file. If you set this parameter to no, the configuration is discarded when you log out of the client.

Viewing the Online HelpTo view the online help for the Informatica ADM client CLI, enter the -help, -h, or /? option along with the java -jar DownloadTool.jar command. For example:

C:\ADM>java -jar DownLoadTool.jar -hWelcome to Informatica AddressDoctor Database Download Manager ( Version 1.0.0 )

Downloading the Reference Address Databases from the Device CLI 13

[-nogui | -ng] Run software in command line[-UserName | -un] ] Specify the user name. For example, -un:[email protected][-Password | -pd] Specify the password[-Overwrite | -o] Specify whether to overwrite the files or not. Available values are yes and no; the default is no[-DownloadType | -dt] Specify whether to download all files that you are allowed to download <all> or only specific files <custom>. The default is all. When set to all, the Informatica ADM client generates a new download.xml that contains information about all the files that you are authorized to download. When set to custom, the client downloads only those files that are listed in download.xml[-engine | -eg] Specify the version of Informatica AddressDoctor for which you want to download the reference address databases. The client stores this information in the config file. For example, 5.4.0 [-help | -h | /?] Display command-line help[-smart | -s ] Specify whether to enable smart download or not. When enabled, the client checks the download history and download only those files that have not been downloaded previously. Available values are yes and no. The default is yes.


• “The Properties File” on page 14

• “The Download File” on page 15


The Properties FileThe properties file, config.properties, contains the configuration information for the Informatica ADM client. Values in this file, except for the filesstorepath and engineversion value, are read-only.

The first time you log in to the Informatica ADM client, the Informatica ADM client creates an instance of the properties file in the directory to which you have saved the DownloadTool.jar file. The Informatica ADM client writes the following configuration information to the properties file:DownloadDirectory

Contains the location where you want to store the downloaded files. If you do not specify any download location, the Informatica ADM client creates a new directory called Downloads under the directory where the client is saved.

Token

Contains a system-generated access code, token, that Informatica AddressDoctor assigns to a user when the user logs in to the Informatica ADM client for the first time. A token is valid for one year duration from the time it was generated.

DownloadType

Indicates the type of download. The available values are All and Custom. When set to All, the Informatica ADM client downloads all the files that you are authorized to download. When set to Custom, the client downloads only those files that you select to download. The default value is All.

Overwrite

Denotes whether to overwrite existing files or not. Supported values are Yes and No. When Overwrite is set to Yes, the Informatica ADM client overwrites the files that are in the download directory if you choose to download the same files again. The default value is No.


UserName

Contains the user name that you used to log in.

EngineVersion

Contains the Informatica AddressDoctor version that you selected as default.

Smart

Indicates whether smart download is enabled (Yes) or not (No). The default value is Yes.

FileType

Indicates the type of database, such as BI or FC, that you want to download. The default value is All.

Country

Contains the ISO codes of the countries for which you want to download the databases. The default value is All.

The structure of config.properties is as follows:

#Wed Sep 17 20:00:57 IST 2014DownloadDirectory=C\:\\ADM/Downloadstoken=9f7********6e1DownloadType=AllOverWrite=NoUserName=ADMUser@YourDomain.comEngineVersion=5.4.0Smart=YesFileType=ALLCountry=ALL;

If you change the values for servername, token, or username, the Informatica ADM client overwrites your changes when you log in to the Informatica ADM client GUI.

RELATED TOPICS:• “The Download File” on page 15

The Download FileThe download file, download.xml, contains information about the databases that you selected for download. Typically, the download file is generated by the Informatica ADM client when you use its GUI to select reference address databases.

When you select reference address databases from the Informatica ADM client GUI and click Add to Download, the Informatica ADM client creates the download file and adds the details of the selected databases to the file. The download file is saved to the same directory to which you saved the DownloadTool.jar file.

The download file contains the name of the country and the name of the compressed file that contains the reference address database for the selected country. From the file names listed in the Download file, you can identify the type of the databases that are queued for download. The download file also contains a time stamp that shows the time when you last updated the download list.

Every time you make a change to the list of databases to download, the Informatica ADM client updates the download file to reflect the changes you make to the list of files to download. If you want to use the Informatica ADM client from the CLI of the device to which you have downloaded the Informatica ADM client, you can manually update the download file and include information about databases that you want to

The Download File 15

download. When you create or update the download file manually, ensure that you do not alter the XML structure of the file.

The following example shows the XML structure of a download.xml file:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <FiletoDownloadQueue> <DlFileStructure> <countryName>United States</countryName> <fileName>DB5_USA5FC_131101.zip</fileName> </DlFileStructure> <DlFileStructure> <countryName>France</countryName> <fileName>DB5_FRA5BI_131101.zip</fileName> </DlFileStructure> <DlFileStructure> <countryName>France</countryName> <fileName>DB5_FRA5FC_131101.zip</fileName> </DlFileStructure> <DlFileStructure> <countryName>Germany</countryName> <fileName>DB5_DEU5FC_131101.zip</fileName> </DlFileStructure> <DlFileStructure> <countryName>United Kingdom</countryName> <fileName>DB5_GBR5FC_131101.zip</fileName> </DlFileStructure> <DlFileStructure> <countryName>United States</countryName> <fileName>DB5_USA5BI_131101.zip</fileName> </DlFileStructure> <Created>2014/07/27 16:31:42</Created> </FiletoDownloadQueue>

The preceding example shows a download.xml file that has databases for the following countries listed for download:

• United States. One Batch and Interactive (BI) database and one Fast Completion (FC) database.

• France. One Batch and Interactive (BI) database and one Fast Completion (FC) database.

• Germany. One Fast Completion (FC) database.

• United Kingdom. One Fast Completion (FC) database.

RELATED TOPICS:• “The Properties File” on page 14


C H A P T E R 3

Informatica ADM PortalThis chapter includes the following topics:

• Informatica ADM Portal Overview, 17

• Downloading the Reference Address Databases from the Informatica ADM Portal, 20

• Downloading Informatica AddressDoctor Software Packages and the Documentation, 22

Informatica ADM Portal OverviewYou can use the Informatica ADM portal to download reference address databases, the ADM client, Informatica AddressDoctor software packages, and the Informatica AddressDoctor documentation. The Informatica ADM portal is integrated with the Informatica Passport single sign-on. You can use your Informatica Passport credentials to access the ADM portal from the Informatica Passport dashboard.

By default, the Informatica ADM portal displays the list of reference address databases that your Informatica Passport user profile is authorized to download. From the Informatica ADM portal, you can also view the complete list of reference databases that Informatica AddressDoctor provides. You can further filter the list based on the following criteria.

Version

Informatica AddressDoctor version for which you want to view or download reference address databases.

Database Type

The type of reference address databases that you want to view or download. For example: Batch and Interactive (BI) or Fast Completion (FC).

Country

Name of the country for which you want to view or download reference address databases.

Database Release Date

The release date of the reference address databases that you want to view or download. You can choose from the following options:

• Latest Release. The latest updates available for the databases that meet the specified criteria. This is the default option.

• Last 1 Month. The files that have been updated in the last one month.

• Last 2 Months . The files that have been updated in the last two months.

• Last 3 Months. The files that have been updated in the last three months.

17

You can view the following details of the reference address databases from the Informatica ADM portal.Country Name

Name of the country.

Database Type

Type of the database, such as Batch and Interactive (BI) or Fast Completion (FC).

Database Release Date.

The date on which the database was released.

Supported Versions.

Informatica AddressDoctor version with which the database is compatible.

File Name

File name of the database.

18 Chapter 3: Informatica ADM Portal

The following image shows the Informatica ADM portal home page.

From the Download Section page of the Informatica ADM portal, you can also download the latest versions of Informatica AddressDoctor software packages and documentation for Informatica AddressDoctor, Informatica AddressDoctor Cloud, and Informatica ADM.

Informatica ADM Portal Overview 19

From the Informatica ADM portal, you can navigate to the Informatica MySupport portal (by clicking the Support link in the menu bar) and the Informatica AddressDoctor Data Quality Center (by clicking the DQC link in the menu bar).

RELATED TOPICS:• “Informatica AddressDoctor Database Download Manager Overview” on page 1

• “Downloading the Reference Address Databases from the Informatica ADM Portal” on page 20

• “Downloading Informatica AddressDoctor Software Packages and the Documentation” on page 22

Downloading the Reference Address Databases from the Informatica ADM Portal

You can download the reference address databases from the Informatica ADM portal. However, note that you can download only one database at a time from the portal. If you need to download multiple reference address databases together, use the Informatica ADM client. You can download the Informatica ADM client from the Informatica ADM portal.

1. Go to https://download.addressdoctor.com and enter your Informatica Passport credentials.

The Informatica Passport Dashboard page appears.

2. Click the Informatica ADM link from the Informatica Passport dashboard.

The Informatica ADM Portal home page appears. By default, Informatica ADM portal displays the list of databases that your Informatica Passport user profile is authorized to download. A yellow mark on the left side of the country name indicates that the corresponding file has been updated in the last database release.

3. Optionally, to see all the reference address databases that are available for Informatica AddressDoctor customers, clear the Show Allowed check box.

4. To specify the Informatica AddressDoctor version for which you want to view or download the reference address databases, select the Informatica AddressDoctor versions from the Version list. To make multiple selections, hold down the CTRL key or the Shift key and select the values.


HTTPS://DOWNLOAD.ADDRESSDOCTOR.COM

5. Specify one or more of the following filtering criteria. To make multiple selections from the lists, hold down the CTRL key or the Shift key and select the values.

Setting Description

Country The country for which you want to view or download reference address databases.Available options include all countries and territories that Informatica AddressDoctor supports for address validation. You can select one or more countries. Default is All Countries.

Database Type The type of database, such as Batch and Interactive (BI) or Fast Completion (FC), that you want to view or download.You can select one or more of the following options:- All File Types- Fast Completion (FC)- Batch and Interactive (BI)- Geocoding (GC)- Point Geocoding Arrival Point (GCAP)- Point Geocoding Parcel Centroid (GCPC)- CAMEO (CA)- Supplementary (E1, E2, E3,...Ex)- Certified (C1, C2, C3,...Cx)- Address Code Lookup (AC)Default is All File Types.

Date The release date of the database that you want to download.You can select only one of the following options:- Latest Release. Returns the latest available version of the databases that

match the filtering criteria you specified. This is the least restrictive of the Date options that you can select. For example, if you set the Latest Release option for Austria, the results include the following files:- GCAP database released in March 2014- BI database released in September 2014- CAMEO database released in December 2013- FC database released in September 2014

- Last 1 Month. Returns the list of databases that have been updated since the beginning of the last calender month and match the filtering criteria you specified.

- Last 2 Months. Returns the list of databases that have been updated in the last two calender months and match the filtering criteria you specified.

- Last 3 Months. Returns the list of databases that have been updated in the last three calender months and match the filtering criteria you specified.

Default is Latest Release.

6. After you specify the filter settings, click Apply Filter.

The Informatica ADM portal returns a list of databases based on the criteria you specified in the previous steps.

7. To download a database, click the Download button corresponding to the database that you want to download.

8. From the Download dialog box, click Save (or Save As, based on your browser settings) and specify the location where you want to save the database.

9. If you want to download more than one reference address database, repeat Steps 4 through 8.

Downloading the Reference Address Databases from the Informatica ADM Portal 21

RELATED TOPICS:• “Informatica ADM Portal Overview” on page 17

Downloading Informatica AddressDoctor Software Packages and the Documentation

You can download the latest version of Informatica AddressDoctor software and documentation from the Informatica ADM portal. The Download Section page of the Informatica ADM portal contains links to the latest software version packages of Informatica AddressDoctor. The Download Section page also contains links to the Informatica AddressDoctor and Informatica AddressDoctor Cloud documentation.

You can download Informatica AddressDoctor software packages that match your server environment and license. To download a software package, click the corresponding operating system name from the 32-bit packages list or the 64-bit packages list and save the package.

For example, if you have a license for 64-bit Windows Server 2008 or 2012 version of Informatica AddressDoctor, click the Windows link under 64-bit OS packages and save the package.

You can also download the documentation for Informatica AddressDoctor and Informatica AddressDoctor Cloud from the Download Section page. To download documentation, click the corresponding link and save the file.

For example, to download the Release Notes for Informatica AddressDoctor Cloud, click the Release Notes link in the Informatica AddressDoctor Cloud section and save the file.

RELATED TOPICS:• “Informatica ADM Portal Overview” on page 17


C H A P T E R 4

Use CasesThis chapter includes the following topics:

• Downloading All Your Files, 23

• Downloading Only the Latest Files, 24

• Overwriting Existing Files, 24

Downloading All Your FilesIf you want to download all the databases that you are authorized to download, use the Informatica ADM client to download the databases.

1. Download the Informatica ADM client from the Informatica ADM portal.

2. Extract the contents of the downloaded .zip file.

3. Double-click DownloadTool.jar. The Informatica ADM client login window appears.

4. Enter your Informatica Passport User Profile user name and password, and click Login. The Select Your Informatica AddressDoctor Version window appears.

5. Select your Informatica AddressDoctor version and click Select and Set as Default. The Informatica ADM client filtering options window appears.

6. Ensure that the Check All check box is selected, and click Proceeed to Download. The Informatica ADM client download list window appears.

7. Click Start Download.

The Informatica ADM client starts downloading all the databases that you are authorized to download.

Alternatively, from the device CLI, go to the directory to which you extracted DownloadTool.jar, and enter the following command:

java -jar DownloadTool.jar -un:<yourusername> The Informatica ADM client CLI prompts you for the password. Enter your password, and the Informatica ADM client starts downloading all the files that you are authorized to download.

RELATED TOPICS:• “Downloading Only the Latest Files” on page 24

• “Overwriting Existing Files” on page 24

23

Downloading Only the Latest FilesIf you have already downloaded the databases that you are authorized to download and want to download only the databases that have been updated subsequent to your last download, use the smart download feature in the Informatica ADM client. When you enable the smart download feature, the Informatica ADM client checks the download log in the downloadhistory.xml file and downloads only those files that are not listed in the download log.


2. Enter your Informatica Passport User Profile user name and password, and click Login. The Select Your Informatica AddressDoctor Version window appears.



5. Ensure that the Smart Download check box is selected.


The Informatica ADM client starts downloading those files that have been updated from the time you last downloaded the files. Files that were previously downloaded are marked Already Downloaded or Exist; No Update Required.


java -jar DownloadTool.jar -un:<yourusername> -s:yes The Informatica ADM client CLI prompts you for the password. Enter your password, and the client starts downloading the files that have been updated from the time you last downloaded the files.

Note: You can also use the smart download option to download files you have not downloaded previously, for example, databases for new countries or territories to which you did not have access earlier but for which you have now bought unlock codes.

RELATED TOPICS:• “Downloading All Your Files” on page 23

• “Overwriting Existing Files” on page 24

Overwriting Existing FilesIf you want to replace some of the database packages in the download directory with database packages from Informatica AddressDoctor, use the overwrite option in the Informatica ADM client. When you enable overwrite, Informatica AddressDoctor replaces the local files with files from Informatica AddressDoctor. For overwrite to work correctly, you must disable the smart download option.


2. Enter your Informatica Passport User Profile user name and password, and click Login. The Select Your Informatica AddresssDoctor Version window appears.

24 Chapter 4: Use Cases



5. Ensure that the Smart Download check box is cleared.

6. Select the Overwrite Old Files check box.


The Informatica ADM client starts downloading the files in the download list.


java -jar DownloadTool.jar -un:<yourusername> -s:no -o:yesThe Informatica ADM client CLI prompts you for the password. Enter your password, and the client starts downloading the files selected for download.

RELATED TOPICS:• “Downloading All Your Files” on page 23

• “Downloading Only the Latest Files” on page 24

Overwriting Existing Files 25

Informatica Database Download Manager - 1.0.0 - User Guide ...

Documents

Transcript of Informatica Database Download Manager - 1.0.0 - User Guide ...