Simba ODBC Driver with SQL Connector for MongoDB
|
|
- Horace Cameron
- 6 years ago
- Views:
Transcription
1 Simba ODBC Driver with SQL Connector for MongoDB Installation and Configuration Guide Version July 15, 2014 Simba Technologies Inc.
2 Copyright Simba Technologies Inc. All Rights Reserved. Information in this document is subject to change without notice. Companies, names and data used in examples herein are fictitious unless otherwise noted. No part of this publication, or the software it describes, may be reproduced, transmitted, transcribed, stored in a retrieval system, decompiled, disassembled, reverse-engineered, or translated into any language in any form by any means for any purpose without the express written permission of Simba Technologies Inc. Trademarks Simba, the Simba logo, SimbaEngine, SimbaEngine C/S, SimbaExpress and SimbaLib are registered trademarks of Simba Technologies Inc. All other trademarks and/or servicemarks are the property of their respective owners. ICU License - ICU and later COPYRIGHT AND PERMISSION NOTICE Copyright (c) International Business Machines Corporation and others All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder. All trademarks and registered trademarks mentioned herein are the property of their respective owners. OpenSSL Copyright (c) The OpenSSL Project. All rights reserved. i
3 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. ( 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact 5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project. 6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit ( THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Expat Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ""Software""), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NOINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR ii
4 COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Contact Us Simba Technologies Inc. 938 West 8 th Avenue Vancouver, BC Canada V5Z 1E5 Telephone: +1 (604) Information and Product Sales: Extension 2 Technical Support: Extension 3 Fax: +1 (604) Information and Product Sales: solutions@simba.com Technical Support: support@simba.com Follow us on Printed in Canada iii
5 Table of Contents Introduction...1 Windows Driver...1 System Requirements...1 Installing the Driver...2 Creating a Data Source Name...2 Configuring Options...3 Defining the Schema...5 Linux Driver...7 System Requirements...7 Installation Using the RPM...7 Installation Using the Tarball Package...8 Setting the LD_LIBRARY_PATH Environment Variable...9 Mac OS X Driver...9 System Requirements...9 Installation...9 Configuring ODBC Connections for Linux and Mac OS X Files Sample Files Configuring the Environment Configuring the odbc.ini File Configuring the odbcinst.ini File Configuring the simba.mongodbodbc.ini File Features SQL Connector Data Types Authentication Catalog Support Write-back Contact Us Appendix: Advanced Driver Configuration Options iv
6 Introduction The Simba ODBC Driver with SQL Connector for MongoDB enables Business Intelligence (BI), analytics and reporting on data that is stored in MongoDB databases. The driver complies with the ODBC 3.52 data standard and adds important functionality such as Unicode, as well as 32- and 64-bit support for high-performance computing environments on all platforms. ODBC is one of the most established and widely supported APIs for connecting to and working with databases. At the heart of the technology is the ODBC driver, which connects an application to the database. For more information about ODBC, see For complete information on the ODBC specification, see the ODBC API Reference at Simba ODBC Driver with SQL Connector for MongoDB is available for the Microsoft Windows, Linux and Mac OS X operating systems. Note: For details on installing and setting up a MongoDB instance, see the Simba ODBC Driver with SQL Connector for MongoDB Quick Start Guide. Windows Driver System Requirements You install Simba ODBC Driver with SQL Connector for MongoDB on client computers accessing MongoDB databases. Each computer where you install the driver must meet the following minimum system requirements: One of the following operating systems (32- and 64-bit editions are supported): o Windows Vista o Windows 7 Professional o Windows 8 o Windows 8.1 o Windows Server 2008 R2 100 MB of available disk space Important: To install the driver, you need Administrator privileges on the computer. Simba ODBC Driver with SQL Connector for MongoDB Version 1.5 supports MongoDB and newer. 1
7 Installing the Driver On 64-bit Windows operating systems, you can execute 32- and 64-bit applications transparently. You must use the version of the driver matching the bitness of the client application accessing MongoDB databases: SimbaMongoDBODBC32.msi for 32-bit applications SimbaMongoDBODBC64.msi for 64-bit applications You can install both versions of the driver on the same computer. Note: For an explanation of how to use ODBC on 64-bit editions of Windows, see To install Simba ODBC Driver with SQL Connector for MongoDB: 1. Depending on the bitness of your client application, double-click to run SimbaMongoDBODBC32.msi or SimbaMongoDBODBC64.msi 2. Click Next 3. Select the check box to accept the terms of the License Agreement if you agree, and then click Next 4. To change the installation location, click the Change button, then browse to the desired folder, and then click OK. To accept the installation location, click Next 5. Click Install 6. When the installation completes, click Finish 7. If you received a license file via , then copy the license file into the \lib subfolder in the installation folder that you selected in step 4. Creating a Data Source Name After installing Simba ODBC Driver with SQL Connector for MongoDB, you need to create a Data Source Name (DSN). To create a Data Source Name: 1. On the Windows Start menu, click All Programs, then click the Simba MongoDB ODBC Driver 1.5 program group corresponding to the bitness of the client application accessing MongoDB databases, and then click ODBC Administrator 2. In the ODBC Administrator, click the Drivers tab, and then scroll down as needed to confirm that Simba MongoDB ODBC Driver appears in the alphabetical list of driver names. 3. To create a DSN on the computer that only the user currently logged into Windows can use, click the User DSN tab. OR 2
8 To create a DSN on the computer that all users who log into Windows can use, click the System DSN tab. 4. Click the Add button. 5. In the Create New Data Source dialog, select Simba MongoDB ODBC Driver, and then click Finish 6. In the Simba MongoDB ODBC Driver Setup dialog, type a name for the data source in the Data Source Name field. 7. In the Description field, type relevant details about the DSN. 8. In the Host field, type the name or IP address of the host where the MongoDB instance runs. 9. In the Port field, type the number of the port that the MongoDB instance uses. 10. In the Database field, type the name of the MongoDB database to which the client application needs to connect. 11. In the Username field, type the appropriate login credential for the DSN to provide when accessing the MongoDB database. 12. To configure advanced driver options, click the Advanced Options button. For details, see the section Configuring Options on page If you need to customize the schema that Simba ODBC Driver with SQL Connector for MongoDB detects for a MongoDB database, then click the Schema Definition button. For details, see the section Defining the Schema on page 5. Note: To test the connection, click the Schema Definition button. If the connection is successful, then the Schema Definition dialog opens. If the connection is not successful, then an error dialog appears. To troubleshoot a connection, confirm that values and settings in the Simba MongoDB ODBC Driver Setup dialog are correct. Contact your MongoDB administrator for assistance as needed. 14. Click OK to close the Simba MongoDB ODBC Driver Setup dialog. 15. Click OK to close the ODBC Data Source Administrator dialog. Configuring Options You can configure options using the following: Data Source Name Database connection string For a list and description of advanced configuration settings available in Simba ODBC Driver with SQL Connector for MongoDB, see the Appendix: Advanced Driver Configuration Options on page
9 Using the Data Source Name To set advanced options using the Simba MongoDB Driver Setup dialog: 1. In the ODBC Data Source Administrator where you created the DSN, select the DSN tab where the Data Source Name appears, and then select the Data Source Name. 2. Click the Configure button, and then click the Advanced Options button. 3. Select or clear the available check boxes, as needed: Use SQL_WVARCHAR for String data type Enable authentication Enable Metadata caching Omit default NULL columns on insert Truncate documents larger than 16MB Enable reading/writing as JSON document Validate BSON before writes Check GetLastError on writes 4. Type an appropriate value in the Rows Fetched Per Block field, as needed. 5. Type an appropriate value in the Nested Column Separator column, as needed. 6. Type an appropriate value in the Rows To Scan field, as needed. 7. Click the drop-down arrow next to the Read Preference field, and then select the appropriate option as needed. 8. In the String Column Lengths area, click the drop-down arrows next to the Standard, Container and DocumentAsJSON fields as needed, and then select appropriate values. You can also type values in the fields. 9. In the Update Configuration area, select or deselect the Enable Updating Multiple Rows check box, as needed. 10. In the Get Metadata From area, select Database or Local File. If you select Local File, then click the Browse button, then select the file from which to load metadata, and then click Open 11. In the Advanced Options dialog, click OK 12. In the Simba MongoDB ODBC Driver Setup dialog, click OK Using a DSN-less Connection Some applications provide support for connecting to a data source using a driver without a DSN. 4
10 Here is an example of the minimum required attributes for a connection string without authentication: Driver=Simba MongoDB ODBC Driver; Host= ; Port=27017; Database=MyDatabase Here is an example of the minimum required attributes for a connection string with authentication: Driver=Simba MongoDB ODBC Driver; Host= ; Port=27018; Database=MyDatabase; EnableAuthentication=1; UID=MyUsername; PWD=MyPassword Here is an example connection string that sets some advanced options: Driver=Simba MongoDB ODBC Driver; Host= ; Port=27017; Database=MyDatabase; UID=MyUsername; PWD=MyPassword; RowsFetchedPerBlock=4096; DefaultStringColumnLength=255; DefaultContainerColumnLength=511; DefaultJSONColumnLength=1023; UseSqlWVarchar=0; CacheMetadata=0 Defining the Schema Simba ODBC Driver with SQL Connector for MongoDB dynamically detects the database schema as needed in the process of connecting to a MongoDB database. You can also edit the schema that the driver uses to connect to the database manually. To define manually the schema to use when Simba ODBC Driver with SQL Connector for MongoDB connects to the database: 1. In the ODBC Data Source Administrator where you created the DSN, select the DSN tab where the Data Source Name appears, and then select the Data Source Name. 2. Click the Configure button, and then click the Schema Definition button. 3. If authentication is enabled, then you are prompted to provide your login credentials. Type the database to which you want to connect, your user name and password, and then click OK 5
11 4. In the Schema Definition dialog, click the drop-down arrow next to the Table Name field, and then select the table for which you want to edit the schema. 5. To filter sample data, type an appropriate JSON filter in the JSON Filter field, and then click the Resample button. In the confirmation dialog, click Yes Note: The value you type in the JSON Filter field is the MongoDB equivalent of a WHERE clause in SQL. For example, the SQL statement SELECT * FROM at_1 WHERE _id = T123 returns the row having the value T123 in the _id field from the table named at_1. In the Schema Definition dialog, selecting at_1 from the dropdown menu for the Table Name field, and then typing {_id: T123 } in the JSON Filter field returns the same result. Note: The value in the Rows to Scan field in the Advanced Options dialog determines the maximum number of rows in the table that the driver samples to detect columns and corresponding data types. Rows are sampled after any JSON filter is applied. 6. To edit columns defined in the schema: a) To rename a column, select the column name, then click the column name, then type a new name for the column, and then press ENTER b) To change the data type for a column, click the Type field for the column, and then click the appropriate data type. c) To change the MongoDB data type for a column, click the Source Type field for the column, and then click the appropriate data type. d) To show or hide an auto-detected column, click the Hide Column field for the column, and then click Show or Hide as needed. e) Repeat steps a) to d) to edit more columns, as needed. 7. To add columns to the schema for the table: a) Click the Add button. In the Columns area, a new entry named New column is created and selected. b) Type a name for the column to add, and then press ENTER c) In the Columns area, scroll as needed to view the column you created in step b), then click the Type field for the new column, and then click the appropriate data type. d) Repeat steps a) to c) to add more columns, as needed. 8. To delete columns from the schema: a) In the Columns area, select the name(s) of the column(s) to delete. b) Click the Remove button. 9. Repeat steps 4 to 8 as needed to edit the schemas of other tables in the database. Note: The Data Preview pane displays sample data from the table based on the currently defined schema. 6
12 10. In the Options area, select whether to store the schema you defined manually in the database or in the file you specified in the Advanced Options dialog. 11. When you are finished defining the schema, click Save, and then click Yes when prompted to write metadata to the database. OR To discard changes, click the Cancel button, and then click OK when prompted to discard changes. If you store schema data metadata in the database, then the metadata is stored in a collection called Mersenne_Collection_Metadata. As needed, you can copy the collection to other MongoDB instances to duplicate the schema definition. Note: Deleting Mersenne_Collection_Metadata deletes the schema definition you defined. Linux Driver System Requirements Each computer where you install the driver must meet the following minimum system requirements: Red Hat Enterprise Linux (RHEL) 5.0, CentOS 5.0 or SUSE Linux Enterprise Server (SLES) 11 (32 and 64-bit editions are supported) 300 MB of available disk space An installed ODBC driver manager: o iodbc or above o unixodbc or above Simba ODBC Driver with SQL Connector for MongoDB Version 1.5 supports MongoDB and newer. Installation Using the RPM You can install the driver using RPMs. There are two versions of the driver for Linux: SimbaMongoDBODBC-32bit-Version-Release.rpm 32-bit driver SimbaMongoDBODBC-Version-Release.rpm 64-bit driver The bitness of the driver that you select should match the bitness of the client application accessing your MongoDB-based data. For example, if the client application is 64-bit, then you should install the 64-bit driver. Note that 64-bit editions of Linux support both 32- and 64-bit OR 7
13 applications. Verify the bitness of your intended application and install the appropriate version of the driver. Simba ODBC Driver with SQL Connector for MongoDB driver files are installed in the following directories: /opt/simba/mongodbodbc/errormessages Error messages files directory /opt/simba/mongodbodbc/setup Sample configuration files directory /opt/simba/mongodbodbc/lib/32 32-bit shared libraries directory /opt/simba/mongodbodbc/lib/64 64-bit shared libraries directory To install Simba ODBC Driver with SQL Connector for MongoDB: 1. In Red Hat Enterprise Linux 5.0 or CentOS 5.0, log in as the root user, then navigate to the folder containing the driver RPM packages to install, and then type the following at the command line, where RPMFileName is the file name of the RPM package containing the version of the driver that you want to install: yum --nogpgcheck localinstall RPMFileName OR In SUSE Linux Enterprise Server 11, log in as the root user, then navigate to the folder containing the driver RPM packages to install, and then type the following at the command line, where RPMFileName is the file name of the RPM package containing the version of the driver that you want to install: zypper install RPMFileName 2. If you received a license file via , then copy the license file into the /opt/simba/ mongodbodbc /lib/32 or /opt/simba/mongodbodbc /lib/64 folder, depending on the version of the driver that you installed. Installation Using the Tarball Package Alternately, the Simba ODBC Driver with SQL Connector for MongoDB is available for installation using a TAR.GZ tarball package. The tarball package includes: [INSTALL_DIR]/simba/mongodbodbc/ contains release notes, the Simba ODBC Driver with SQL Connector for MongoDB in PDF format and a Readme.txt file that provides plain text installation and configuration instructions. [INSTALL_DIR]/simba/mongodbodbc/lib/32 contains the 32-bit Simba MongoDB ODBC Driver for Linux, as well as the simba.mongodbodbc.ini configuration file. [INSTALL_DIR]/simba/mongodbodbc/lib/64 contains the 64-bit Simba MongoDB ODBC Driver for Linux, as well as the simba.mongodbodbc.ini configuration file. [INSTALL_DIR]/simba/mongodbodbc/ErrorMessages contains error message files required by the Simba MongoDB ODBC Driver. 8
14 [INSTALL_DIR]/simba/mongodbodbc/Setup contains configuration files named odbc.ini and odbcinst.ini Setting the LD_LIBRARY_PATH Environment Variable The LD_LIBRARY_PATH environment variable must include the paths to installed ODBC driver manager libraries. For example, if ODBC driver manager libraries are installed in /usr/local/lib, then set LD_LIBRARY_PATH as follows: export LD_LIBRARY_PATH=/usr/local/lib Refer to your Linux shell documentation for details on how to set environment variables permanently. For details on creating ODBC connections using Simba ODBC Driver with SQL Connector for MongoDB, see Configuring ODBC Connections for Linux and Mac OS X on page 10. Mac OS X Driver System Requirements Each computer where you install the driver must meet the following minimum system requirements: Mac OS X version or later 100 MB of available disk space iodbc or above Simba ODBC Driver with SQL Connector for MongoDB Version 1.5 supports MongoDB and newer. Installation Simba ODBC Driver with SQL Connector for MongoDB driver files are installed in the following directories: /opt/simba/mongodbodbc/errormessages contains error message files required by the Simba ODBC Driver with SQL Connector for MongoDB. /opt/simba/mongodbodbc/setup contains sample configuration files named odbc.ini and odbcinst.ini /opt/simba/mongodbodbc/lib/universal contains the Simba ODBC Driver with SQL Connector for MongoDB for Mac OS X, as well as the simba.mongodbodbc.ini configuration file. 9
15 To install Simba ODBC Driver with SQL Connector for MongoDB: 1. Double-click to mount the SimbaMongoDBODBC.dmg disk image. 2. Double-click SimbaMongoDBODBC.pkg to run the Installer. 3. Follow the instructions in the Installer to complete the installation process. 4. When the installation completes, click Close 5. If you received a license file via , then copy the license file into the /opt/simba/mongodbodbc/lib/universal folder. Setting the DYLD_LIBRARY_PATH Environment Variable The DYLD_LIBRARY_PATH environment variable must include the paths to installed ODBC driver manager libraries. For example, if ODBC driver manager libraries are installed in /usr/local/lib, then set DYLD_LIBRARY_PATH as follows: export DYLD_LIBRARY_PATH=/usr/local/lib Refer to your Mac OS X shell documentation for details on how to set environment variables permanently. For details on creating ODBC connections using Simba ODBC Driver with SQL Connector for MongoDB, see Configuring ODBC Connections for Linux and Mac OS X on page 10. Configuring ODBC Connections for Linux and Mac OS X Files ODBC driver managers use configuration files to define and configure ODBC data sources and drivers. By default, the following configuration files residing in the user s home directory are used:.odbc.ini The file used to define ODBC data sources (required).odbcinst.ini The file used to define ODBC drivers (optional) Also, by default the Simba ODBC Driver with SQL Connector for MongoDB is configured using the simba.mongodbodbc.ini file in the subfolder in the /lib folder containing the binaries for the driver that you are using. The simba.mongodbodbc.ini file is required. Note: The simba.mongodbodbc.ini file in the /lib subfolder provides default settings for most configuration options available in the Simba ODBC Driver with SQL Connector for MongoDB. 10
16 Sample Files The driver installation contains the following sample configuration files in the Setup directory: odbc.ini odbcinst.ini The sample configuration files in the Setup directory provide preset values for settings related to the Simba ODBC Driver with SQL Connector for MongoDB. The names of the sample configuration files do not begin with a period (.) in order to appear in directory listings by default. A filename beginning with a period (.) is hidden. For odbc.ini and odbcinst.ini, if the default location is used, then the filenames must begin with a period (.). If configuration files do not exist in the user s home directory, then you can copy the sample configuration files to the home directory, and then rename the files. If the configuration files already exist in the home directory, then use the sample configuration files as a guide to modify the existing configuration files. Configuring the Environment Optionally, you can use three environment variables ODBCINI, ODBCSYSINI, and SIMBAMONGODBINI to specify different locations for the odbc.ini, odbcinst.ini and simba.mongodbodbc.ini configuration files, respectively. Set ODBCINI to point to your odbc.ini file. Set ODBCSYSINI to point to the directory containing the odbcinst.ini file. Set SIMBAMONGODBINI to point to your simba.mongodbodbc.ini file. For example, if your odbc.ini and simba.mongodbodbc.ini files are located in the folder /etc and your odbcinst.ini file is located in the folder /usr/local/odbc, then set the environment variables as follows: export ODBCINI=/etc/odbc.ini export ODBCSYSINI=/usr/local/odbc export SIMBAMONGODBINI=/etc/simba.mongodbodbc.ini The following search order is used to locate the simba.mongodbodbc.ini file: 1. If the SIMBAMONGODBINI environment variable is defined, then the driver searches for the file specified by the environment variable. Important: SIMBAMONGODBINI must contain the full path, including the filename. 2. The current working directory of the application is searched for a file named simba.mongodbodbc.ini (not beginning with a period). 3. The directory ~/ (that is, $HOME) is searched for a hidden file named.simba.mongodbodbc.ini 4. The directory /etc is searched for a file named simba.mongodbodbc.ini (not beginning with a period). 11
17 Configuring the odbc.ini File Note: For an example odbc.ini file providing preset values for settings related to the Simba ODBC Driver with SQL Connector for MongoDB, see the Setup directory in the folder where you installed the driver. ODBC Data Sources are defined in the odbc.ini configuration file. The file is divided into several sections: [ODBC] is optional and used to control global ODBC configuration, such as ODBC tracing. [ODBC Data Sources] is required, listing DSNs and associating DSNs with a driver. A section having the same name as the data source specified in the [ODBC Data Sources] section is required to configure the data source. Here is an example odbc.ini configuration file for Linux: [ODBC Data Sources] Sample Simba MongoDB DSN 32=Simba MongoDB ODBC Driver 32-bit [Sample Simba MongoDB DSN 32] Driver=/opt/simba/mongodbodbc/lib/32/libsimbamongodbodbc32.so HOST=MyMongoDBServer PORT=10000 Here is an example odbc.ini configuration file for Mac OS X: [ODBC Data Sources] Sample Simba MongoDB DSN=Simba MongoDB ODBC Driver [Sample Simba MongoDB DSN] Driver=/opt/simba/mongodbodbc/lib/universal/libsimbamongodbodbc.dylib HOST=MyMongoDBServer PORT=10000 To create a data source: 1. Open the.odbc.ini configuration file in a text editor. 2. Add a new entry to the [ODBC Data Sources] section. Type the data source name (DSN) and the driver name. 3. To set configuration options, add a new section having a name matching the data source name (DSN) you specified in step 2. Specify configuration options as key-value pairs. 4. Save the.odbc.ini configuration file. For details on configuration options available to control the behavior of DSNs using Simba ODBC Driver with SQL Connector for MongoDB, see Appendix: Advanced Driver Configuration Options on page
18 Configuring the odbcinst.ini File Note: For an example odbc.ini file providing preset values for settings related to the Simba ODBC Driver with SQL Connector for MongoDB, see the Setup directory in the folder where you installed the driver. ODBC Drivers are defined in the odbcinst.ini configuration file. The configuration file is optional because drivers can be specified directly in the odbc.ini configuration file, as described in Configuring the odbc.ini File on page 12. The odbcinst.ini file is divided into the following sections: [ODBC Drivers] lists the names of all the installed ODBC drivers. A section having the same name as the driver name specified in the [ODBC Drivers] section lists driver attributes and values. Here is an example odbcinst.ini file for Linux: [ODBC Drivers] Simba MongoDB ODBC Driver 32-bit=Installed Simba MongoDB ODBC Driver 64-bit=Installed [Simba MongoDB ODBC Driver 32-bit] Description=Simba MongoDB ODBC Driver (32-bit) Driver=/opt/simba/mongodbodbc/lib/32/libsimbamongodbodbc32.so [Simba MongoDB ODBC Driver 64-bit] Description=Simba MongoDB ODBC Driver (64-bit) Driver=/opt/simba/mongodbodbc/lib/64/libsimbamongodbodbc64.so Here is an example odbcinst.ini file for Mac OS X: [ODBC Drivers] Simba MongoDB ODBC Driver=Installed [Simba MongoDB ODBC Driver] Description=Simba MongoDB ODBC Driver Driver=/opt/simba/mongodbodbc/lib/universal/libsimbamongodbodbc.dylib To define a driver: 1. Open the.odbcinst.ini configuration file in a text editor. 2. Add a new entry to the [ODBC Drivers] section. Type the driver name, and then type =Installed Note: Assign the driver name as the value of the Driver attribute in the data source definition instead of the driver shared library name. 13
19 3. In.odbcinst.ini, add a new section having a name matching the driver name you typed in step 2, and then add configuration options to the section based on the sample odbcinst.ini file provided with Simba ODBC Driver with SQL Connector for MongoDB in the Setup directory. Specify configuration options as key-value pairs. 4. Save the.odbcinst.ini configuration file. Configuring the simba.mongodbodbc.ini File To configure Simba ODBC Driver with SQL Connector for MongoDB to work with your ODBC driver manager: Features 1. Open the simba.mongodbodbc.ini configuration file in a text editor. 2. Edit the DriverManagerEncoding setting. The value usually must be UTF-16 or UTF-32, depending on the ODBC driver manager you use. iodbc uses UTF-32 and unixodbc uses UTF-16. Consult your ODBC Driver Manager documentation for the correct setting to use. 3. Edit the ODBCInstLib setting. The value is the name of the ODBCInst shared library for the ODBC driver manager you use. The configuration file defaults to the shared library for iodbc. In Linux, the shared library name for iodbc is libiodbcinst.so. In Mac OS X, the shared library name for iodbc is libiodbcinst.dylib. Note: Consult your ODBC driver manager documentation for the correct library to specify. You can specify an absolute or relative filename for the library. If you intend to use the relative filename, then the path to the library must be included in the library path environment variable. In Linux, the library path environment variable is named LD_LIBRARY_PATH. In Mac OS X, the library path environment variable is named DYLD_LIBRARY_PATH. 4. Save the simba.mongodbodbc.ini configuration file. SQL Connector The SQL Connector feature of the driver allows applications to use normal SQL queries against MongoDB, translating standard SQL-92 queries into equivalent MongoDB API calls. This allows standard queries that BI tools execute to run against your MongoDB instance. Data Types The following data types are supported: String Boolean NumberLong BinData Date jstoid 14
20 NumberInt NumberDouble Object (see below for more information) Array (see below for more information) The following types are not yet supported: Code CodeWScope DBRef JSTypeMax MinKey MaxKey RegEx Symbol Timestamp Embedded Documents Embedded documents in MongoDB are represented as nested columns in the Simba ODBC Driver with SQL Connector for MongoDB. For example, consider the following JSON document: {"contact": {"address": {"street": "1-123 Broadway", "city": "Vancouver"}}, "phone": " "} The driver identifies the following columns in the document: Column MongoDB Data Type Data contact.address.street String Broadway contact.address.city String Vancouver phone String The identified columns will act in the same way as any other column when being mapped to SQL data types or when generalizing data types. If there are different fields within a document, then only the most general fields are identified as columns. Consider the following two documents: {"contact": {"address": {"street": "1-123 Broadway", "city": "Vancouver"}}, "phone": " "} {"contact": {"address": "22 Cambie, Vancouver"}, "phone": " "} In the second document, contact.address is not an embedded document so the driver considers contact.address as a String instead of an embedded document. Respectively, the driver identifies the following columns for each document: Column MongoDB Data Type Data contact.address String {street: Broadway, city: 15
21 Arrays Vancouver } 22 Cambie, Vancouver phone String In a SQL query, when a column name contains the separator character you need to enclose the column name in quotes ( ). For example: SELECT "contact.address", "phone" FROM Contacts Arrays in MongoDB are also represented as nested columns in the Simba ODBC Driver with SQL Connector for MongoDB. Consider the following JSON document using an array: {"values": ["hello", 1, {"v1": {"v2": "this is an embedded document"}}]} The driver identifies the following columns: Column MongoDB Data Type Data values.0 String Hello values.1 Double 1.0 values.2.v1.v2 String this is an embedded document The column names include the index of the item in the array that the column represents, starting with an index of 0. In other words, the first element of the array uses a suffix of.0, the second element uses.1, and so on. If different rows in the sample have the same field with different data types, then a precedence order is used to determine the type. The generated type will be the first one from the following list that appears in the sample data: 1. Array 2. Object 3. Binary 4. String 5. NumberDouble 6. NumberLong 7. NumberInt Data types having no direct mapping from Mongo to ODBC are treated as data type String. Columns mapped to SQL data types or generalized act in the same way as any other column. 16
22 For example, the following field named f is generalized to type Array: {f : {g1 : 1}} {f : [1, 2, 3]} In a SQL query, when a column name contains the separator character you need to enclose the column name in quotes ( ). For example: SELECT "values.0", "values.1", "values.2.v1.v2" FROM Contacts Authentication Simba ODBC Driver with SQL Connector for MongoDB leverages authentication built into MongoDB. Built-in authentication requires users to supply a user name and password. If your MongoDB instance does not use authentication, then you can disable authentication for the DSN using the Simba MongoDB ODBC Driver Setup dialog. For details on using authentication when installing the driver on the Windows operating system, see Creating a Data Source Name on page 2 and Configuring Options on page 3. For details on Linux and Mac OS X installations, see the section Configuring ODBC Connections for Linux and Mac OS X on page 10. Catalog Support Simba ODBC Driver with SQL Connector for MongoDB supports catalogs by using the name of the MongoDB database as the catalog, allowing the driver to work easily with various ODBC applications. Write-back Simba ODBC Driver with SQL Connector for MongoDB supports Data Manipulation Language (DML) statements such as INSERT, UPDATE and DELETE. These statements expose standard SQL-92 behavior. The driver does not execute the DML statements atomically, as MongoDB does not have transaction support. However, MongoDB guarantees atomic update on a single row and so does the driver. If an UPDATE/DELETE statement affects multiple rows and an error occurs in one of them, then the driver returns an error, but the rows that are already updated will remain so. Which means, for an UPDATE/DELETE statement, some rows may be updated successfully and the driver may return an error for the rest. Some special cases with DML statements are described in more detail below. 17
23 INSERT UPDATE DELETE Each row in MongoDB needs to have a unique ID represented by the _id column. If not provided during insertion, MongoDB auto-generates a unique ID for each row. The _id field is exposed as a valid column in MongoDB ODBC Driver and can be auto-generated when issuing INSERT statements through the driver. For example, consider the following table: _id sample_column "517024D6CC79814E3FEBD352" 1 "5170ED77E49CC93A918DE316" 2 To insert a document with auto-generated value for _id (data type: jstoid), issue the following command: INSERT INTO sample_table_1(sample_column) VALUES(3) After the insertion, the table would look like as below: _id sample_column "517024D6CC79814E3FEBD352" 1 "5170ED77E49CC93A918DE316" 2 "51710FFCE49CC93A918DE322" 3 The value for the _id column can also be inserted using the INSERT statements, as in the following examples: INSERT INTO sample_table_2(_id, sample_column) VALUES(1,1) INSERT INTO sample_table_2 VALUES(1,1) When updating rows, special care needs to be taken to avoid duplicate values for the _id column. As mentioned before, _id needs to be unique across all rows. When an UPDATE statement tries to set a value for the _id column and matches multiple rows, only one of the rows is updated with the new values, and the driver return an error for the remaining rows. UPDATE is not executed atomically. Currently, the driver considers a table valid as long as the table contains some data. If a table is completely empty, then the driver is not able to access the table. Consider the following example: DELETE FROM sample_table_3 The command removes all data from sample_table_3. Therefore, sample_table_3 is invalid. Any users attempting to access the table receive an error. 18
24 A table exists until the metadata is removed. Continuing the example, the following command removes the table metadata: DROP TABLE sample_table_3 Supported Data Types for DML Currently, Simba ODBC Driver with SQL Connector for MongoDB supports only the following data types in DML statements: String Boolean NumberLong NumberInt NumberDouble BinData Date Object Array The driver does not yet support inserting/updating values for the jstoid (the ObjectId data type). Also, the data provided in DML statements should match the existing column data types. For example, a String value cannot be inserted/set in a column having NumberInt data type. Contact Us If you have difficulty using the driver, please contact our Technical Support staff. We welcome your questions, comments and feature requests. Technical Support is available Monday to Friday from 8 a.m. to 5 p.m. Pacific Time. Important: To help us assist you, prior to contacting Technical Support please prepare a detailed summary of the client and server environment including operating system version, patch level and configuration. You can contact Technical Support via: support@simba.com Web site: Telephone: (604) Extension 3 Fax: (604) You can also follow us on 19
25 Appendix: Advanced Driver Configuration Options You can configure options using the following: Data Source Name Database connection string Table 1 lists advanced configuration settings available in Simba ODBC Driver with SQL Connector for MongoDB. Field Label (Key) Use SQL_WVARCHAR for String Data Type (UseSqlWVarchar) Enable Authentication (EnableAuthentication) Default Value Clear (0) Clear (0) Description When selected, the MongoDB String type is mapped to SQL_WVARCHAR instead of SQL_VARCHAR. The default value (0) causes the String type to be mapped to SQL_VARCHAR. Enable user/password authentication during connection. The default value (0) disables authentication. Enable Metadata Caching (CacheMetadata) Selected (1) Simba ODBC Driver with SQL Connector for MongoDB dynamically detects the database schema as needed in the process of connecting to a MongoDB database. By default, the driver stores the metadata for reuse. When you disable metadata caching, the driver regenerates the metadata every time the driver accesses the database. If you disable metadata caching, then the driver continues to save schema definitions you set using the Schema Definition dialog. For details on using the Schema Definition dialog, see Defining the Schema on page 5. Important: Caching metadata is useful when defining the schema for your MongoDB database. After the schema is defined, disable metadata caching in your production environment. 20
26 Field Label (Key) Omit Default NULL Columns on Insert (OmitColumns) Truncate Documents Larger Than 16MB (TruncateDocument) Enable Reading/Writing as JSON Document (UseJSONColumn) Validate BSON Before Writes (ValidateBsonBeforeWrite) Check GetLastError on Writes (CheckGetLastError) Rows Fetched Per Block (RowsFetchedPerBlock) Default Value Description Selected (1) This option affects the INSERT operations only. When selected (1), no null values (whether explicitly provided or not) are written to the columns of a table. When clear (0), explicitly provided null values are written to columns as specified, but no default null value is inserted. Clear (0) Clear (0) Clear (0) When clear (0), the driver rejects any document that is greater than 16MB in size. When selected (1), the driver truncates any document that is greater than 16MB in size. When enabled (1), the driver reports a special column named documentasjson that retrieves or stores whole documents as JSON formatted strings. Note: See also the DocumentAsJSON driver configuration option. By default, MongoDB does not validate BSON objects before insert/update, which can result in a corrupted database. If the value of ValidateBsonBeforeWrite is set to 1, then the driver validates all content prior to passing the content to the database server. Selected (1) When set to the default value of 1, the driver calls the MongoDB CheckGetLastError() function after each insert/update to check for reported failures. Calling CheckGetLastError() typically takes four times longer than the actual insert/update operation, but is necessary if fault tolerance is important The maximum number of rows that a query returns at a time 21
27 Field Label (Key) Nested Column Separator (NestedColumnSeparator) Rows to Scan (SchemaDetectSampleSize) Read Preference (ReadPreference) String Column Lengths: Standard (DefaultStringColumnLength) String Column Lengths: Container (DefaultContainerColumnLength) String Column Lengths: DocumentAsJSON (DefaultJSONColumnLength) N/A (DefaultBinaryColumnLength) Enable Updating Multiple Rows (UpdateMultipleRows) Default Value (two underscore characters) Description The separator to use with nested columns (for embedded documents and arrays). The separator can be single or multiple characters in length. Note: The driver assumes that the separator string would never occur in column names. MongoDB uses the period separator by default. 100 The number of rows to sample when detecting schema for a table primary The Read Preference option defines how to route read operations to the members of a replica set. 255 The default string column length to use. MongoDB does not provide the length for String columns in its column metadata. The option allows you to tune the length of String columns. 511 The default column length to use with containers (arrays and objects) in MongoDB 1023 The default column length to use with documentasjson fields. Note: See also the Enable reading/writing as JSON document driver configuration option The default column length to use with binary data Clear (0) When the option is disabled (0), then UPDATE statements update one row only even if multiple rows match the filters. When enabled (1), then all rows that match the filters are updated. 22
28 Field Label (Key) Get Metadata From (LocalMetadataFile) Default Value Clear Description When clear, then the driver loads metadata from the collection in the database named Mersenne_Collection_Metadata. When set to a file path, then the driver loads metadata from the local file specified in the file path. The metadata in the local file needs to be in a predefined JSON format. Table 1 Advanced Configuration Options 23
Simba ODBC Driver with SQL Connector for MongoDB
Simba ODBC Driver with SQL Connector for MongoDB Installation and Configuration Guide October 24, 2013 Simba Technologies Inc. Copyright 2012-2013 Simba Technologies Inc. All Rights Reserved. Information
More informationSimba Cassandra ODBC Driver with SQL Connector
Simba Cassandra ODBC Driver with SQL Connector Last Revised: March 26, 2013 Simba Technologies Inc. Copyright 2012-2013 Simba Technologies Inc. All Rights Reserved. Information in this document is subject
More informationSimba ODBC Driver for Cloudera Impala
Simba ODBC Driver for Cloudera Impala July 25, 2013 Simba Technologies Inc. Copyright 2012-2013 Simba Technologies Inc. All Rights Reserved. Information in this document is subject to change without notice.
More informationSimba ODBC Driver with SQL Connector for Salesforce
Simba ODBC Driver with SQL Connector for Salesforce Installation and Configuration Guide Last Revised: May 28, 2013 Simba Technologies Inc. Copyright 2012-2013 Simba Technologies Inc. All Rights Reserved.
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. May 15, 2015 Copyright 2015 Simba Technologies Inc. All Rights Reserved. Information in this document is
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba ODBC Driver with SQL Connector for Google BigQuery Installation and Configuration Guide Simba Technologies Inc. Version 2.1.20 November 30, 2018 Copyright 2018 Simba Technologies Inc. All Rights
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Athena ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.0.2 December 11, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Azure DocumentDB ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 2.0.2 March 15, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved.
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba SQL Server ODBC Driver Installation and Configuration Guide Simba Technologies Inc. Version 1.4.13 November 22, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information in this
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Cassandra ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 2.5.6 February 2, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Cassandra ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 2.4.6 April 3, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationInstall Guide DataStax
DataStax ODBC driver for Apache Cassandra and DataStax Enterprise with CQL connector DataStax Version 2.5.7 June 1, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information in this
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba MySQL ODBC Driver Installation and Configuration Guide Simba Technologies Inc. Version 1.0.3 December 5, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information in this document
More informationHortonworks Phoenix ODBC Driver
Hortonworks Phoenix ODBC Driver User Guide Revised: October 2018 2012-2018 Hortonworks Inc. All Rights Reserved. Parts of this Program and Documentation include proprietary software and content that is
More informationCloudera ODBC Driver for Apache Hive Version
Cloudera ODBC Driver for Apache Hive Version 2.5.12 Important Notice 2010-2014 Cloudera, Inc. All rights reserved. Cloudera, the Cloudera logo, Cloudera Impala, Impala, and any other product or service
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Drill ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.3.15 November 1, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Athena ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.0.4 November 14, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information
More informationCloudera ODBC Driver for Apache Hive Version
Cloudera ODBC Driver for Apache Hive Version 2.5.10 Important Notice 2010-2014 Cloudera, Inc. All rights reserved. Cloudera, the Cloudera logo, Cloudera Impala, Impala, and any other product or service
More informationCloudera ODBC Driver for Apache Hive Version
Cloudera ODBC Driver for Apache Hive Version 2.5.15 Important Notice 2010-2015 Cloudera, Inc. All rights reserved. Cloudera, the Cloudera logo, Cloudera Impala, Impala, and any other product or service
More informationTeradata ODBC Driver for Presto. Installation and Configuration Guide
Teradata ODBC Driver for Presto Installation and Configuration Guide Version 1.1.16 December, 2017 About This Guide About the Teradata Presto ODBC Driver Purpose The Teradata ODBC Driver for Presto Installation
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba ServiceNow ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.1.1 June 30, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationQuickstart Guide for Windows Simba Technologies Inc.
Simba Apache Cassandra ODBC Driver Simba Technologies Inc. September 15, 2015 Copyright 2015 Simba Technologies Inc. All Rights Reserved. Information in this document is subject to change without notice.
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba QuickBooks ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.1.1 June 30, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationSimbaO2X. User Guide. Simba Technologies Inc. Version:
SimbaO2X User Guide Simba Technologies Inc. Version: 4.6.4.14 Revision Date: August 2015 Copyright 2015 Simba Technologies Inc. All Rights Reserved. Information in this document is subject to change without
More informationPageScope Box Operator Ver. 3.2 User s Guide
PageScope Box Operator Ver. 3.2 User s Guide Box Operator Contents 1 Introduction 1.1 System requirements...1-1 1.2 Restrictions...1-1 2 Installing Box Operator 2.1 Installation procedure...2-1 To install
More informationSimba ODBC Driver with SQL Connector for Google
Simba ODBC Driver with SQL Connector for Google BigQuery 1.1.11 The release notes provide details of enhancements and features in Simba ODBC Driver with SQL Connector for Google BigQuery 1.1.11, as well
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Teradata ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 16.20.00 August 28, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationWhat would you do if you knew? Teradata ODBC Driver for Presto Installation and Configuration Guide Release December 2015
What would you do if you knew? Teradata ODBC Driver for Presto Installation and Configuration Guide Release 1.0.0 December 2015 The product or products described in this book are licensed products of Teradata
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Impala ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.2.16 October 31, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Spark ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.2.5 August 4, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Salesforce Adapter for SAP Data Services Installation and Configuration Guide Simba Technologies Inc. Version 14.2.11 March 29, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information
More informationWhat would you do if you knew? Teradata ODBC Driver for Presto Installation and Configuration Guide Release B K October 2016
What would you do if you knew? Teradata ODBC Driver for Presto Installation and Configuration Guide Release 1.1.4 B035-6060-106K October 2016 The product or products described in this book are licensed
More informationSimba ODBC Driver with SQL Connector for MongoDB
Simba ODBC Driver with SQL Connector for MongoDB Quickstart Guide for Windows Simba Technologies Inc. Revised: June 10, 2015 Contents Purpose... 3 Installing and Running MongoDB... 3 Importing Sample Data
More informationMigration Tool. Migration Tool (Beta) Technical Note
Migration Tool (Beta) Technical Note VERSION: 6.0 UPDATED: MARCH 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo
More informationiwrite technical manual iwrite authors and contributors Revision: 0.00 (Draft/WIP)
iwrite technical manual iwrite authors and contributors Revision: 0.00 (Draft/WIP) June 11, 2015 Chapter 1 Files This section describes the files iwrite utilizes. 1.1 report files An iwrite report consists
More informationRTI Connext DDS Core Libraries
RTI Connext DDS Core Libraries Getting Started Guide Addendum for Database Setup Version 5.3.1 2018 Real-Time Innovations, Inc. All rights reserved. Printed in U.S.A. First printing. February 2018. Trademarks
More informationMagicInfo Express Content Creator
MagicInfo Express Content Creator MagicInfo Express Content Creator User Guide MagicInfo Express Content Creator is a program that allows you to conveniently create LFD content using a variety of templates.
More informationCopyright PFU LIMITED
-------------------------------------------------------- PaperStream Capture 1.0.12 README File -------------------------------------------------------- Copyright PFU LIMITED 2013-2015 This file contains
More informationUser Guide. Calibrated Software, Inc.
User Guide Calibrated Software, Inc. Copyright 2008 Calibrated Software, Inc. All rights reserved. www.calibratedsoftware.com Your rights to the software are governed by the accompanying Software License
More informationTWAIN driver User s Guide
4037-9571-05 TWAIN driver User s Guide Contents 1 Introduction 1.1 System requirements...1-1 2 Installing the TWAIN Driver 2.1 Installation procedure...2-1 To install the software...2-1 2.2 Uninstalling...2-1
More informationOpen Source Used In TSP
Open Source Used In TSP 3.5.11 Cisco Systems, Inc. www.cisco.com Cisco has more than 200 offices worldwide. Addresses, phone numbers, and fax numbers are listed on the Cisco website at www.cisco.com/go/offices.
More informationRSA Two Factor Authentication
RSA Two Factor Authentication Feature Description VERSION: 6.0 UPDATED: JULY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies
More informationNTLM NTLM. Feature Description
Feature Description VERSION: 6.0 UPDATED: JULY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo are registered
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Netezza ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 1.0.3 September 26, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationOpen Source Used In Cisco Configuration Professional for Catalyst 1.0
Open Source Used In Cisco Configuration Professional for Catalyst 1.0 Cisco Systems, Inc. www.cisco.com Cisco has more than 200 offices worldwide. Addresses, phone numbers, and fax numbers are listed on
More informationPacket Trace Guide. Packet Trace Guide. Technical Note
Packet Trace Guide Technical Note VERSION: 2.0 UPDATED: JANUARY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo
More informationVMware vcenter Log Insight Manager. Deployment Guide
VMware vcenter Log Insight Manager Deployment Guide VERSION: 6.0 UPDATED: JULY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Hive ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 2.1.10 March 23, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved. Information
More informationFujitsu ScandAll PRO V2.1.5 README
-------------------------------------------------------- Fujitsu ScandAll PRO V2.1.5 README -------------------------------------------------------- Copyright PFU Limited 2007-2017 This file contains information
More informationCopyright PFU LIMITED 2016
-------------------------------------------------------- PaperStream Capture Lite 1.0.1 README File -------------------------------------------------------- Copyright PFU LIMITED 2016 This file contains
More informationAdobe Connect. Adobe Connect. Deployment Guide
Deployment Guide VERSION: 1.0 UPDATED: MARCH 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo are registered trademarks
More informationHyper-V - Windows 2012 and 8. Virtual LoadMaster for Microsoft Hyper-V on Windows Server 2012, 2012 R2 and Windows 8. Installation Guide
Virtual LoadMaster for Microsoft Hyper-V on Windows Server 2012, 2012 R2 and Windows 8 Installation Guide VERSION: 5.0 UPDATED: JANUARY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc..
More informationEnterprise Payment Solutions. Scanner Installation April EPS Scanner Installation: Quick Start for Remote Deposit Complete TM
Enterprise Payment Solutions Complete TM Portions of this software: Copyright 2004-2013 Apache Software Foundation Copyright 2005 Paul Querna Copyright 2008 Marc Gravell Copyright 2000-2007 Niels Provos
More informationSplunk. Splunk. Deployment Guide
Deployment Guide VERSION: 1.0 UPDATED: JULY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo are registered trademarks
More informationConfiguring Real Servers for DSR
Configuring Real Servers for DSR VERSION: 1.1 UPDATED: JULY 2013 Copyright 2002-2013 KEMP Technologies, Inc. All Rights Reserved. Page 1 / 20 Copyright Notices Copyright 2002-2013 KEMP Technologies, Inc..
More informationCloudera ODBC Driver for Impala
Cloudera ODBC Driver for Impala Important Notice 2010-2017 Cloudera, Inc. All rights reserved. Cloudera, the Cloudera logo, and any other product or service names or slogans contained in this document,
More informationInstalling the Shrew Soft VPN Client
Windows Install Installing the Shrew Soft VPN Client ShrewVPNWindows201211-01 Global Technology Associates 3505 Lake Lynda Drive Suite 109 Orlando, FL 32817 Tel: +1.407.380.0220 Fax. +1.407.380.6080 Email:
More informationSkyPilot OS Installation: Fedora Core 5
SkyPilot OS Installation: Fedora Core 5 PN 671-00024-01 2006 SkyPilot Networks, Inc. All rights reserved This publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose.
More informationCloudera ODBC Driver for Apache Hive Version
Cloudera ODBC Driver for Apache Hive Version 2.5.17 Important Notice 2010-2016 Cloudera, Inc. All rights reserved. Cloudera, the Cloudera logo, Cloudera Impala, Impala, and any other product or service
More informationDocumentation Roadmap for Cisco Prime LAN Management Solution 4.2
Documentation Roadmap for Cisco Prime LAN Thank you for purchasing Cisco Prime LAN Management Solution (LMS) 4.2. This document provides an introduction to the Cisco Prime LMS and lists the contents of
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba Hive ODBC Driver with SQL Connector Installation and Configuration Guide Simba Technologies Inc. Version 2.6.1 August 3, 2018 Copyright 2018 Simba Technologies Inc. All Rights Reserved. Information
More informationInstallation and Configuration Guide Simba Technologies Inc.
Simba JDBC Driver with SQL Connector for Cloud Spanner Installation and Configuration Guide Simba Technologies Inc. Version 1.0.7 May 19, 2017 Copyright 2017 Simba Technologies Inc. All Rights Reserved.
More informationLoadMaster VMware Horizon (with View) 6. Deployment Guide
LoadMaster VMware Horizon (with View) 6 Deployment Guide VERSION: 6.0 UPDATED: MARCH 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the
More informationSimba ODBC Driver with SQL Connector for Apache Cassandra
Simba ODBC Driver with SQL Connector for Apache Cassandra 2.0.16 The release notes provide details of enhancements and features in Simba ODBC Driver with SQL Connector for Apache Cassandra 2.0.16, as well
More informationTheGreenBow VPN Client ios User Guide
www.thegreenbow.com TheGreenBow VPN Client ios User Guide Property of TheGreenBow 2018 Table of Contents 1 Presentation... 3 1.1 TheGreenBow VPN Client... 3 1.2 TheGreenBow VPN Client main features...
More informationTenable Hardware Appliance Upgrade Guide
Tenable Hardware Appliance Upgrade Guide June 4, 2012 (Revision 3) The newest version of this document is available at the following URL: http://static.tenable.com/prod_docs/tenable_hardware_appliance_upgrade.pdf
More informationBar Code Discovery. Administrator's Guide
Bar Code Discovery Administrator's Guide November 2012 www.lexmark.com Contents 2 Contents Overview...3 Configuring the application...4 Configuring the application...4 Configuring Bar Code Discovery...4
More informationData Deduplication Metadata Extension
Data Deduplication Metadata Extension Version 1.1c ABSTRACT: This document describes a proposed extension to the SNIA Cloud Data Management Interface (CDMI) International Standard. Publication of this
More informationMoodle. Moodle. Deployment Guide
Moodle Deployment Guide VERSION: 6.0 UPDATED: MARCH 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo are registered
More informationKEMP Driver for Red Hat OpenStack. KEMP LBaaS Red Hat OpenStack Driver. Installation Guide
KEMP LBaaS Red Hat OpenStack Driver Installation Guide VERSION: 2.0 UPDATED: AUGUST 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP
More informationPreface. Audience. Cisco IOS Software Documentation. Organization
This preface describes the audience, organization, and conventions of this publication, and provides information on how to obtain related documentation. Cisco documentation and additional literature are
More informationUser Manual. Date Aug 30, Enertrax DAS Download Client
EnertraxDL - DAS Download Client User Manual Date Aug 30, 2004 Page 1 Copyright Information Copyright 2004, Obvius Holdings, LLC. All rights reserved. Redistribution and use in source and binary forms,
More informationSkyPilot EMS Installation
SkyPilot EMS Installation 671-00004-01 Rev B 2006 SkyPilot Networks, Inc. All rights reserved This publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose. Product
More informationEpic. Epic Systems. Deployment Guide
Epic Systems Deployment Guide VERSION: 1.0 UPDATED: AUGUST 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP Technologies logo are
More informationSimba ODBC Driver with SQL Connector for Google BigQuery
Simba ODBC Driver with SQL Connector for Google BigQuery for Windows Simba Technologies Inc. Revised: February 12, 2015 Contents Purpose... 3 Accessing BigQuery... 3 Using sample data in BigQuery... 3
More informationGemBuilder for Java Release Notes
GemStone GemBuilder for Java Release Notes Version 3.1.3 November 2016 SYSTEMS INTELLECTUAL PROPERTY OWNERSHIP This documentation is furnished for informational use only and is subject to change without
More informationRelativity Data Server
Relativity Data Server Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com Copyright Micro Focus 2009-2015. All rights reserved. MICRO FOCUS, the Micro Focus
More informationPTZ Control Center Operations Manual
PTZ Control Center Operations Manual Introduction PTZ Control Center is an application software that runs on Windows. By running this software on a Windows PC, you can remotely operate the Panasonic cameras
More informationLoadMaster Clustering
Introduction LoadMaster Clustering Feature Description VERSION: 9.0 UPDATED: JULY 2016 Copyright Notices Copyright 2002-2016 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP
More informationEdge Security Pack (ESP)
Edge Security Pack (ESP) VERSION: 1.2 UPDATED: SEPTEMBER 2013 Copyright 2002-2013 KEMP Technologies, Inc. All Rights Reserved. Page 1 / 22 Copyright Notices Copyright 2002-2013 KEMP Technologies, Inc..
More informationUS Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Service Data Objects (SDO) DFED Sample Application README Copyright IBM Corporation, 2012, 2013 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract
More informationTrimble. ecognition. Release Notes
Trimble ecognition Release Notes Trimble Documentation: ecognition 8.9 Release Notes Imprint and Version Document Version 8.9 Copyright 2013 Trimble Germany GmbH. All rights reserved. This document may
More informationHortonworks Hive ODBC Driver with SQL
Hortonworks Hive ODBC Driver with SQL Connector 2.6.1 Released 2018-08-17 The release notes provide details of enhancements and features in Hortonworks Hive ODBC Driver with SQL Connector 2.6.1, as well
More information[The BSD License] Copyright (c) Jaroslaw Kowalski
Software used by portions of this application require the following license statement: [The BSD License] Copyright (c) 2004-2011 Jaroslaw Kowalski jaak@jkowalski.net All rights reserved. Redistribution
More informationEcma International Policy on Submission, Inclusion and Licensing of Software
Ecma International Policy on Submission, Inclusion and Licensing of Software Experimental TC39 Policy This Ecma International Policy on Submission, Inclusion and Licensing of Software ( Policy ) is being
More informationCarbonite Server Backup Portal 8.5. Administration Guide
Carbonite Server Backup Portal 8.5 Administration Guide 2018 Carbonite, Inc. All rights reserved. Carbonite makes no representations or warranties with respect to the contents hereof and specifically disclaims
More informationStellar WAB to PST Converter 1.0
Stellar WAB to PST Converter 1.0 1 Overview Stellar WAB to PST Converter software converts Outlook Express Address Book, also known as Windows Address Book (WAB) files to Microsoft Outlook (PST) files.
More informationSecurity Explorer 9.1. User Guide
Security Explorer 9.1 User Guide Security Explorer 9.1 User Guide Explorer 8 Installation Guide ii 2013 by Quest Software All rights reserved. This guide contains proprietary information protected by copyright.
More informationHYDRODESKTOP VERSION 1.4 QUICK START GUIDE
HYDRODESKTOP VERSION 1.4 QUICK START GUIDE A guide to using this free and open source application for discovering, accessing, and using hydrologic data February 8, 2012 by: Tim Whiteaker Center for Research
More informationUse in High-Safety Applications
------ ScanSnap Organizer V5.6L20 README File ------ - Contents - 1. Cautions for using environment-dependent characters 2. Cautions Concerning Installation 3. Cautions Concerning the Operation 4. Connecting
More informationGemBuilder for Smalltalk Installation Guide
GemStone GemBuilder for Smalltalk Installation Guide Version 5.4.3 February 2016 SYSTEMS INTELLECTUAL PROPERTY OWNERSHIP This documentation is furnished for informational use only and is subject to change
More informationEcma International Policy on Submission, Inclusion and Licensing of Software
Ecma International Policy on Submission, Inclusion and Licensing of Software Experimental TC39 Policy This Ecma International Policy on Submission, Inclusion and Licensing of Software ( Policy ) is being
More informationHYDRODESKTOP VERSION 1.1 BETA QUICK START GUIDE
HYDRODESKTOP VERSION 1.1 BETA QUICK START GUIDE A guide to help you get started using this free and open source desktop application for discovering, accessing, and using hydrologic data. September 15,
More informationCarbonite Server Backup Portal 8.6. Administration Guide
Carbonite Server Backup Portal 8.6 Administration Guide 2018 Carbonite, Inc. All rights reserved. Carbonite makes no representations or warranties with respect to the contents hereof and specifically disclaims
More informationEncrypted Object Extension
Encrypted Object Extension ABSTRACT: "Publication of this Working Draft for review and comment has been approved by the Cloud Storage Technical Working Group. This draft represents a "best effort" attempt
More informationVolume Disaster Recovery Preparation Express Guide
ONTAP 9 Volume Disaster Recovery Preparation Express Guide August 2018 215-11187_F0 doccomments@netapp.com Table of Contents 3 Contents Deciding whether to use this guide... 4 Volume disaster recovery
More informationStorageGRID Webscale NAS Bridge Management API Guide
StorageGRID Webscale NAS Bridge 2.0.3 Management API Guide January 2018 215-12414_B0 doccomments@netapp.com Table of Contents 3 Contents Understanding the NAS Bridge management API... 4 RESTful web services
More information1.0. Quest Enterprise Reporter Discovery Manager USER GUIDE
1.0 Quest Enterprise Reporter Discovery Manager USER GUIDE 2012 Quest Software. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide
More informationSimbaEngine SDK 9.3. SimbaClientServer User s Guide. Last Revised: May Simba Technologies Inc.
Last Revised: May 2014 Simba Technologies Inc. Copyright 2014 Simba Technologies Inc. All Rights Reserved. Information in this document is subject to change without notice. Companies, names and data used
More informationANZ TRANSACTIVE MOBILE for ipad
ANZ TRANSACTIVE MOBILE for ipad CORPORATE CASH AND TRADE MANAGEMENT ON THE GO QUICK REFERENCE GUIDE April 2016 HOME SCREEN The home screen provides immediate visibility of your favourite accounts and transactions
More information