Install Guide
Total Page:16
File Type:pdf, Size:1020Kb
DMX Install Guide Version 9.10 DMX Install Guide Copyright 1990, 2020 Syncsort Incorporated. All rights reserved. This document contains unpublished, confidential, and proprietary information of Syncsort Incorporated. No disclosure or use of any portion of the contents of this document may be made without the express written consent of Syncsort Incorporated. Getting technical support: Customers with a valid maintenance contact can get technical assistance via MySupport. There you will find product downloads and documentation for the products to which you are entitled, as well as an extensive knowledge base. Version 9.10 Last Update: 15 May 2020 Contents DMX Overview ............................................................................................................... 4 Installing DMX/DMX-h ................................................................................................... 4 DMX-h Overview .......................................................................................... 4 Prerequisites ................................................................................................ 5 Step-by-Step Installation ............................................................................. 8 Configuring the DMX Run-time Service ................................................... 22 Applying a New License Key to an Existing Installation ......................... 26 Running DMX ............................................................................................................... 28 Graphical User Interfaces ......................................................................... 28 DMX Help .................................................................................................... 28 Connecting to Databases from DMX ......................................................................... 29 Amazon Redshift ........................................................................................ 29 Azure Synapse Analytics (formerly SQL Data Warehouse) .................... 31 Databricks .................................................................................................. 33 DB2 .......................................................................................................... 35 Greenplum ................................................................................................. 36 Hive data warehouses ............................................................................... 38 Apache Impala ........................................................................................... 45 Microsoft SQL Server ................................................................................. 48 Netezza ....................................................................................................... 48 NoSQL Databases ...................................................................................... 50 Oracle .......................................................................................................... 51 Snowflake ................................................................................................... 51 Sybase ......................................................................................................... 54 Teradata ..................................................................................................... 54 Vertica ......................................................................................................... 55 Other DBMSs .............................................................................................. 56 Defining ODBC Data Sources ................................................................... 58 Connecting to Message Queues from DMX ............................................................. 60 IBM WebSphere MQ .................................................................................. 60 Connecting to Salesforce from DMX ......................................................................... 61 Connecting to SAP from DMX .................................................................................... 62 DMX Install Guide i Registering DMX in SAP SLD ..................................................................... 63 Connecting to HDFS from DMX ................................................................................. 63 Connecting to Connect:Direct nodes from DMX ...................................................... 63 Security ....................................................................................................... 63 Installation and Configuration ................................................................. 63 Connecting to CyberArk Enterprise Password Vault ............................................... 64 CyberArk Licenses ..................................................................................... 64 Connecting to Protegrity Data Security Gateway ..................................................... 65 Connecting to QlikView data eXchange files from QlikView or Qlik Sense............ 65 QlikView desktop installation overview ................................................... 65 Qlik Sense desktop installation overview ................................................ 65 Connecting to Tableau Data Extract files from Tableau .......................................... 66 Tableau desktop installation overview .................................................... 66 Removing DMX/DMX-h from Your System ............................................................... 66 DMX installation component options ....................................................................... 69 DMX Management Service installation and configuration .................... 70 DMX DataFunnel run-time service install and configuration ................ 76 Technical Support ....................................................................................................... 80 ii DMX Install Guide Documentation Conventions The following conventions are used in the format sections of the command options in this manual. Convention Explanation Example Regular type Items in regular type must be entered literally using ASCII either lowercase or uppercase letters. Items may be ascending abbreviated. Italics (non-bold) Items in italics (non-bold) represent variables. You must file_name substitute an appropriate numerical or text value for the variable. Braces { } Braces indicate that a choice must be made among items {"a" } contained in the braces. The choices may be presented {X"xx" } in an aligned column, or on one line separated by a vertical bar ( | ). OR {AND | OR} Brackets [ ] Brackets indicate that an item is optional. A choice may [alias] be made among multiple items contained in brackets. OR [+ | -] Slash / A slash identifies a DMX option keyword. The slash /INFILE must be included when an option keyword is specified. /infile Double quotes " " Double quotation marks that appear in a format "b"-"e" statement must be specified literally. Ellipsis … An ellipsis indicates that the preceding argument or [expression…] group of arguments may be repeated. Sequence A sequence number indicates that a series of arguments field2 number or values may be specified. The sequence number itself must never be specified. DMX Install Guide 3 DMX Overview DMX™ is a high-performance data transformation product. With DMX you can design, schedule, and control all your data transformations from a simple graphical interface on your Windows desktop. Data records can be input from many types of sources such as database tables, SAP systems, Salesforce.com objects, flat files, XML files, pipes, etc. The records can be aggregated, joined, sorted, merged, or just copied to the appropriate target(s). Before output, records can be filtered, reformatted, or otherwise transformed. Metadata, including record layouts, business rules, transformation definitions, run history and data statistics, can be maintained either within a specific task or in a central repository. The effects of making a change to your application can be analyzed through impact and lineage analysis. You can run your data transformations directly from your desktop, on any UNIX or Windows server, or schedule them for later execution, embed them in batch scripts, or invoke them from your own programs. Installing DMX/DMX-h Installed DMX components are dependent on your license key: • DMX server license key installs components based on whether you select a Standard, Full, Classic, or Custom installation. See DMX installation component options. • DMX workstation license key installs the development client, Job and Task Editors; the DMX engine, dmxjob/dmexpress;; and the service for development client, which is the DMX Run-time Service, dmxd. The version of DMX server software must be at least as high as the version of the DMX client software that is used to develop jobs and connect to the server. Thus, when installing a new version of DMX, ensure that you install the same release of DMX on your client and server machines. If you are upgrading and unable to install both the client and the server at the same time, you need to upgrade the server prior to upgrading the client. DMX-h Overview DMX-h is the Hadoop-enabled edition of DMX, providing the following Hadoop functionality: • ETL Processing in Hadoop – Develop a DMX-h ETL application entirely in the DMX GUI to run seamlessly in the Hadoop MapReduce framework, with no Pig, Hive, or Java programming required. Currently, jobs can be run in either MapReduce