Getting Started Guide Version 3.0 November 2020
Total Page:16
File Type:pdf, Size:1020Kb
TIBCO® Graph Database Getting Started Guide Version 3.0 November 2020 Copyright © 2020. TIBCO Software Inc. All Rights Reserved. 2 Contents Figures ................................................................................................3 TIBCO Documentation and Support Services ............................................................4 Overview ..............................................................................................5 Editions of TIBCO Graph Database .........................................................................................5 Installing Graph Database ..............................................................................6 Graph Database Folder Structure .......................................................................7 Configuring Graph Database ........................................................................... 8 File Information ............................................................................................................ 8 initdb.conf ............................................................................................................. 8 tgdb.conf .............................................................................................................. 8 tgsec.conf .............................................................................................................9 Graph Database Server Commands and Controls .......................................................10 Graph Database Admin Console .......................................................................11 Graph Database Client ................................................................................12 Hands-on Exercise ....................................................................................13 Initializing the Database ...................................................................................................14 Starting the Database Server ..............................................................................................15 Defining the Metadata in the Admin Console ...............................................................................15 Building the House of Bonaparte ..........................................................................................16 Searching for a Member of the House ..................................................................................... 20 Updating a Member of the House ......................................................................................... 22 Legal and Third-Party Notices ......................................................................... 26 TIBCO® Graph Database Getting Started Guide 3 Figures House of Bonaparte - Family Tree (Partial) ................................................................ 13 TIBCO® Graph Database Getting Started Guide 4 TIBCO Documentation and Support Services How to Access TIBCO Documentation Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainly in HTML and PDF formats. The TIBCO Product Documentation website is updated frequently and is more current than any other documentation included with the product. To access the latest documentation, visit https://docs.tibco.com. Product-Specific Documentation Documentation for TIBCO Graph Database is available on https://docs.tibco.com/products/tibco-graph- database-enterprise-edition-3-0-0 page. This feature is available to both Enterprise edition and Community. The guidelines specified for Clustering is applicable only to Enterprise edition. The following documents form the documentation set: ● TIBCO® Graph Database Getting Started: Read this manual before reading any other manual in the documentation set. This manual describes the terminology and concepts of the platform. The other manuals in the documentation set assume you are familiar with the information in this manual. ● TIBCO Graph Database Administration : Read this manual to learn how to manage the runtime and deploy and manage applications. ● TIBCO® Graph Database Security Guidelines: Read this manual to learn more about security guidelines and recommendations for TIBCO® Graph Database. ● TIBCO Graph Database Release Notes: Read this manual for a list of new and changed features, steps for migrating from a previous release, and lists of known issues and closed issues for the release. How to Contact TIBCO Support You can contact TIBCO Support in the following ways: ● For an overview of TIBCO Support, visit http://www.tibco.com/services/support. ● For accessing the Support Knowledge Base and getting personalized content about products you are interested in, visit the TIBCO Support portal at https://support.tibco.com. ● For creating a Support case, you must have a valid maintenance or support contract with TIBCO. You also need a user name and password to log in to https://support.tibco.com. If you do not have a user name, you can request one by clicking Register on the website. How to Join TIBCO Community TIBCO Community is the official channel for TIBCO customers, partners, and employee subject matter experts to share and access their collective experience. TIBCO Community offers access to Q&A forums, product wikis, and best practices. It also offers access to extensions, adapters, solution accelerators, and tools that extend and enable customers to gain full value from TIBCO products. In addition, users can submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to https://community.tibco.com. TIBCO® Graph Database Getting Started Guide 5 Overview TIBCO Graph Database is a translytical database that delivers a complex web of dynamic data into analytical relationships at the speed of transactions. A graph represents a set of objects, which are called nodes, and the connections between these nodes, which are called edges. Edges can be unidirectional (directed from one node to another node) or bidirectional (directed from one node to another and vice versa), or undirected. A single graph can hold multiple types of nodes. Example: A graph named GRAPH 1 can have two nodes, one node of type PERSON and one node of type BUSINESS. The value for node type PERSON can be John Doe and the value of the node type BUSINESS can be Example Corporation. A single node, within a graph, can have one or more edges. Example: In the graph named GRAPH 1, a node of type PERSON can have an edge with another node of type PERSON, and can also have an edge with another node of type BUSINESS. If the value of one node of type PERSON is John Doe and if the value of another node of type PERSON is Jane Doe, an edge between these two nodes can mean that these two people know each other. Similarly if there is an edge John Doe and Example Corporation, it means that John Doe is a patron of Example Corporation. A graph database is a database that also offers the persistent storage of its data as nodes and edges, so that a graph algorithm can be utilized to traverse the nodes. The benefits of TIBCO Graph Database are as follows: ● Flexible Schema - Assumes objects and nodes are linked by relationships; designed to constantly evolve, without impacting performance of existing queries and app functionality. ● Consistent Performance - Index-free adjacency negates the requirement for index lookups; enables query performance to remain relatively consistent, even as data sets grow. ● Increased Value - Enables quick extraction of new insight from large and complex databases. It also helps uncover unknown interactions and relationships and provides valuable insight into semantic context. Editions of TIBCO Graph Database There are two editions of TIBCO Graph Database: Community Edition and Enterprise Edition. The comparison between the editions are as follows: Particulars Community Edition Enterprise Edition Location https://community.tibco.com https://edelivery.tibco.com Memory 4 GB to 16 GB 4 GB to 1 TB Users 5 Unlimited Connections 10 Unlimited Storage 100 GB 256 TB TIBCO® Graph Database Getting Started Guide 6 Installing Graph Database To install TIBCO Graph Database, see the ReadMe file for the hardware and software requirements. Perform the following steps to install TIBCO Graph Database: Procedure 1. Use one of the following archive files: Option Description tib_tgdb_2.0.0_win_x86_64.tar.gz If your operating system is Windows tib_tgdb_2.0.0_linux26gl212_x86_64.tar.gz If your operating system is Linux tib_tgdb_2.0.0_macosx_x86_64.tar.gz If your operating system is Mac OS X 2. Unzip the archive file to a specific location. The files within the archive will be extracted to the desired location and TIBCO Graph Database is installed on your system. What to do next See the topic Graph Database Folder Structure to understand the folder structure of TIBCO Graph Database, and see the topic Configuring Graph Database to configure TIBCO Graph Database on your system. TIBCO® Graph Database Getting Started Guide 7 Graph Database Folder Structure TIBCO Graph Database folder (for example (tgdb/1.1) contains three folders and three files. The details about the files and folders are as follows: Folders The three folders and their details are as follows: Folder Name Description bin Contains server and admin executables and server configuration files. data An empty directory, which is by default, configured as the database location. lib Contains the Java Client API library. examples Contains few exercises including the hands-on exercise mentioned in this guide. See the Hands- on Exercise