TIBCO® Data Virtualization Administration Guide Version 7.0.6
Total Page:16
File Type:pdf, Size:1020Kb
TIBCO® Data Virtualization Administration Guide Version 7.0.6 Last Updated: November 20, 2017 Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO and the TIBCO logo are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries TIBCO, Two-Second Advantage, TIBCO Spotfire? TIBCO ActiveSpaces, TIBCO Spotfire Developer, TIBCO EMS, TIBCO Spotfire Automation Services, TIBCO Enterprise Runtime for R, TIBCO Spotfire Server, TIBCO Spotfire Web Player, TIBCO Spotfire Statistics Services, S-PLUS, and TIBCO Spotfire S+ are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright © 2002-2017 TIBCO Software Inc. All rights reserved. TIBCO Software Inc. Confidential Information 2 Preface Conventions This document uses the following conventions. Conventions Indication bold font Commands and keywords and user-entered text appear in bold font. italic font Document titles, new or emphasized terms, and arguments for which you supply values are in italic font. [ ] Elements in square brackets are optional. {x | y | z } Required alternative keywords are grouped in braces and separated by vertical bars. [ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical bars. string A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks. courier font Terminal sessions and information the system displays appear in courier font. < > Nonprinting characters such as passwords are in angle brackets. [ ] Default responses to system prompts are in square brackets. !, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line. Note: Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual. Searching Across Multiple PDF Documents When you are looking for information in the documentation set, you might want to search across multiple documents. You can use the free Adobe Reader to do this. If the options described are not available in your version of Adobe Reader, please update it. To search your PDF documents 1. Open Adobe Reader. 2. From the File menu, choose Open. and open any PDF document. 3. From the Edit menu, choose Advanced Search. 4. Under Where would you like to search?, click All PDF Documents in. 5. Click My Documents and choose Browse for Location at the bottom of the drop-down list. 6. Browse to the location of all your PDF files. 7. Enter the search term and click Search. Acrobat lists all PDFs in the folder that contain the search string, and the number of occurrences in each. 8. Click the instance of the search term and its surrounding text to open the PDF to that page. 3 Preface Document Change History This section provides the revision history for this guide. Table 1 Revision History Version Number Issue Date Status Reason for Change 7.0.1 November 2014 New configuration parameters. Changes in overall product function. Removal of legacy features. Additional features used to help convert legacy resources. Updated drivers and integration for use with TDV. New web based Deployment Manager feature. Revised PAM content. Additional logging features. Removal of support for iPlanet directory service. 7.0.2 August 2015 New configuration parameters. New topic on how to schedule tests. SNMP traps reviewed. New task for how to manage server restarts. Support for Kerberos on an external LDAP server. Hive 14 with trusted delegation changes. 7.0.3 December 2015 New sections and figures for SSL communication among components. 7.0.4 August 2016 Reviewed and updated driver information. Trap and event information updates. Additional information on logging and log files added. Metrics table DDL updated. 7.0.5 January 2017 Info for Studio Session Authentication configuration parameter added. Added info on the log and out files. Improved PAM procedures. Revised SSL setup content. Added info on ‘includesourceinfo. Added column-level security topics. Revisions to row-based security topics. Added version control topics. 4 Basic TDV Administration Tasks This guide describes the configuration and administration tasks for TIBCO® Data Virtualization Server. After you finish using the installation guides to install your TDV products, you must use this guide to customize and configure your TDV environment. This guide discusses basic tasks, configuration parameters, connection configuration, system monitoring, and repository setup options. The following topics are covered: Overview of TDV Administration, page 5 Security Features, page 7 Starting TDV Processes on Windows, page 7 Starting TDV Processes on UNIX, page 9 Working with the Repository Utility, page 13 Configuring the Java Keystore File, page 15 Understanding TDV User Templates and Rights, page 16 Changing the Repository Password, page 19 Validating TDV Software License Compliance and Asset Management, page 20 Setting the Language for Studio, Manager, and Monitor, page 22 Overview of TDV Administration The TIBCO Data Virtualization Server (TDV) forms the core of the Data Virtualization Platform. TDV can use data from many different data sources, recombine it, and make it available to many types of clients. The administrator needs to manage data sources, multiple connection and security protocols, complex data access methods, multi-level security, and internal repositories. 5 Basic TDV Administration Tasks Overview of TDV Administration You need to perform most administration tasks periodically, but not necessarily daily. The table lists the main administration tasks and where to find information about them. Administration Task For More Information Installing and setting up TDV Installation details are in the TDV Installation and Upgrade Guide. Starting and stopping the TDV Server, testing the Starting TDV Processes on Windows, page 7 TDV repository, and dealing with the Java keystore file that is enabled by your TDV Starting TDV Processes on UNIX, page 9 installation. Working with the Repository Utility, page 13 Configuring the Java Keystore File, page 15 Configuring access protocols, including ODBC, Configuring TDV Data Connections, page 47 JDBC, Hive, and ADO.NET for data sources and client interfaces. Refer to “Working with Data Sources” and “Configuring Relational Data Sources” in the TDV User Guide. Also refer to the TDV Client Interfaces Guide. Performing security-related tasks associated Configuring the Java Keystore File, page 15 with Studio use at the domain, group, or user level. Group and User Rights Templates, page 16 Summary of TDV Rights, page 17 Overview of TDV Security Features, page 189 Resource Rights, page 191 Resource Privileges, page 192 Row-Level Security, page 203 Configuring Kerberos Single Sign-On, page 169 Composite Domain Administration, page 125 LDAP Domain Administration, page 137 Dynamic Domain Administration, page 153 Configuring NTLM Authentication, page 295 Tuning and configuring TDV behavior. TDV Configuration Options, page 113 Although