TIB scr-insight 7.9.5 installgd · • TIBCO Scribe Insight Installation Guide Read this manual for...

TIBCO Scribe® Insight

Installation GuideSoftware Release 7.9.5January 2020

Important InformationSOME 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.ANY SOFTWARE ITEM IDENTIFIED AS THIRD PARTY LIBRARY IS AVAILABLE UNDER SEPARATE SOFTWARE LICENSE TERMS AND IS NOT PART OF A TIBCO PRODUCT. AS SUCH, THESE SOFTWARE ITEMS ARE NOT COVERED BY THE TERMS OF YOUR AGREEMENT WITH TIBCO, INCLUDING ANY TERMS CONCERNING SUPPORT, MAINTENANCE, WARRANTIES, AND INDEMNITIES. DOWNLOAD AND USE OF THESE ITEMS IS SOLELY AT YOUR OWN DISCRETION AND SUBJECT TO THE LICENSE TERMS APPLICABLE TO THEM. BY PROCEEDING TO DOWNLOAD, INSTALL OR USE ANY OF THESE ITEMS, YOU ACKNOWLEDGE THE FOREGOING DISTINCTIONS BETWEEN THESE ITEMS AND TIBCO PRODUCTS.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® Scribe Insight and TIBCO® Scribe Insight Adapter are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle Corporation and/or its affiliates.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.This and other products of TIBCO Software Inc. may be covered by registered patents. Please refer to TIBCO's Virtual Patent Marking document (https://www.tibco.com/patents) for details.Copyright © 1996-2020. TIBCO Software Inc. All Rights Reserved. TIBCO Confidential -Information.

https://www.tibco.com/patents

Table Of Contents | 1

Table Of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Product-Specific Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1 Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Component Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Additional TIBCO Scribe Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2 Installation Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Supported Operating Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Minimum Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Microsoft Windows Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Permissions Required To Run TIBCO Scribe Insight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Required Permissions For All Users Or Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Providing Permission To Launch And Access Scribe Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Providing Full Access To The Scribe Message Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Other Required Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Setting Recovery Properties For Scribe Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Insight User Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Determining Your Current Number Of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Selecting And Preparing An Authentication Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Installing TIBCO Scribe Insight With SQL Server Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Installing TIBCO Scribe Insight With Windows Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 3 Installing TIBCO Scribe Insight Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19Downloading TIBCO Scribe Insight Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Run TIBCO Scribe Insight Server Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Installing Scribe Insight Server Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

TIBCO Scribe Insight Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Scribe Services User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Install SQL Server Express 2017 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

TIBCO Scribe Insight Installation Guide

2 | Table Of Contents

Installing Scribe Insight Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Schema Validation Of Scribe Internal Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Installing Adapters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Installing Adapters With The TIBCO Scribe Insight Setup Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Uninstalling Adapters With The TIBCO Scribe Insight Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Chapter 4 Configuring TIBCO Scribe Insight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Access To The TIBCO Scribe Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Security Access In The TIBCO Scribe Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Creating The Scribe Console Admins Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Site Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Setting File Management Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Setting Services Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Setting Message Queue Security (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Creating Alert Recipients And Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Configuring Notification Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Configuring Site Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Changing The Collaboration Root Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Configuring E-mail Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Setting The Sleep Period. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Starting The Notification Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Managing Other Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Starting The Monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Adding a ScribeIn Queue Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Scribe Services User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Chapter 5 Installing TIBCO Scribe Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Install Scribe Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Install Scribe Insight Adapters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Connect To The Scribe Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Adding The Scribe Console Users Group On The Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Configuring DCOM Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Create The Scribe Console Admins Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Chapter 6 Upgrading TIBCO Scribe Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Preinstallation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Install Insight And Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Install Adapters Separately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Updating The Scribe Internal Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57


Table Of Contents | 3

Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Troubleshooting The Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Chapter 7 Installing Insight With Windows Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59Setting Up A Principal With Database Create Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Installing Insight With Windows Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Setting Up Principals That Use Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Editing Scribe Services Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Chapter 8 Configuring A Failover Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63Scribe Internal Database Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Hyper-V Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Application-Based. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Mixed-Mode Clustering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Configure An Application-Based Failover Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Example: Two-Node Clustered Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Installing And Configuring TIBCO Scribe Insight On Node 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Install Insight On Node 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Configure The Scribe Internal Database On Node 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Copy SQL Scripts To The Scribe Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Set Up the Scribe Internal Database With SQL AlwaysOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Configure Scribe Services On Node 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Add Users To The Scribe Console Users Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Configure Settings In The TIBCO Scribe Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Stop Scribe Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Change The TIBCO Scribe Insight Server Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Installing And Configuring TIBCO Scribe Insight On Node 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Install Insight On Node 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Connect To The Scribe Internal Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Configure Scribe Services On Node 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Configure A Cluster To Run TIBCO Scribe Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Take The TIBCO Scribe Cluster Online And Offline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Run The Failovermove.Sql Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Register Scribe On Node 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Add The Network Site To TIBCO Scribe Console For Node 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Moving And Testing The TIBCO Scribe Insight Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Upgrading TIBCO Scribe Insight In A Failover Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Chapter 9 Installation Checklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97


4 | Table Of Contents

Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Verify Hardware, Software, and Database Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Configure SQL Server Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Determine A Failover Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Install TIBCO Scribe Insight Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Download And Run The Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Install Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Install TIBCO Scribe Insight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Add Scribe Services User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Install SQL Server Express (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Install TIBCO Scribe Insight Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Install Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Add Users To The Scribe Console Users Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Create Scribe Console Admins Group, Add Administrative Users (Optional) . . . . . . . . . . . . . . . . . . . 101Manage Security Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Configure Notification Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Configure Site Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Start The Remaining Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Create The ScribeIn Queue Monitor (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Optional. Create A User For The Scribe Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Upgrade Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Perform Preinstallation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Install Insight And Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Install Adapters Separately (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Update Scribe Internal Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Perform Post Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Add Users To Scribe Console Users Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Chapter 10 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Downloading Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Appendix A TIBCO Scribe Insight With TLS 1.2 Only Enabled . . . . . . . . . . . . . . . . . . . . . . . . .111Recreating The ODBC DSNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111


Preface | 1

Preface

TIBCO is proud to announce the latest release of TIBCO Scribe Insight software version 7.9.5.

Related Documentation

This section lists documentation resources you may find useful.

Product-Specific DocumentationThe following documents form the TIBCO Scribe Insight documentation set:

• TIBCO Scribe Insight Release Notes Read the release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release. See TIBCO Scribe Insight Version 7.9.5 Release Notes.

• TIBCO Scribe Insight Installation Guide Read this manual for instructions on site preparation and installation.

• TIBCO Scribe Insight Online Help Library Read this documentation to gain an understanding of the product that you can apply to the various tasks you may undertake. See TIBCO Scribe Insight Help Library.


https://help.scribesoft.com/scribeinsight/en/index.htm

https://help.scribesoft.com/retpdfs/TIB_scr-insight_795_relnotes.pdf

https://help.scribesoft.com/retpdfs/TIB_scr-insight_795_relnotes.pdf

2 | Related Documentation


Installation Overview | 3

Chapter 1 Installation Overview

Before you install TIBCO Scribe Insight, you should have an understanding of the components you will be installing, as well as an overview of the installation process.

Component Overview

TIBCO Scribe Insight consists of several components, most of which reside on your TIBCO Scribe server.

The TIBCO Scribe server does not need to be a dedicated computer. You can install TIBCO Scribe on your application server or database server; however, optimal performance is typically realized by installing TIBCO Scribe server components on a dedicated computer. The non-server components can be installed on any workstation that meets the system requirements for that component.

ComponentsThere are four main components included in the Scribe installation:

• TIBCO Scribe Internal Database – (SCRIBEINTERNAL) Contains settings, process execution history, error logs, and other TIBCO Scribe-related data. This Microsoft SQL Server database is used by all other TIBCO Scribe Insight components. If your site does not have SQL Server, you can install Microsoft SQL Server Express as part of the TIBCO Scribe Insight installation process.

• TIBCO Scribe Insight server – Uses Windows services to provide automated integration processes and system monitoring. The TIBCO Scribe Insight server also includes TIBCO Scribe Workbench and TIBCO Scribe Console components.

• TIBCO Scribe Workbench – Provides a rich graphical environment in which data mappings can be designed, tested and manually run. These data mappings can be saved as data translation specification (.dts) files, which are the fundamental building blocks of Insight processes.


4 | Chapter 1 Installation Overview

After installing and configuring the TIBCO Scribe Insight server, you can install the TIBCO Scribe Workstation, which includes the TIBCO Scribe Console and Workbench, on any workstation on your network. For information about installing TIBCO Scribe Workstation, see Chapter 5, Installing TIBCO Scribe Workstation, on page 45.

• TIBCO Scribe Console – Provides a user interface for configuring and managing automated integration processes on the TIBCO Scribe Insight server. This is a Microsoft Management Console (MMC)-based application you can install independently of the Workbench (installed separately as the TIBCO Scribe Workstation) and the rest of the product, and configure it to connect to a TIBCO Scribe Insight server on your network or over the Internet.

Additional TIBCO Scribe SoftwareYou can optionally install the following software:

• TIBCO Scribe Adapters – Provide an interface to a specific application or technology. TIBCO Scribe has a full suite of adapters for the leading front office and back office applications. The adapters are included as part of the TIBCO Scribe Insight installation.

See the TIBCO Scribe Insight Help Library for the Help on each adapter, which provides more information about installing and using



Installation Prerequisites | 5

Chapter 2 Installation Prerequisites

Before you begin install and configure the TIBCO Scribe Insight components, verify your system is correctly configured. TIBCO Scribe products run on most modern Windows-based computers. Additional internal memory, faster processors, and larger hard drives can improve response times.

Supported Operating Systems

• Windows 10 Enterprise and Professional Editions (x64)

• Windows Server 2016 Data Center and Standard Editions (x64)

• Windows Server 2012 Data Center and Standard Editions (x64)

Windows 10 Home Edition is not supported. This edition of Windows does not provide access to users and groups required to add users to the Scribe Console Users group.


6 | Chapter 2 Installation Prerequisites

Minimum Hardware Requirements

While TIBCO Scribe Insight does not require TIBCO Scribe server components be installed on a separate dedicated computer, doing so can greatly improve performance. If necessary, you can install TIBCO Scribe on your application server or database server.

Minimum hardware requirements are:

• 64-bit processor – 2.4 GHz (or greater)

• System memory – 4 GB of system memory is required (more is recommended)

Microsoft Windows Components

• Microsoft.NET Framework 4.0 or later – You can install Microsoft .NET Framework 4.0 from the TIBCO Scribe Insight installer if it is not already installed.

— On Windows 2012, also install Microsoft .NET Framework 3.5.

— If you are connecting to a system that requires a TLS 1.2 connection, you must install Microsoft .NET Framework 4.5.2 or later. Some Windows Operating Systems do not support TLS 1.1 or 1.2. See this Microsoft Blog post for additional information: Support For SSL/TLS Protocols On Windows.

— If you are installing TIBCO Scribe Insight on a system with TLS 1.2 enabled, you must also have TLS 1.0 enabled during the installation. After the installation is complete, you can disable TLS 1.0.

— If you disable TLS 1.0 and only TLS 1.2 is enabled, :

You must update the Scribe Internal Database to use one of the following drivers: Microsoft® ODBC Driver 13 for SQL Server® - Windows + Linux or later or SQL Server Native Client 11.0 (v 2011.110.6518.000) or later

See Appendix A, TIBCO Scribe Insight With TLS 1.2 Only Enabled, on page 111.

All drivers for connections must support TLS 1.2.


https://blogs.msdn.microsoft.com/kaushal/2011/10/02/support-for-ssltls-protocols-on-windows/


Database Requirements | 7

• IIS 7.0 or later – IIS 6 Management Compatibility Mode may be required by the TIBCO Scribe server Operating System and installed components.

• Microsoft Message Queuing Service (MSMQ) – If using message queuing, multi-threaded message processors, or TIBCO Scribe Publishers.

Database Requirements

• Microsoft SQL Server 2017 – Enterprise, Standard, and Express




With MSMQ, a machine name can be no longer than 15 characters.

TIBCO Scribe Insight currently ships with Microsoft SQL Server 2017 Express edition for x64 operating systems.

For TIBCO Scribe Insight products, the SCRIBEINTERNAL database is supported only on Latin_General collation orders (either case-sensitive or non-case-sensitive).

SSL must be enabled on the TIBCO Scribe Insight server where the database is installed for successful communication between Insight and the Scribe Internal Database.



Permissions Required To Run TIBCO Scribe Insight

Local administrator permissions are required to install TIBCO Scribe products. However, to run TIBCO Scribe Insight as a domain user, there are also certain Windows user permissions required.

This section describes the domain user permissions required to run TIBCO Scribe Insight. Your Windows environment determines how you access Windows Component Services and Computer Management. Because TIBCO Scribe Insight runs in multiple Windows environments, some fields, dialogs, and components may have different names than those described here.


Permissions Required To Run TIBCO Scribe Insight | 9

Required Permissions For All Users Or GroupsDomain users who will be running Scribe Services need:

• Permission to launch and access Scribe Services

• Full access to the Scribe message queues

Providing Permission To Launch And Access Scribe ServicesAs part of the installation process, five Scribe services are installed:

• Scribe AdminServer

• Scribe BridgeServer

• Scribe EventManager

• Scribe MessageServer

• Scribe MonitorServer



In Windows Component Services, ensure each domain user has permission to launch and access Scribe services:

1. Start Windows Component Services.

2. Expand Computers and expand My Computer.

3. Expand DCOM Config.

4. For each of the five Scribe services:

a. Right-click the Scribe service and select Properties.

b. On the Security tab, under Launch and Activation Permissions, click Customize.

c. Click Edit. The Launch and Activation Permission dialog box displays.

d. Click Add and add the domain user.

e. Under Permissions, select Allow for Local Launch and Local Activation.

f. Click OK to save your changes and close the Launch and Activation Permission dialog box.

g. Under Access Permissions, click Customize.

h. Click Edit. The Access Permissions dialog box displays.

i. Click Add and add the domain user.

j. Under Permissions, for Local Access, select Allow.

k. Click OK to save your changes and close the Access Permissions dialog box.

5. When you are done, exit Component Services.

Providing Full Access To The Scribe Message QueuesUnder Windows Computer Management, you must provide access to TIBCO Scribe Message Queues and, depending on your installation, other message queues used by TIBCO Scribe Insight:

1. Start Computer Management.

2. In the Computer Management tree, expand the following nodes Services and Applications, expand Message Queuing, and expand Private Queues (or Private).

3. Right-click scribedeadmessage and select Properties. The Properties dialog box displays.


Permissions Required To Run TIBCO Scribe Insight | 11

4. Click the Security tab.

5. Click Add, and add the domain user.

6. Under Permissions for the domain user, for Full Control, select Allow.

7. Click OK to save your changes and close the Properties dialog box.

8. Repeat steps 3 and 4 for the ScribeIn and the ScribeRetry queues, and any other queues used by TIBCO Scribe Insight (such as Publisher queues for Microsoft Dynamics 365 and CRM or Microsoft Dynamics NAV adapters).

9. When you are done, close Computer Management.

10. Restart the following Services:

— Message Queuing

— Scribe MessageService

— Scribe AdminServer

— Scribe BridgeServer

— Scribe EventManager

— Scribe MonitorServer

Other Required Privileges• If the domain user will use one of the following adapters, you must grant Full

Control to the Windows\Temp folder:

— Microsoft Dynamics 365 And CRM

— Salesforce.com

— Web Services

• If your site uses Windows Authentication, you must set up the domain user as a principal in Microsoft SQL Server with access to the Scribe Internal database. This user must have alter, delete, execute, insert, select and update privileges.



Setting Recovery Properties For Scribe ServicesIf your site experiences any networking interruptions, the Scribe Services may stop. By default, they are configured to restart after the first two network failures each day, waiting ten minutes between restart attempts. If any additional failures occur within a day, the services do not attempt to restart.

After installing TIBCO Scribe Insight review the recovery properties for each of the Scribe Services and modify them as appropriate for your site.

To review the recovery properties for a service:

1. Start Computer Management.

2. In the Computer Management tree, expand Services and Applications, then expand Services.

3. Do the following for each of the following services:

— Scribe MessageService





a. Stop the service.

b. Right-click the service and select Properties.

c. Click the Recovery tab.

d. Modify the settings as appropriate, if necessary.

e. Restart the service.


Insight User Licensing | 13

Insight User Licensing

When your organization buys TIBCO Scribe Insight, it purchases an Edition based on the number of CRM or ERP users they license through applications such as Dynamics 365 / CRM, Salesforce, or Dynamics GP that will be used to connect with Insight.

For example, if your organization runs both Dynamics 365 / CRM and Salesforce CRM systems, and you have:

• 50 Dynamics 365 / CRM user licenses for Rose & Thorn Company

• 50 Dynamics 365 / CRM user licenses for Green Landscapes Company

• 120 Salesforce users for Flowers Company for All Organization

When you use TIBCO Scribe Insight to connect to those companies, Insight adds the total number of licensed users for those systems, for a total of 220 users. Therefore, your organization must purchase a TIBCO Scribe Insight Standard license that allows (or supports) up to 250 users. If you add a new Salesforce Organization with 100 users, you have 100 Dynamics CRM users and 220 Salesforce users, for a total of 320 users, which exceeds the number allowed by your current Insight license.

As soon as the total number of CRM users exceeds the number of users for your Insight license, your Insight Administrator receives a warning email each day that these connections are used. At this point, your organization must either:

• Upgrade the Insight license to accommodate more users.

• Stop using a connection to bring the total number of CRM users to under the licensed number (250 in this example).

If your organization neither upgrades nor reduces the number of users, your Insight Administrator receives warning emails for 15 days. After that time, jobs using these connections no longer run.

CRM and ERP users are counted separately. However, the same rules apply for organizations using ERP applications.



Determining Your Current Number Of UsersThe License Details dialog box provides information about your licensed applications and total user count for both CRM and ERP systems. For example:

To determine the number of licensed CRM or ERP users currently using Scribe Insight:

1. In the TIBCO Scribe Workbench, select Help > Add or Upgrade license. The Select Registration Option screen displays.

2. Click Next. The License Upgrade/Expansion screen displays.

3. Click Next. The Collect User Information screen displays.

4. Click Next. The Product Unlock Status screen displays.

5. Select the Scribe Insight product Feature Code line and click Show License Details. The License Details dialog box displays.


Selecting And Preparing An Authentication Method | 15

To select a row, click the left-most column.

6. Click Close. You return to the Product Unlock Status screen.

7. Click Cancel. You return to the Workbench.

Selecting And Preparing An Authentication Method

Before you install TIBCO Scribe Insight and create the Scribe Internal database, decide whether your site will use SQL Server Authentication or Windows Authentication, and prepare your site to use the selected method. For more information about using each authentication mode, see Choose an Authentication Mode on the Microsoft Documentation site.

Installing TIBCO Scribe Insight With SQL Server AuthenticationFor information about installing the Scribe Internal database using SQL Server authentication, see Installing Scribe Insight Server on page 25.

SQL Server authentication requires:

• A Windows user that is the local administrator

• The user name and password of the SQL Server Authentication user


https://docs.microsoft.com/en-us/sql/relational-databases/security/choose-an-authentication-mode?view=sql-server-2017

https://docs.microsoft.com/en-us/sql/relational-databases/security/choose-an-authentication-mode?view=sql-server-2017


Installing TIBCO Scribe Insight With Windows AuthenticationFor information about installing with Windows Authentication, see Chapter 7, Installing Insight With Windows Authentication, on page 59.

Windows authentication requires:

• A Windows user that is the local administrator

• The name and password of a Windows account that has database create and modify privileges on SQL Server

• The name and password of a Windows principal with datareader and datawriter access

If you are installing TIBCO Scribe Insight with any edition of Microsoft SQL Server 2012, edit the properties of the Scribe services to log on as a principal with proper rights, as described in Installing Scribe With Windows Authentication.

If you are upgrading from a previous release and want to change from SQL Server Authentication to Windows Authentication, see the TIBCO Scribe Insight Help Library for more information.

The SCRIBEINTERNAL database is supported only on Latin_General collation orders (either case-sensitive or non case-sensitive).




Failover | 17

Failover

Failover allows a group of servers to maintain a high availability of the TIBCO Scribe Insight Application and Services. You can perform failover for TIBCO Scribe Insight with either application-based clustering or Hyper-V clustering.

The method you use choose depends on your site requirements:

• Application-based failover — Requires two servers in a Windows Failover Cluster and is supported on Windows Server 2012 and later.

• Hyper-V Clustering — Requires a two-node Windows Failover Cluster with Hyper-V installed. Hyper-V Clustering for TIBCO Scribe Insightis supported on Windows Server 2012 and later.

• Mixed-mode clustering — This is a combination of Application-based and Hyper-V Clustering. In this mode, you install and configure Hyper-V clustering, using two images where one image is active and the other is in standby mode.

For more information, see, Configure An Application-Based Failover Cluster, on page 68.




Installing TIBCO Scribe Insight Server | 19

Chapter 3 Installing TIBCO Scribe Insight Server

To install the TIBCO Scribe Insight server:

• Download TIBCO Scribe Insight software

• Install prerequisites the TIBCO Scribe Insight server

• Validate the Scribe Internal database schema

• Install adapters

Downloading TIBCO Scribe Insight Software

1. Verify you:

— Have appropriate hardware and software. See Chapter 2, Installation Prerequisites, on page 5.

— Have the login names and passwords for any accounts to be used with TIBCO Scribe Insight

— Are logged into the server system as a user with Administrative privileges

— Know which authentication method your site will use for SQL Server. See Selecting And Preparing An Authentication Method on page 15.

— Have any required serial numbers.

2. Log into eDelivery, search for TIBCO Scribe Insight, and select the installer for your software.

You must be logged in as a user with local administrator privileges to complete the installation and configuration.

When you download TIBCO Scribe Insight from the TIBCO eDelivery site, a serial number is generated for you and is included in the download in a file called TIB_scr-insight_license_key.pdf. This key is required during the registration process.


https://edelivery.tibco.com/storefront/index.ep

20 | Chapter 3 Installing TIBCO Scribe Insight Server

3. When the download completes, run the self-extractor to unzip the installer files.

This creates a directory that contains the installer files. The directory is called TIB_scr-insight_7.9.5_win_x86_64.

Run TIBCO Scribe Insight Server Installer

Open the directory and run Setup.exe. The TIBCO Scribe Insight installation begins.

If you are not logged in as a user with administrative privileges, an error displays. Log out, log into an administrative account, and repeat this procedure.

Installing Scribe Insight Server Prerequisites

When you run Setup.exe, the TIBCO Scribe Insight Setup window displays information about Microsoft components required to run Insight. If any required components are not installed, you have the option of installing them.

Alternatively, you can install missing components by exiting out of the TIBCO Scribe Insight Setup window, installing the necessary components, and restarting the setup procedure.

If you are upgrading from an existing TIBCO Scribe Insight installation and receive timeout errors, from the SQL Server Management Studio, run the appropriate script to upgrade from your current version:

• Version 7.7.0 — ScribeInternal_Upgrade_770_to_780.sql



Specify scribeinternal as the destination database.


Installing Scribe Insight Server Prerequisites | 21

TIBCO Scribe Insight Components• Microsoft Windows Installer 3.1 – Allows TIBCO Scribe to install the Insight

Server. If the Microsoft Windows Installer is not available, the check box is automatically selected to allow the TIBCO Scribe Insight Setup Wizard to install it.

• Microsoft .NET Framework 4.0 or later – If the correct version of the Microsoft .NET Framework (and any Service Packs) is not installed, the check box is automatically selected to allow the TIBCO Scribe Insight Setup Wizard to install it.

• Microsoft SQL Express 2017 – Optional, provided with the TIBCO Scribe Insight software package, you can use it if your site does not have Microsoft SQL Server installed. To install Microsoft SQL Server Express 2017, select the check box.

In addition, you can install the current version of TIBCO Scribe Insight and any adapters from the TIBCO Scribe Insight Setup window. Adapters can be installed or removed after installing Insight.

If you are connecting to a system that requires a TLS 1.2 connection, you must install Microsoft .NET Framework 4.5.2 or later. Some Windows Operating Systems do not support TLS 1.1 or 1.2. See this Microsoft Blog post for additional information: Support For SSL/TLS Protocols On Windows.

If you are installing TIBCO Scribe Insight on a system with TLS 1.2 enabled, you must also have TLS 1.0 enabled during the installation. After the installation is complete, you can disable TLS 1.0.

If you disable TLS 1.0 and only TLS 1.2 is enabled:

— You must update the Scribe Internal Database to use one of the following drivers: Microsoft® ODBC Driver 13 for SQL Server® - Windows + Linux or later or SQL Server Native Client 11.0 (v 2011.110.6518.000) or later

See Appendix A, TIBCO Scribe Insight With TLS 1.2 Only Enabled, on page 111.

— All drivers for connections must support TLS 1.2.

— When you install TIBCO Scribe Workstation, you must install the Scribe Internal database on a supported SQL Server instance (local or remote) Insight can access.

— This section describes installing TIBCO Scribe Insight for the first time. For information about connecting to an existing database, see Chapter 6, Upgrading TIBCO Scribe Insight, on page 53.




To learn more about the adapters, see the TIBCO Scribe Insight Help Library for each adapter.

Scribe Services UserThe Scribe Services User is the user whose credentials the Scribe Services use to access remote servers. During a new Insight installation, you can specify a user whose credentials the Scribe Services use.

By default, the Scribe Services use the credentials of the user who installs Insight, and the dbo user is set up in SQL with these credentials. When you define a new user for Scribe Services, Insight sets up a dbo2 user in SQL with the credentials you enter.

This user must:

• Be a user on the current domain

• Have login rights to the SQL Server database

After installing TIBCO Scribe Insight, you can change the service credentials:

1. Verify the Scribe Services are stopped.

2. In the Scribe install directory, execute the Scribe Internal Database Maintenance Utility, InternalDB.

3. Click the Internal Database tab.

4. Click the Test Connection button. A message displays indicating the database was validated.

5. Click OK. A message displays indicating the database indexes were validated.

6. Click OK. A message indicates the connector text is complete.

7. Click OK. The Change Services button is enabled.

8. Click Change Services Name. The Stop Scribe Services message displays.

9. Click OK. The Scribe Change Services Window displays.

10. Enter the login information for the Services User and click OK.

11. Verify the database and database indexes are validated.

If you are installing TIBCO Scribe Insight on Windows 2012, you must install Microsoft .NET Framework 3.5:

1. Select Start > Manage Server.

2. Select Manage > Add Roles and Features.

3. Select Microsoft .NET Framework 3.5.



Installing Scribe Insight Server Prerequisites | 23

Install SQL Server Express 2017Installing Microsoft SQL Server Express 2017 requires a x64 operating system.

1. In the TIBCO Scribe Insight Setup window, verify the Microsoft Windows Installer and Microsoft .NET Framework check boxes are gray and selected, indicating the feature is installed.

If either of these features is not selected in grey, select the check box, click Start Installation, and follow the installation wizard prompts.

2. Select Microsoft SQL Server Express 2017 and click Start Installation.

3. Click OK on the pop-up dialog to extract the installation files. If this is a new installation, the License Terms screen displays. Otherwise, the Microsoft Update screen displays.

4. If the License Terms screen displays, select the I accept the license terms check box and click Next. The Microsoft Update screen displays.

5. Verify the Use Microsoft Update to check for updates check box is selected and click Next. The Install Rules screen displays.

6. Click Next. The Feature Selection screen displays.

7. Verify the Database Engine Services and SQL Server Replication check boxes are selected.

8. Enter the Instance root directory for your site.

The default root directory is C:\Program Files\Microsoft SQL Server\.

9. Click Next. The Instance Configuration screen displays.

10. Enter the Named instance and the Instance ID and click Next. The Server Configuration screen displays.

11. Click Next. The Database Engine Configuration screen displays.

12. Under Authentication Mode, select Mixed Mode.

13. Enter the password for the SQL Server system administrator in the Enter password and Confirm password fields.

14. In Specify SQL Server administrator, verify the correct user is listed. Use the buttons to specify the current user, add a user, or delete a listed user, if necessary. Click Next. A screen shows the progress of the installation, and then the Complete screen displays.

15. Verify all features were successfully installed and click Close.

Make sure you create a strong password (as described on the password window). If you do not, the SQL Server Express installation fails.



16. If you only selected to install SQL Server Express, you return to the TIBCO Scribe Insight screen where you can install the TIBCO Scribe Insight core product. Otherwise, the TIBCO Scribe Insight Setup screen displays.


Installing Scribe Insight Server | 25

Installing Scribe Insight Server

When you install the TIBCO Scribe Insight Server, you install the TIBCO Scribe Insight software, including the TIBCO Scribe Workbench, TIBCO Scribe Console, and Scribe services.

1. If the TIBCO Scribe Insight Setup window is not open, open the Scribe Insight folder and run Setup.exe. At this point, the Microsoft Windows Installer is unavailable.

2. Verify the check box for Microsoft SQL Express is gray and checked. If it is clear, select this check box and install it as part of the Insight installation.

3. Verify the check box for Install Insight is selected. If desired, select Insight Adapters.

4. Click Start Installation. The TIBCO Scribe Insight Setup Wizard displays.

5. Click Next. The License Agreement screen displays.

6. Select I accept the terms in the license agreement and click Next. The Product Selection and Destination folder screen displays.

7. Select Insight Server.

8. If necessary, change the installation location, then click Next. The Ready to Install the Program screen displays.

The default location to install Insight is C:\Program Files (x86)\Scribe\ .

9. Click Install. If a required program is not installed, the installation wizard runs. Follow prompts on each screen. The Setup Wizard Completed screen displays.

10. Click Finish. The Database Setup screen displays.

11. Click Next. The Create the Scribe Internal Database on SQL Express screen displays.

12. In Authentication, do one of the following to specify a database access method:

Use the credentials of the current user — Select Windows authentication. For more information, see Chapter 7, Installing Insight With Windows Authentication, on page 59.



Use SQL Server credentials —

— Select SQL Server authentication.

— Verify Admin Login ID is set to sa.

— In Admin Password, enter the password for the sa account. For more information, see Authentication in the Scribe Help Library.

13. In Database Information, in Instance, select the server where the database is located.

14. Verify the correct name displays in Database Name.

15. Click Database Settings to verify Insight can connect with the specified database. The Internal Database Settings dialog box displays.

16. Click OK. You return to the Create the Scribe Internal Database screen.

17. Click Next. A message that the Scribe Internal Database was validated displays.

If a Scribe Database Setup message displays about resetting another user’s password, click Yes, then click Next again.

18. Click OK. A message that the Scribe Internal Database indexes were validated displays.

19. Click OK. The Scribe Services User dialog box displays.

To change the SQL Authentication password, use the Scribe InternalDB.exe utility. Changing the password in SQL Server may cause the TIBCO Scribe Insight server to stop working.


https://help.scribesoft.com/scribeinsight/en/#Subsystems/Insight/developer_integrate/configuring_site_security/authentication.htm


Installing Scribe Insight Server | 27

20. Do one of the following to specify how to run Scribe Services:

Run as the default user — Click Cancel.

Run as a user other than the default —

a. In User Name, enter the user name Scribe Services should run as.

This user name must match what is in the SQL database for this user. For example, if the SQL database identifies this user you want to specify as mydoman1\user1, enter mydomain1\user1 for the user name.

b. In Password, enter the password for that user.

c. In Confirm Password, re-enter the user’s password.

d. If you want, enable Log On As Service for this user, select the Grant Service Log on As Right check box.

e. Click OK. A message indicates the Services have been successfully modified.

f. Click OK. The Create Scribe Sample Database screen displays.

21. In Authentication, select the authentication method specified when installing the Scribe database earlier.

If you are using SQL authentication:

a. Verify Admin Login ID is set to sa.

b. In Admin Password, enter the administrative password for the sa account.

22. In Database Information, in Instance, verify the server where the database is located displays.

23. In Database Name, verify the correct name displays.

24. Click Database Settings to verify Insight can connect with the specified database. The Internal Database Settings dialog box displays.

25. Click OK. You return to the Create the Scribe Sample Database screen.

26. Click Next. The Database Setup Complete screen displays.

27. Click Close. The Select Registration Option screen displays.

28. Select the registration method you want to use:




Register Online —

a. Select Register online and click Next. The Serial Number Entry screen displays.

b. In Serial Number, enter the serial number you received with Insight and click Next. The Collect User Information screen displays.

c. Enter your contact information and select Keep me informed of Scribe news and specials for more information about TIBCO Scribe products.

d. Click Next. The Product Unlock Status screen displays.

e. Click Next. The Registration Complete screen displays.

Register Offline —

a. Select Register Offline and click Next.

b. Follow the instructions to contact Support to register your Insight installation with the information displayed on the screen.

c. Click Next. The Registration Complete screen displays.

Manually enter registration unlock codes —

a. Select Manually enter registration unlock codes and click Next.

b. Follow the instructions to either navigate to the registration file received from TIBCO Scribe, or enter the unlock feature codes for your Insight installation.

c. Click Next. The Registration Complete screen displays.

If you are not installing adapters as part of the Insight installation, you are not prompted to register those adapters until you next open the TIBCO Scribe Workbench.

29. If you want to install any available product updates, select the Check for product updates check box.

30. Click Finish. If you check for updates, the TIBCO Scribe update site displays. Otherwise, you return to the TIBCO Scribe Insight Setup screen.

31. Configure Scribe before you begin to use it. The configuration steps are described in Chapter 4, Configuring TIBCO Scribe Insight, on page 33.


Schema Validation Of Scribe Internal Database | 29

Schema Validation Of Scribe Internal Database

After the TIBCO Scribe Insight installation or update procedure finishes, the Schema Validator utility runs to validate the Scribe Internal Database and verify it has no errors or problems.

If any error is returned, have the following files available and contact Support for help:

• DBSchemaValidator.log — Error log file generated by the validation procedure.

• DBValidatorSchema.xml — Current database schema file.

When you validate the schema, the following results may occur:

• Scribe Internal Database is valid — The following success message is returned: The Scribe Internal Database was validated.

Click OK to exit.

• Scribe Internal Database is not valid — An error message similar to the following is returned:4 Errors were found.

Click OK to review the error log.

• Schema Comparison file cannot be located or is corrupted — An error message similar to the following is returned:Error: Schema comparison file was not found.

Expected: C:\ExampleDir\ExampleSubDir\ScribeInternalSchema_7.7.0.xml

Click OK to exit the error.

• Undefined error occurs — An error message similar to the following is returned, indicating an error such as a SQL error, occurred:Error: Login failed for user ‘Smith’.

Click OK to exit the error.



Installing Adapters

TIBCO Scribe Adapters are optional programs that allow you to seamlessly integrate data from a number of different sources. For detailed information about adapters, see the online help for each adapter. You can find help for all adapters in the TIBCO Scribe Insight Help Library.

Before You Begin

Installing Adapters With The TIBCO Scribe Insight Setup Wizard1. Run Setup.exe to open the TIBCO Scribe Insight Setup Wizard.

2. Select Insight Adapters.

— If you are installing adapters with TIBCO Scribe Insight — The Adapter Installation window displays after TIBCO Scribe Insight is installed.

— If you are installing adapters separately from TIBCO Scribe Insight — Select the Adapters check box from the TIBCO Scribe Insight Setup Wizard. When you click Start Installation, the Adapter Installation window displays.

3. Select the adapter(s) you want to install and click OK.

4. Follow the instructions for the Setup Wizard for each adapter. If you are installing multiple adapters, each Setup Wizard will start as soon as the previous installation is finished.

5. When you have finished, click Exit to close the TIBCO Scribe Insight Setup Wizard.

Uninstalling Adapters With The TIBCO Scribe Insight Setup Wizard1. From the TIBCO Scribe Insight Setup window, select Insight Adapters and

click Start Installation.

Note for Microsoft Dynamics AX and Microsoft Dynamics NAV users: The TIBCO Scribe Insight adapters for Microsoft Dynamics AX and Microsoft Dynamics NAV require that you install two components. For information about installing the Adapters for Dynamics AX or Dynamics NAV, see the online help for the adapter, which is available online in he TIBCO Scribe Insight Help Library.




Installing Adapters | 31

2. Clear the check box for the adapter you want to uninstall and click OK. A warning displays telling you that the Scribe services must be stopped before you uninstall an adapter.

3. Do one of the following:

— If any integrations are running — Click Cancel, from Administrative Tools, open Services, manually stop Scribe services, and pause any integration components.

— If you know there are no integrations running — Click OK. Insight automatically stops the services and uninstalls the adapter.

4. When you have finished, restart the Scribe services.

Clicking OK is safe only when no integrations are running.




Configuring TIBCO Scribe Insight | 33

Chapter 4 Configuring TIBCO Scribe Insight

After you install TIBCO Scribe Insight, there are several steps required before Insight will run properly. This section describes the registration, setup, and configuration steps.

Access To The TIBCO Scribe Console

The Scribe Console Users group is a Windows OS group that is created during the TIBCO Scribe Insight installation and controls access to the TIBCO Scribe server through the Console. Any user who uses the TIBCO Scribe Console must be a member of the Scribe Console Users group.

• Use the Windows Computer Management administrative tool to add local and network Windows users who should have access to the TIBCO Scribe Console through the Scribe Console Users group.

• After adding users to the Scribe Console Users group, log off the computer and log back in again.

The Scribe services log on user must be in the Scribe Console Users and local administrators groups.

If your site uses a proxy server, the Scribe services log on account must have access to the internet through the proxy server.


34 | Chapter 4 Configuring TIBCO Scribe Insight

Security Access In The TIBCO Scribe Console

The Scribe Console Admins group is a Windows OS domain group that controls access to the Security Settings window of the Administration node. If a user is a member of the Scribe Console Admins group, the Security node displays in the user’s TIBCO Scribe Console tree.

Creating The Scribe Console Admins Group1. On the Active Directory system, open Active Directory Users and

Computers.

2. Right click the domain name and select New > Group.

3. Name the group Scribe Console Admins.

4. Set Scope to Global.

5. Set Type to Security.

6. Click OK.

7. Add users to the Scribe Console Admins group, log out, and log into the computer.

Site Security

The TIBCO Scribe Console provides access to the file system, MSMQ Message Queuing, and local services. By default, access is not permitted to any of these resources. Access is only granted by exposing the resources on a per item level using the Security node. The Security node is available under the Administration) node when the Console is running as a local connection on the computer that hosts the TIBCO Scribe Insight server.

The domain user must be a member of the Scribe Console Admins group.

You must have TIBCO Scribe Insight administrator privileges to create the Scribe Console Admins group or to add users to this group.

To access the TIBCO Scribe Console, members of this group must also be members of the Scribe Console Users group.


Site Security | 35

Setting File Management SecurityFile Management security controls access to your local file system for all users and processes. Exposing folders to the Console allows you to browse, move, rename, and delete files and folders.

1. From the TIBCO Scribe Console, click your Insight Server.

2. Expand Administration, then click Security. The Security Settings window displays.

3. On the File Management tab, select Provide access to SELECTED folders on this server.

4. In the All Folders list, navigate to the Users\Public\Documents\Scribe folder and add the following folders to the Console Shared Folders list:

— Collaborations

— Samples

— Templates

— Tracing

— Event file locations for any Integration Processes (IP)

— Application path (the location of pre/post programs used in IPs)

— Any other folders that you wish to share across Collaborations

5. When you have finished, click Save.

The default Application path is \Program Files\Scribe\Utilities. To change the Application path, select and right-click the Integration Servers node for your server, click Properties, and change the path in the Integration Server Properties box.

When you configure File Management security, if a Universal Naming Convention (UNC) and a physical path appear in the All Folders dialog box, select the UNC. For example, if \\[computer name]\C\Temp and C:\Temp display, select \\[computer name]\C\Temp. When you return to the Console, only the file name displays. This is expected behavior.



Setting Services SecurityServices security controls the services you are allowed to use. When you expose a service to the Console, you can start, stop, pause, resume, or view the status of the service. The AdminServer service cannot be stopped or started from the console.

1. In the Services tab, move the five Scribe services from the All Services list to the Shared Services list:




— Scribe MessageServer



Setting Message Queue Security (Optional)Message Queue security restricts access to queues. The Console includes a queue browser, which requires the three default queues created during the installation be enabled. This task is only required if your site is using message queues.

1. On the Message Queues tab, move the three Scribe queues from the Known Message Queues to the Shared Message Queues:

— ScribeDeadMessage

— ScribeIn

— ScribeRetry



Creating Alert Recipients And Groups | 37

Creating Alert Recipients And Groups

By default, TIBCO Scribe Insight sends alerts to members of the DB Admin and System Admin groups. To use email notifications when TIBCO Scribe Insight server errors occur, create at least one alert recipient, add users to the groups, and configure email server settings. Configure at least one Recipient to be notified for critical errors and errors, and configure the Administrator to receive email notifications for alerts.

The TIBCO Scribe Insight server generates alerts at the following levels of severity:

• Critical errors

• Errors

• Warnings

• Info (informational) messages

Configuring Notification Groups1. In the TIBCO Scribe Console, expand the Administration node and select

Alert Recipients. The Alert Recipients tab displays.

2. Click Add to display the Add Recipient window.

3. In Recipient name, enter the user name to receive notifications.

4. Enter the First name, Last name, and Full name.

5. Optionally, add a Description for this user.

6. Click the Notification tab.

7. Enter at least one of the following contact methods: email address, pager address, or Net Send.

8. For each method specified, select the level of notification for which this user should be contacted.

9. Click Apply to add the recipient.

10. Click the Groups tab and add this recipient to the DB Admin and System Admin groups.

Send critical error and error alerts to a user who monitors the email address.



11. The Groups tab is not active until the General tab has been completed.

12. Click OK.

Configuring Site Settings

Use Site Settings to set parameters for the entire TIBCO Scribe Insight server.

Changing The Collaboration Root LocationThe default location for the Scribe Insight server files is C:\Users\Public\Public Documents\Scribe\Collaborations. If you change the default location:

• Select a location is centrally accessible if you have multiple Scribe workstations

• Use the UNC naming convention

• Be sure this folder will be regularly backed up

To set the collaboration root location:

1. In the TIBCO Scribe Console, expand the Administration node and select Site Settings. The Site Settings window displays.

2. On the General tab, change the Collaborations root to Users\Public\Documents\Scribe\Collaboration .

3. If you are using message queuing, verify that the Site Main Queues are correct.

4. Select the Copy system Alerts to the Event Log check box.

5. Click Save to save your changes.

To send DB Admin alerts to one recipient and System Admin alerts to another recipient, create two recipients, and add each recipient to a separate group.


Configuring Site Settings | 39

Configuring E-mail SettingsConfigure e-mail settings for the mail server used to distribute the outgoing alerts. Enter values for each of the enabled fields in SMTP Configuration (outbound). Some fields will be unavailable depending on the Login Method you select.

1. In the TIBCO Scribe Console, expand the Administration node and select Site Settings. The Site Settings window displays.

2. Click the Email Settings tab.

3. In the SMTP Configuration section, in From, enter the sender’s name as it should appear for alerts.

4. In SMTP mail server, enter the name of the server to send these alerts.

5. In Account Name, enter the SMTP account used to authenticate this email address.

6. In Password, enter the password for the outbound SMTP account.

7. In SSL (Secure Sockets Layer) specify the secure link that supports an encrypted data stream. You may need to set an authentication method along with a username and password to be used when authenticating. See Selecting And Preparing An Authentication Method on page 15.

8. Click Test Send to verify the SMTP configuration. The TIBCO Scribe Insight server sends a test email to the address entered in the From address field.

9. In the confirmation dialog, click OK, then click Save.

10. Open your e-mail program to view the test message.

Configure email settings so recipients such as the Administrator will receive email alerts.

POP3 configuration is required only if your site uses the Email Bridge feature.



Setting The Sleep PeriodThe Scribe Internal database files and the Collaboration root folder must be backed up regularly. Since most backup operations lock files during the backup process, use the Sleep Period tab to specify the time period during which the server is backed up. During this period, all Integration Processes and Monitors are disabled.

To set the sleep period:

1. On the Sleep Period tab, select the Enable sleep range check box.

2. Enter Start Time and End Time for the sleep period.

3. Click Save.

Starting The Notification MonitorOn initial setup, the Notification Monitor and all other monitors are Paused. The Notification Monitor sends e-mail notifications to the alert recipients.

1. From the General tab of Site Settings, click the Resume button.

2. The Notification Monitor is set to Active (and the button name changes to Pause).

Start and end times should encompass regular maintenance times.


Managing Other Monitors | 41

Managing Other Monitors

Starting The MonitorsDuring TIBCO Scribe Insight server installation, a number of TIBCO Scribe system monitors are installed. After starting the Notification Monitor, start the individual system monitors.

To start the remaining monitors:

1. Expand the Integration Server node and select Monitoring. The Monitoring window displays.

The system monitors have an owner named System.

2. Select each system monitor and click Resume (or right click and select Resume).

If you receive too much information with all monitors on, you can pause some of the monitors.

Adding a ScribeIn Queue MonitorIf your site uses Message Queues, you may create an additional ScribeIn Queue monitor. A monitor on the ScribeIn Queue can track that status of messages in the queue. These messages should be picked up and processed by an Integration process within a matter of seconds. If there are messages in the ScribeIn queue that are older than an hour, there may be a significant failure which needs to be addressed.

Create the new monitor from Monitoring under the Integration Server node.

1. In the TIBCO Scribe Console, expand the Integration Server node and select Monitoring. The Monitoring window displays.

2. Click Add. The Add new Monitor screen displays.

3. On the Step 1: General Settings tab, in Monitor Type select Queue.

4. In Monitor Name enter ScribeIn Queue Detail.

5. Click Step 2: Source Connection.

6. Verify Scribe Input Queue is selected.

7. Click Step 3: Alert Criteria.

Always leave Fatal Errors Detail and Rejected Rows Detail monitor on.



8. Configure the alert based on one of the following alert criteria:

— Number of messages in the queue — In Message count in queue greater than, enter a number appropriate for your site, such as 50. This number depends on the environment for which the integration is being developed.

— Length of time messages have been in the queue — In Message duration in queue greater than, select a number and a period that are appropriate for your site, such as 1 Hour(s).

9. Click the Browse button to select the Recipient or Group to Alert.

10. In Available Recipient Groups, select a group and click OK.

11. Click Step 4: Monitor Interval.

12. In Frequency, set Monitor to every 15 minutes.

13. Click Step 5: Activation.

14. In Status select Active.

15. Click Step 6: Alerting:

16. In Alert Type, select Critical.

17. In Alert description, enter a meaningful description (such as ScribeIn Queue Alert).

18. In Alert message, enter a meaningful message.

19. Click Finish. The new Monitor displays in the table as a User monitor.


Scribe Services User | 43

Scribe Services User

If you did not specify a user for Scribe Services during the installation, all Scribe services are set to run logged in as Local System account. The system account exposes all local resources but does not allow you to use any resources on other computers on the network.

We suggest you create a Windows account to be used by the Scribe services. This account can be set up with the necessary access on the local computer and on other computers on the network. After you create this account, change the properties on the Scribe services to log on as this account. The Scribe services operate in the security context of this restricted account.

If the Scribe processes need access to remote file servers or a network system — for example, if the collaboration root or event files are located on another server — you must set up a specific user account that has access to the remote files and run the Scribe services under this user.




Installing TIBCO Scribe Workstation | 45

Chapter 5 Installing TIBCO Scribe Workstation

TIBCO Scribe Workstation allows you to install the TIBCO Scribe Console and TIBCO Scribe Workbench on a workstation that can connect to the Insight server. After you install Insight server, install TIBCO Scribe Workstation on other computers and connect to the Insight server.

Install Scribe Workstation

1. Open the Scribe folder and click Setup.exe. The TIBCO Scribe Insight Setup Wizard displays.

2. Verify the following are installed and appear checked in gray:

— Microsoft Windows Installer displays

— Microsoft .NET Framework

— Microsoft SQL Server Express 2017 (Optional) for x64 operating systems

3. Select Install Insight and click Start Installation. A message about using Microsoft SQL Express for the Internal Database displays

4. Click Yes or No, as appropriate for your installation. The Welcome to the Setup Wizard for Scribe Insight screen displays.


6. Read the terms of the license agreement, and click I accept the terms in the license agreement.

7. Click Next. The Product Selection and Destination screen displays.

When you install TIBCO Scribe Workstation, you must:

• Use Universal Naming Convention (UNC) for all paths.

• Verify all workstations are running the same version of TIBCO Scribe Insight.

• Verify all prerequisites have been met. See Chapter 2, Installation Prerequisites, on page 5.


46 | Chapter 5 Installing TIBCO Scribe Workstation

8. Select Insight Workstation and click Next. The Ready to Install the Program screen displays.

9. Click Install. When the installation finishes, the Setup Wizard Completed screen displays.

10. Click Finish. The Database Setup dialog box displays.

11. Specify the database to use with the TIBCO Scribe Workstation installation:

— Create a Scribe Internal Database on SQL Server — Select this option if you are creating a new Scribe Internal Database or repopulating an existing database. This is the default.

— Connect to an existing Scribe Internal Database on SQL Server — Select this option if you are reusing an existing Scribe Internal Database, upgrading a database, or connecting to a database on another workstation or a node in a failover cluster.

12. Click Next.

— Creating a new database — The Create the Scribe Internal Database on SQL Server screen displays:

— Connecting to an existing database — The Select an existing Scribe Internal Database for use screen displays.

13. Specify the authentication information:

— Creating a new database

To use a network login ID, select Windows authentication.

To use a SQL Server login ID and password, select SQL Server authentication and specify the Admin Login ID and Password.

— Connecting to an existing database

To use a network login ID, select Windows authentication.

To use a SQL Server login, select SQL Server authentication and either enter the SCRIBE Password for the database or select Use default.

14. Specify in Instance (Server) the location of the database server, either by selecting the location or typing the UNC path for the database, for example: MY_SERVER\DB_NAME.

15. Enter or verify the Database Name is correct.

16. Test the connection:

— Creating a new database — Click Database Settings.

— Connecting to an existing database — Click Test Connection.


Install Scribe Workstation | 47

If all the settings you specified are correct, the Internal Database Settings dialog box displays. Otherwise, an error displays and you must resolve the error to continue.

17. Click OK. You return to the Scribe Internal Database on the SQL Server screen.

18. Click Next. A message displays that the Scribe Internal Database was validated.

— An SQL user exists on the SQL Server — A message displays noting this process resets that user’s password to integr8!. Click Yes to continue.

— Repopulating an existing database — Another message may appear, noting that any content in the database is to be overwritten. Click Yes to continue.

19. Click OK. A message displays that the Scribe Internal Database indexes were validated.

20. Click OK. The Create Scribe Sample Database dialog box displays.


— Skip creating a Scribe Sample Database — Click No. The Select Registration Option screen displays.

— Create the Scribe Sample Database

a. Click Yes. The Create the Scribe Sample Database on SQL Server dialog box displays.

b. Under Authentication, specify the Admin Password that was specified when you created the Scribe Database.

c. Verify the Database Information is correct.

d. Click Database Settings. The Sample Database Settings dialog box displays.

e. Click OK. You return to the Scribe Sample Database setup dialog box.

f. Click Next. The Database Setup is Complete screen displays.

g. Click Close. The Select Registration Option screen displays.

22. Select the registration mode for your TIBCO Scribe Workstation installation:




— Online

a. Click Register Online and click Next. The Serial Number Entry screen displays.

b. In Serial Number enter the serial number of your installation and click Next. The Collect User Information screen displays.

c. Enter the contact information for the primary user.



f. Click Finish. If you are installing Scribe Adapters, the Adapter Installation screen displays.

— Offline

a. Click Register Offline and click Next.

b. Use the information in the text box to either browse to the specified web site and paste the information or call Support.

c. Click Finish. If you are installing Adapters, the Adapter Installation screen displays.

— Manual

a. Click Manually enter registration unlock codes and click Next.

b. Enter in the Code column the Unlock Code and any Feature Code you received from TIBCO Scribe or use a Registration File to enter the information.

c. Click Next. The Serial Number Entry screen displays.

d. In Serial Number, enter the serial number of your installation and click Next. The Collect User Information screen displays.

e. Enter the requested primary user information and click Next. If you are installing Adapters, the Adapter Installation screen displays.


Install Scribe Insight Adapters | 49

Install Scribe Insight Adapters

You can install Insight Adapters as part of the TIBCO Scribe Insight installation or as a separate installation.

1. If you are installing adapters separate from TIBCO Scribe Insight, open the Scribe folder, and click Setup.exe. The TIBCO Scribe Insight Setup window displays.

2. Select Insight Adapters and click Start Installation. The Adapter Installation screen displays.

3. For each adapter you want to install, select the Install check box.

4. Click OK. The Welcome screen of the installation wizard for the first adapter displays.

5. Click Next. The Ready to Install the Program screen displays.

6. Click Install. The adapter Setup Wizard Completed screen displays.

7. Click Finish. If you are installing other adapters, on the adapter Welcome screen, click Next and follow the prompts to complete the installations. Otherwise, you return to the TIBCO Scribe Insight Setup window. Click Exit.

For information about installing adapters, see Installing Adapters on page 30. You need to install the same adapters on the TIBCO Scribe Insight Server and TIBCO Scribe Workstation.



Connect To The Scribe Database

1. From the Scribe Database Setup Wizard, select Connect to an existing Scribe Internal database on SQL Server, and click Next.

2. Enter the database server and database name you used when creating the Scribe Internal database.

3. Select the authentication mode for SQL Server. See Selecting And Preparing An Authentication Method on page 15. If you are using SQL Server authentication, use the default.

4. Click Test Connection to validate the connection to the database is live.

5. After validating the connection, click Next. An informational message displays.

6. Click OK.


— Click Finish to finish the Scribe Workstation installation.

— Click Exit to close the Scribe Insight Setup Wizard without completing the installation.

Adding The Scribe Console Users Group On The Server

The Scribe Console Users group includes all users who have access to the Scribe Console. Any user who needs access to the Console must be a member of this group.

1. In Control Panel, double-click Administrative Tools. The Administrative Tools window displays.

2. Double-click Computer Management. The Computer Management window displays.

3. Expand System Tools, expand Local Users and Groups, and select Groups. The defined groups display.

4. Double-click Scribe Console Users and add users who will be using the TIBCO Scribe Console.


Configuring DCOM Access | 51

Configuring DCOM Access

If the TIBCO Scribe Workstation and TIBCO Scribe Console are on different systems, you must modify the DCOM access to the following Scribe services for each user who is a member of the Scribe Console Users group:

• Scribe AdminServer

• Scribe BridgeServer

• Scribe EventManager

• Scribe MessageServer

• Scribe MonitorServer

If you have issues connecting the remote console to the Insight server, see this article: How to Configure the Firewall to Allow DCOM Connections.

Create The Scribe Console Admins Group

You only need to create the Scribe Console Admins Group if any Scribe Admin users require remote access. You must have Administrative privileges to create this group.

For information on creating the Scribe Console Admins Group, see Access To The TIBCO Scribe Console on page 33.


https://campus.barracuda.com/product/archiveone/doc/46206124/how-to-configure-the-firewall-to-allow-dcom-connections/



Upgrading TIBCO Scribe Insight | 53

Chapter 6 Upgrading TIBCO Scribe Insight

When you upgrade TIBCO Scribe Insight, some tasks depend on the version you are running.

The upgrade process includes:

• Preinstallation tasks

• Installing TIBCO Scribe Insight

• Installing Adapters

• Updating the Scribe Internal Database

• Registering TIBCO Scribe Insight

• Verifying user accounts

Preinstallation Tasks1. Pause all Publishers and any Integration Processes.

2. In the TIBCO Scribe Console, select Actions > Import/Export Wizard to export the Scribe Package.

3. Review the following log files to determine if they contain a large number of records:

— AlertLog

— ExecutionLog

— TransactionErrors

— Any rejected row tables

If these log files contain a large number of records, run ScribeMaintenance.sql, in the folder where Insight is installed.

If your Scribe Internal database contains a large number of historical records and you receive a message about index errors during the upgrade, use SQL Server Management Studio to run the Program Files (x86)\Scribe\ScribeInternal_Upgrade_790_to_791.sql script against the Scribe Internal database and manually create the indexes.


54 | Chapter 6 Upgrading TIBCO Scribe Insight

4. Contact your Database Administrator about backing up the Scribe Internal Database.

5. Make a copy of the Collaborations folder. By default, this folder is located in the C:\Users\Public\Public Documents\Scribe folder.

6. In TIBCO Scribe Workbench, select Help > About.

7. Select and copy the Serial Number value.

8. Open a blank Notepad document and paste the value.

9. Select Help > Unregister this Computer and click Yes.

10. Do the following, as necessary:

— Updating Insight from 7.6.1 or earlier — Verify UAC is disabled.

— Running an adapter that requires Windows Identity Foundation (WIF) — For Windows Server 2012 enable/Install WIF 3.5 via Features.

— Running WIF — Verify Microsoft .NET Framework 3.5 is installed. If it is not, for Windows Server 2012 enable/Install .NET 3.5 Framework via Features.

— Using the Dynamics AX, Dynamics CRM, Dynamics GP, Dynamics NAV, or Query Publishers — Install Microsoft Message Queuing (MSMQ).

Install Insight And Adapters

1. Download the TIBCO Scribe installer from eDelivery.

If you use Windows authentication, log in as a Windows domain user that is a SQL Server principal with dbcreate rights.

2. Unzip the installer on your system.

If the MSMQ Windows component is not installed, a message displays during the TIBCO Scribe Insight installation stating it is not installed. MSMQ is not installed as part of the TIBCO Scribe Insight installation. You must install it separately.

With MSMQ, your machine name must be no longer than 15 characters.

If an error occurs stating WIF is not installed when you are installing Dynamics CRM adapter, but WIF is installed, open a Command Prompt and run ScribeAdapterForMicrosoftDynamicsCRM.msi.

To update from TIBCO Scribe Insight 6.4.0 or earlier, uninstall Insight.




3. From the unzipped installer files, double-click Setup.exe. The TIBCO Scribe Insight Setup window displays.

4. Verify the following prerequisites are installed:

— Microsoft Windows Installer 3.1

— Microsoft .NET Framework 4.0

— Microsoft .NET Framework 4.5.2 (Systems requiring TLS 1.2 only)

— Microsoft .NET Framework 3.5 (Windows 2012 only)

— Microsoft SQL Express 2017 (optional)

5. Select the Insight Installed – Upgrade and Insight Adapters check boxes.

6. Click Start Installation. The Setup Wizard Welcome screen displays.


8. Select I accept the terms in the license agreement and click Next. The Ready to Install screen displays.

9. Click Install. When the installation finishes, the Setup Wizard Completed screen displays.

10. Click Finish. A message that the Scribe Internal Database was validated displays.

11. Click OK. A message that Scribe Internal Database indexes were validated displays.

12. Click OK. The Select Registration Option screen displays.



13. If you are upgrading from Insight 7.9.0, the Scribe Services User dialog box displays. Do one of the following:

— Run the Scribe Services as the default user — Click Cancel. The Select Registration Option screen displays.

— Run the Scribe Services as a user other than the default:

a. In User Name, enter the user name Scribe Services should run as. By default, the name of the user currently configured for Scribe Services displays.

This user name must match what is in SQL. For example, if the SQL database identifies this user as mydoman1\user1, enter mydomain1\user1 for the user name.



d. If you want enable Log On As Service for this user, select the Grant Service Log on As Right check box.

e. Click OK. A message indicates the Services have been successfully modified.

f. Click OK. The Create Scribe Sample Database screen displays. The Select Registration Option screen displays.

14. In Authentication, select the authentication method previously specified for the Scribe database.

If you are using SQL authentication:

a. Verify Admin Login ID is set to sa.

b. In Admin Password, enter the administrative password for the sa account.

15. Click OK. The Select Registration Option screen displays.

16. Select the registration option, click Next, and follow the prompts until the Registration Complete screen displays.

17. Click Finish. You return to the TIBCO Scribe Insight Setup window.

18. Click Exit.



Install Adapters SeparatelyIf you only installed Insight, you can install the TIBCO Scribe Adapters separately.

1. Run Setup.exe.

2. Select Insight Adapters in the TIBCO ScribeSetup Wizard.

3. Click Start Installation. The Adapter Installation window displays.

4. Select the adapter(s) you want to install and click OK.

5. Follow the instructions in the Setup Wizard for each adapter.

If you are installing multiple adapters, each Setup Wizard runs.

Updating The Scribe Internal Database1. If the Scribe Internal Database will remain on the current server, choose the

option to upgrade the existing DB.

2. If the Scribe Internal Database is being restored to a new server, or you are using SQL authentication and a Scribe user exists in SQL:

a. Choose the option to install a new Scribe Internal Database.

b. Restore the existing Scribe Internal Database to the new SQL Server.

c. If Scribe Schema errors occur after restoring the database, run the SQL:ALTER USER Scribe WITH LOGIN = Scribe

3. Run Program Files (x86)/Scribe/InternalDB.exe, then run the Update Database option.

Post-Installation Tasks1. If Insight was installed on a new server, correct the server references in the

Scribe Internal Database:

a. Run Program Files (x86)/Scribe/InternalDB.exe and perform a Test connection.

b. Specify the option to change the server name, and provide the old and new Insight server names.

2. Register Insight through the Workbench.

If WIF is installed and an error states WIF is not installed when you are installing Dynamics CRM adapter, open a Command Prompt and run ScribeAdapterForMicrosoftDynamicsCRM.msi.



3. If you have issues registering Insight, run ClearScribeLicense.sql, found in the folder where Insight is installed.

4. Verify the Scribe services LogOn user is a domain account that belongs to the local Administrators and Scribe Console Users groups.

5. Restart the Scribe Services.

Perform any post-installation steps required for the Adapters you have installed. See the Help file for those steps. For example:

— Dynamics GP – Run metadata SQL scripts.

— Dynamics NAV – Update the FOB files, etc.

6. If you are upgrading to an X.0.0 version, such as 7.0.0, open the DTS.

Troubleshooting The UpgradeWhen upgrading Insight on a new server, some problems you may find are:

• UAC is disabled — UAC is not required for Insight 7.6.2 and later. Disable UAC, if necessary.

• Scribe Services Logon User — This user account should be a domain account that belongs to the local Administrators group and the Scribe Console Users groups.

• Server name — Verify the proper server name is in the various fields for the IntegrationServers, Ksync, and Monitors tables. If not, add the server name using InternalDB.exe ().

• Ksync table path — Verify the Path is correct in the Ksync table (CollaborationsRoot - KEYVALUE).

• Windows Authentication — If you are using Windows Authentication for the Scribe Internal database, verify the service logon user is db_owner and that user has permissions for the Scribe Internal database.

• ClearScribeLicense — Run ClearScribeLicense.sql and reregister in the Workbench.


Installing Insight With Windows Authentication | 59

Chapter 7 Installing Insight With Windows Authentication

Depending on your requirements, you may decide to set up TIBCO Scribe Insight to use Windows Authentication for controlling access to the Scribe Internal database.

The high-level steps for installing Insight with Windows Authentication are:

1. Before installing Insight, set up a principal in SQL Server that has the proper rights.

2. Log in as that principal and install TIBCO Scribe Insight.

3. When you create the Scribe Internal database, select Windows authentication.

4. In SQL Server, set up all principals that will be using Insight.

5. Edit the Scribe services properties to log on as a principal with proper rights.

Setting Up A Principal With Database Create Privileges

In SQL Server, set up a principal that has the privileges to create a database. When you install Insight, you will log in as this principal.

Using the SQL Server pre-defined role, dbcreator, for this purpose is recommended. See your SQL Server documentation for information about adding Windows users to SQL Server.


60 | Chapter 7 Installing Insight With Windows Authentication

Installing Insight With Windows Authentication

This section describes the steps that differ from installing TIBCO Scribe Insight with SQL Server authentication.

1. Log in as the Windows domain user you set up as the principal in SQL Server in the previous steps.

2. Verify this user is in the local Administrators group on the server where you install Insight.

3. Run Setup.exe to start the TIBCO Scribe Insight Installation wizard.

4. Follow the installation steps, as described in Installing Scribe Insight Server on page 25.

5. When prompted to create the Scribe Internal Database, select Windows authentication using the network login ID.


Setting Up Principals That Use Insight | 61

Setting Up Principals That Use Insight

When the Workbench or Console starts, it connects to the Scribe Internal database. If you are using Windows Authentication, you must set up principals in SQL Server for each Windows user who uses Insight and set up a principal for Scribe services. These principals authenticate the users and allow them to access the Scribe Internal database.

To add a principal with proper access to the Scribe Internal database:

1. Open SQL Server and verify the principal is associated with the Scribe Internal database (SCRIBEINTERNAL).

2. Verify the principal has the following permissions to the SCRIBE schema in the Scribe Internal database:

— Select

— Insert

— Update

— Delete

— Execute

— Alter

3. Verify the principal has access to other resources required by Insight, such as MSMQ, .dts files, and so on.

You can use the SQL Server predefined role, dbowner, to simplify this process. See your SQL Server documentation for more information about granting permissions to a schema.


62 | Chapter 7 Installing Insight With Windows Authentication

Editing Scribe Services Properties

Scribe services enable Insight to run when no one is logged on to the integration server. When these services are installed, they are configured to log on as the local system account. With Windows Authentication, the services must log on as a Windows principal with privileges to access the Scribe Internal database.

To edit the properties of the Scribe Services:

1. In the Windows Services applet, right-click the Scribe AdminServer service and click Properties.

2. Click the Log On tab.

3. Edit the properties so the service logs on as the principal you set up. Click OK.

4. Repeat these steps for following services:






Configuring A Failover Cluster | 63

Chapter 8 Configuring A Failover Cluster

Failover allows a group of servers to maintain a high availability of the TIBCO Scribe Insight Application and Services. You can configure failover for:

• Scribe Internal Database — Configuring failover for the Scribe Internal Database preserves only the database and does not include DTS information.

• Insight — Configuring failover for TIBCO Scribe Insight preserves the Scribe Internal Database, as well as DTS information. Options include:

— Hyper-V clustering

— Application-based failover

— Mixed-mode clustering

The method you use choose depends on your site requirements.

Scribe Internal Database FailoverIf you are configuring a SQL AlwaysOn for the Scribe Internal Database, you must configure the ODBC connection on the primary server:

1. In the Scribe install directory, run InternalDB.

2. Edit the ODBC connection, Internal Database Data Source Name:

— Point to the IP address of the Availability Group Listener

— Set the default database to SCRIBEINTERNAL

When SQL AlwaysOn is configured:

• Timed & File IPs:

— Failover between jobs — The services stop and start on their own. The next timed run succeeds without any negative side effects.

— Failover during a job managed by the SERIAL processor group — The services stop while the job is running. The MessageProcessor handling the current IP execution successfully finishes the job and attempts to write the

TIBCO Scribe failover is only available with Professional and Enterprise licenses.


64 | Chapter 8 Configuring A Failover Cluster

results to the Execution Log, but fails to do so. Although the job did finish successfully, it displays as Incomplete in the Execution Log Viewer.

— Failover during a job managed by the DEFAULT processor group or a user-defined process group — The services stop while the job is running. The MessageProcessor handling the current IP execution does not move the generated message out of the ScribeIn queue. After the services resume after the failover, the message is processed a second time, this time being marked as successful in the Execution Log. This may cause problems because a job intended to run only once runs twice.

• Queue IPs — Failover during a job causes the services to stop while the job is running. The MessageProcessor handling the current IP execution does not move the generated message out of the ScribeIn queue. After the services resume after the failover, the message is processed a second time, this time being marked as successful in the Execution Log. This may cause problems because the job runs twice, when it was intended to run only once.

• Publishers

— Failover between retrieving messages causes the services to stop and start on their own. The next timed run succeeds without any negative side effects.

— Failover during retrieval causes one of the following to occur:

The message remains in the ScribePublisher queue and is picked up next polling cycle.

The message remains in the PubIn queue Insight requeries for the message after the failover.

The message is moved to the PubFailed queue and must be manually moved into the PubIn queue.

A File IP set to delete the trigger file after execution does not do so, because the Execution Log was not updated and the job was not marked as complete.



Hyper-V ClusteringHyper-V Clustering for TIBCO Scribe Insight requires a two-node Windows Failover Cluster with Hyper-V installed and is supported on Windows Server 2012 and later.

The advantage of using Hyper-V clustering is the ease of setup and management: you install only one instance of TIBCO Scribe Insight on a Virtual machine that can failover between the two Hyper-V cluster nodes. TIBCO Scribe Insight remains up as long as one of the servers in the cluster is up.

Figure 1 Hyper-V Cluster



With Hyper-V clustering, you must allow for downtime during maintenance, because there is only one instance of Insight running.

Figure 2 Hyper-V Cluster During Failover

Before you set up Insight, the Hyper-V role must be installed and the Windows Failover Clustering feature must be configured by your IT Administrator and validated.

For more information, see:

• Failover Clustering Overview — https://technet.microsoft.com/en-us/library/hh831579.aspx

• Hyper-V Overview — https://technet.microsoft.com/en-us/library/hh831531.aspx

• Microsoft Virtualization — http://www.microsoft.com/en-us/server-cloud/solutions/virtualization.aspx


https://technet.microsoft.com/en-us/library/hh831579.aspx

https://technet.microsoft.com/en-us/library/hh831531.aspx

http://www.microsoft.com/en-us/server-cloud/solutions/virtualization.aspx


Application-BasedApplication-based failover requires two servers in a Windows Failover Cluster and is supported on Windows Server 2012 and later.

In your Application-based failover, one server actively runs Insight Applications and Services while the other server is in standby mode, waiting to take over in case a server fails.

Figure 3 Application-Based Failover Cluster In Standby

The advantage of using Application-based failover is there is no down time when a server fails or when performing maintenance, such as Insight upgrades, patches, or operating system updates.

Figure 4 Application-Based Failover Cluster During Server Failover



Mixed-Mode ClusteringIdeally, the failover setup is a combination of Application-based and Hyper-V Clustering, or Mixed-Mode Clustering, which uses two nodes, each of which uses Hyper-V to provide additional redundancy during a hardware or Hyper-V failure, a maintenance period, or any other down time that may occur in your environment.

To use a mixed-mode clustering:

• Install and configure Hyper-V clustering on two images.

• Set up each image to act like a node in the application-based failover, where one node is active and the other is in standby mode.

• Following the application-based steps, set up the services, MSMQ, and other requirements outside of the Hyper-V images.

Configure An Application-Based Failover Cluster

In a Windows Server 2012 environment, TIBCO Scribe Insight can be configured for high availability with Microsoft Clustering Services. A TIBCO Scribe Insight failover cluster displays as a single TIBCO Scribe Insight server instance and can access shared MSMQ queues, a shared disk, as well as Scribe services or an overview of failover clusters, see the Microsoft article, Failover Clustering Overview.

To learn more about configuring a Microsoft failover cluster in Windows Server 2012, see the MSDN article, Creating a Cluster in Windows Server 2012.

Before you use failover, verify UAC is not enabled.


https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/hh831579(v=ws.11)

https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/hh831579(v=ws.11)

https://blogs.msdn.microsoft.com/clustering/2012/05/01/creating-a-windows-server-2012-failover-cluster/

Configure An Application-Based Failover Cluster | 69

Example: Two-Node Clustered EnvironmentThe following example is a high-level architecture of a Windows Server 2012, showing a two-node clustered environment where TIBCO Scribe Insight is installed on a Virtual Image and stored on an Internet Small Computer System Interface (ISCSI) resource drive, which is exposed as a SAN to the clustered servers. These servers have private networks to connect to their resource.

Figure 5 Example: Two-Node Clustered Environment

Configuration OverviewInstalling Scribe in a Windows 2012 failover cluster environment involves:

• Installing And Configuring TIBCO Scribe Insight On Node 1

• Installing And Configuring TIBCO Scribe Insight On Node 2

• Moving And Testing The TIBCO Scribe Insight Cluster



Prerequisites• The Microsoft Cluster Server is installed and configured.

• The TIBCO Scribe Insight failover cluster must include:

— Domain account to administer the cluster.

— Two Windows Server 2012 failover cluster nodes.

— Network name for the TIBCO Scribe Insight failover cluster instance.

— IP address.

— Shared Cluster disk for the Scribe Collaboration folder. We recommend that this be a different disk than the Cluster Quorum disk.

— MSMQ. Insight does not install MSMQ.

If MSMQ is not installed, a message displays during the Insight installation. You must install it separately.

If MSMQ is installed, your machine name can be no longer than 15 characters.

• To use SQL AlwaysOn, configure an Availability Group, Availability Group Listener, and replica SQL nodes.

• Windows Authentication for SQL Server must be configured. See Installing Insight With Windows Authentication on page 60.

• You must:

— Have access to an existing failover cluster that has been properly configured and validated with Microsoft's Validate a Configuration wizard.

— Be a member of the Scribe Console Admins group.

— Have SQL Server permissions to grant Scribe Internal Database datareader and datawriter privileges to the Scribe Console Users Group Active Directory group.

— Have privileges to install on the servers and configure the cluster to work with Insight.

— Know the Windows Service Account for the Cluster Service. This account must have datareader and datawriter privileges to the SCRIBEINTERNAL


Installing And Configuring TIBCO Scribe Insight On Node 1 | 71

database, and must be added to the Scribe Console Users group, the Scribe Console Admins group, and the Scribe Internal database.

— Create a Scribe Service domain user account to run Scribe Services with:

Local Administrator privileges on both server nodes of the cluster.

Membership in the Scribe Console UsersGroup (created during installation).

— Close any open RDP sessions before deploying Scribe. No RDP session can be connected to either server node.

• The user who logs on to install TIBCO Scribe Insight on Node 1 must have dbcreator privileges on the SQL Server where the Scribe Internal Database is created.

Installing And Configuring TIBCO Scribe Insight On Node 1

Before you install TIBCO Scribe Insight, the installation paths must be identical on both nodes of the cluster. For more information, see Chapter 3, Installing TIBCO Scribe Insight Server, on page 19.

Install Insight On Node 11. Log into Node 1 using an account with privileges to create the Scribe Internal

Database using Windows Authentication.

2. From the Insight Installation folder, run setup.exe.

3. Follow the directions to install all required components.

4. Click Start Installation. The Optional Components window displays.

5. Click Next without making any selections. The Ready to Install window displays.

6. Click Install to begin the installation.

7. After TIBCO Scribe Insight has successfully installed, click Finish. The TIBCO Scribe Database Setup window displays.



Configure The Scribe Internal Database On Node 11. Select Create a Scribe Internal Database on SQL Server and click Next.

2. Select Windows Authentication as the authentication method.

3. Select the Database Instance (SQL Server) Name or type it in manually.

4. Use the default database name, SCRIBEINTERNAL, or enter your own database name for the Scribe Internal Database and click Next.

5. Read and accept the Windows Authentication license agreement. Click Next.


— Click Yes to create a Sample Database for training and tutorials.

— Click No to continue without creating a Sample Database.

7. When database setup completes, click Close. The Select Registration Option screen displays.


— Run the Scribe Services as the default user — Click Cancel.

— Run the Scribe Services as another user:

a. In User Name, enter the user name Scribe Services should run as. By default, the user currently configured for Scribe Services displays. This user name must match what is in SQL. For example, if the SQL database identifies this as mydoman1\user1, enter mydomain1\user1.



d. If you want to enable Log On As Service for this user, select the Grant Service Log on As Right check box.

e. Click OK. A message indicates the Services have been modified.

f. Click OK.

If there is an existing SQL user named SCRIBE on the SQL Server, the SCRIBE user’s password is reset to the default integr8!.



9. Select the registration mode for your TIBCO Scribe Workstation installation, one of Online, Offline, or Manual.

— Online


b. In Serial Number, enter the serial number of this installation. Click Next.




f. Click Finish. Setup completes, or the Adapter Installation screen displays.

— Offline


b. Either paste the information from the text box on the specified web site or call Support with this information.

c. Click Finish. Setup completes, or the Adapter Installation screen displays.

— Manual

You must register TIBCO Scribe Insight to use the network name of the TIBCO Scribe cluster instance.

Register with a Professional or Enterprise license key that supports your clustered failover environment.





b. Enter in the Code column the Unlock Code and any Feature Code you received from Scribe, or use a Registration File to enter the information.


d. In Serial Number, enter the serial number of this installation and click Next.

e. Enter the requested primary user information and click Next. Setup completes, or the Adapter Installation screen displays.

10. If you are not installing adapters, click Exit. You can install adapters after completing the Scribe Insight installation and configuration.

Copy SQL Scripts To The Scribe DirectoryWindows 2012 Failover requires you move two SQL scripts in the default Scribe directory (C:\Program Files (x86)\Scribe\):

• For Scribe 7.0.1 or later

— The ChangeScribeServer.sql and FailoverMove.sql files are located in the ..\Program Files\Scribe\Failover\ directory.

— Copy those files from this folder into the default Scribe directory.

• For Scribe 7.0.0

— Download the following SQL scripts from Scribe Software to the default Scribe directory:

FailoverMove.sql

ChangeScribeServer.sql

Set Up the Scribe Internal Database With SQL AlwaysOn

If you are configuring a SQL AlwaysOn Scribe Internal Database, you must configure the ODBC connection on the primary server.

1. In the TIBCO Scribe Insight install directory, run InternalDB.

You must grant the Scribe Console Users Group Active Directory group datareader and datawriter privileges on the Scribe Internal Database.

ChangeScribeServer.sql already exists in the Scribe directory. Click Yes when prompted to overwrite the existing file.


http://insight.s3.amazonaws.com/scripts/FailoverMove.sql

http://insight.s3.amazonaws.com/scripts/ChangeScribeServer.sql


2. Edit the ODBC connection, listed as Internal Database Data Source Name, to:

— Point to the IP address of the Availability Group Listener

— Set the default database to SCRIBEINTERNAL

Configure Scribe Services On Node 11. From the Services applet on Node 1, right-click each of the following services

and click Properties:








2. On the General tab, set Startup Type to Manual.

3. If, during the installation, you did not set the name and password to use for the Scribe Services:

a. Click the Log On tab.

b. Select This account and enter the name and password of the Scribe Services account. For example:

4. Click OK.



Add Users To The Scribe Console Users GroupThe Scribe Service account and any other users that require access to the TIBCO Scribe Console must be registered in the Scribe Console Users Group.

1. Select Start > Administrative Tools > Computer Management. The Computer Management window displays.

2. Expand System Tools, expand Local Users and Groups, and select Groups.

3. Right-click the Scribe Console Users group and click Properties.

4. Add the Scribe Service account and any users that must access the TIBCO Scribe Console.

5. Log out and log in to Node 1 as a user in the Scribe Console Users Group.

Configure Settings In The TIBCO Scribe ConsoleYou must configure the Collaborations folder and shared messages queues.

1. Move the Collaborations folder to a shared drive, accessible by both nodes in the cluster. The default folder is C:\Users\Public\Public Documents\Scribe\Collaborations.

2. Open TIBCO Scribe Console.

3. Expand Site Name, expand Administration, and select Security.

The Scribe Services account must have datareader and datawriter access to the SCRIBEINTERNAL database.



4. On the File Management tab, move the Collaborations folder to the Console Shared Folders, and click Save.

5. Click the Message Queues tab.



6. Move the following queues to Shared Message Queues:

— ScribeDeadMessage

— ScribeIn

— ScribeRetry

7. Click Save and close Scribe Console.



Stop Scribe ServicesAt this point, Scribe Services must be manually stopped. After you have configured Shared Message Queues, close all TIBCO Scribe applications and stop all Scribe services on all systems used in your integration. Stopping services helps to avoid resource contention, which can cause performance problems among the failover nodes.

1. In the Windows Services window, locate the Scribe Services.

2. Stop each service in the following order:

a. Scribe MonitorServer

b. Scribe MessageServer

c. Scribe EventManager

d. Scribe BridgeServer

e. Scribe AdminServer

Change The TIBCO Scribe Insight Server NameChange the TIBCO Scribe Insight server name to the network name for the cluster failover instance.

1. Run InternalDB.exe from the Insight installation directory (C:\Program Files (x86)\Scribe\InternalDB.exe).

2. Click the Internal Database tab.

3. Click Test Connection. The connection to the database validates.

4. Click Update Insight Server Name.

5. In the Change Scribe Insight section, enter in Old Scribe Server Name the local computer name in uppercase letters. Verify this name is spelled correctly.

An error may occur if you do not stop Scribe Services in the recommended order.

If it is enabled, click Update Internal Database. After the Internal Database has been upgraded, click Test Connection again.



6. In New Scribe Server, enter the Scribe cluster network name. You define this cluster network later in the installation process.

7. Click Change Server.

8. Click OK. The New Scribe Server Name reflects the network name you will give to the Scribe failover cluster instance.

9. Click Back and OK to close the dialog box.

The name must be in all uppercase letters and no longer than 15 characters for the Scribe MessageServer to work correctly.

Be sure to write down the new name for later use.



Installing And Configuring TIBCO Scribe Insight On Node 2

The installation paths must be identical on both nodes of the cluster. For more information, see Chapter 3, Installing TIBCO Scribe Insight Server, on page 19.

Install Insight On Node 21. Log in to Node 2 with an account that has privileges to connect to the Scribe

Internal Database using Windows Authentication.

2. From the Installation folder, run setup.exe.

3. Follow the directions to ensure all required components are installed.

4. After the prerequisites have been met, click Start Installation.

5. On the Optional Components window, click Next without selecting anything.

6. On the Ready to Install window, click Install to begin the installation.

7. After TIBCO Scribe Insight has installed successfully, click Finish. The TIBCO Scribe Database Setup dialog box displays.

Connect To The Scribe Internal Database1. Select Connect to an existing Scribe Internal Database on SQL Server and

click Next.

2. Enter the database server and database name you used when creating the Scribe Internal Database during the installation process on Node 1.

3. Select Windows Authentication as the SQL Server authentication mode.

4. Click Test Connection and verify the connection to the database is live.

5. Click Next and Close to exit the TIBCO Scribe Database Setup utility. The Select Registration Option screen displays.


— Run the Scribe Services as the default user — Click Cancel.

— Run the Scribe Services as another user:

a. In User Name, enter the user name Scribe Services should run as. By default, the user currently configured for Scribe Services displays. This



user name must match what is in the SQL. For example, if the SQL database identifies this as mydoman1\user1, enter mydomain1\user1.



d. If you want to enable Log On As Service for this user, select the Grant Service Log on As Right check box.

e. Click OK. A message indicates the Services have been modified.

f. Click OK.

7. Select the registration mode for your TIBCO Scribe Workstation installation, one of Online, Offline, or Manual.

— Online


b. In Serial Number, enter the serial number of this installation. Click Next.




f. Click Finish. Setup completes or the Adapter Installation screen displays.

You must register TIBCO Scribe Insight to use the network name of the TIBCO Scribe cluster instance.

Register with a Professional or Enterprise license key that supports your clustered failover environment.




— Offline


b. Either paste the information from the text box on the specified web site or call Support with this information.

c. Click Finish. Setup completes or the Adapter Installation screen displays.

— Manual


b. Enter in the Code column the Unlock Code and any Feature Code you received from TIBCO Scribe or use a Registration File to enter the information.


d. In Serial Number, enter the serial number of this installation and click Next.

e. Enter the requested primary user information and click Next. Setup completes or the Adapter Installation screen displays.

8. If you are not installing adapters, click Exit. You can install adapters after completing the Scribe Insight installation and configuration.

Configure Scribe Services On Node 21. In the Microsoft Services applet, for each Scribe service:






Do the following:

a. Right-click the service and select Properties.

b. On the General tab, set Startup Type to Manual.

c. Click the Log On tab.

d. Select This account and enter the name and password of the Scribe Services account.

2. Open the Server Manager.



3. Expand Configuration, expand Local Users and Group, and select Groups.

4. Select the Scribe Console Users group.

5. Add the Scribe Service Windows account and any other users that require access to the TIBCO Scribe Console.

6. Log off and log in to the server as a user in the Scribe Console Users Group.

Configure A Cluster To Run TIBCO Scribe InsightAdd Insight to a cluster using the Failover Cluster Manager Console. You must add:

• A network name for the failover cluster instance

• A shared disk

• The five Scribe Services

• MSMQ

To create and configure the TIBCO Scribe Insight cluster:

1. Click Start > Administrative Tools > Failover Cluster Manager. The Failover Cluster Manager Console opens.

2. Right-click Roles and click Create Empty Role to create a new role.

3. Right-click New Role and select Properties.

If MSMQ is not installed, a message informs you during the TIBCO Scribe Insight installation. You must install it separately.

If MSMQ is installed, your machine name can be no longer than 15 characters.



4. On the General tab, change the Name to Scribe Insight and select the preferred owner of the cluster, then click OK.

5. In the Failover Cluster Management Console Services and Roles window, right-click Scribe Insight, select Add resource, and click Client Access Point.

6. In Network Name, enter the New Insight Server Name you set in the InternalDB.exe and IP Address for the Insight cluster instance. Click Next.

To ensure the Scribe MessageServer works correctly, the Insight server name cannot be longer than 15 characters.



7. From the Roles window, right-click Insight, select Add resource, and click Generic Service.

8. Add each of the following Scribe Services:






9. Right-click Insight, click Add storage, and select the disk(s) to use with the TIBCO Scribe Failover Cluster, which is used as the TIBCO Scribe Collaboration Drive.

10. From the Roles window, right-click Insight, select Add resource, More Resources and click Message Queuing.

You must add the Shared Disk, IP Address, and Network Name as dependencies for MSMQ to work properly.



11. Click the Insight role and select the Resources tab for the list of resources added for the Insight role.

12. Right-click each of the following and select Properties:


a. Click the Dependencies tab.

b. Add the Shared Disk, IP Address, and Scribe Virtual Server Name.

c. Click Apply.

d. Click the Registry Replication tab.

e. Enter the following registry keys:

SOFTWARE\ODBC\ODBC.INI

SOFTWARE\Wow6432Node\ODBC



SOFTWARE\Wow6432Node\Scribe

f. Click the General tab.

g. Select the Use Network Name for computer name check box.



b. Add the Shared Disk, IP Address, Scribe Virtual Server Name, MSMQ, and Scribe AdminServer, and click Apply.

c. Click the General tab.

d. Select the Use Network Name for computer name check box.



b. Add the Shared Disk, IP Address, Scribe Virtual Server Name, and Scribe AdminServer, and click Apply.





b. Add the Shared Disk, IP Address, MSMQ, Scribe EventManager, Scribe Virtual Server Name, and Scribe AdminServer, and click Apply.





b. Add the Shared Disk, IP Address, Scribe Virtual Server Name, and Scribe AdminServer, and click Apply.





Take The TIBCO Scribe Cluster Online And Offline1. Verify Node 2 is selected as the current owner.

2. On the Failover Cluster Management window, right-click Insight and click Start Role.



3. Right-click Insight and click Stop Role. Verify Insight is offline.

Run The Failovermove.Sql Script1. Open SQL Server Management Studio.

2. Execute the FailoverMove.sql script against your Scribe Internal Database.

Register Scribe On Node 2Open TIBCO Scribe Workbench, register Insight using your Professional or Enterprise license key, then close TIBCO Scribe Workbench.



Add The Network Site To TIBCO Scribe Console For Node 21. Bring the Insight role back online on Node 2.

2. From the TIBCO Scribe Console, right-click the site name in the Console Root and click Delete site.

If there is no site to delete in the Console Root, proceed to the next step.

3. Right-click the TIBCO Scribe Console icon in the Console Root and click Add New Site. The New Site Wizard displays.

4. Enter the network name (Client Access Point) for the Insight cluster instance in the Network Server field. Click Next.

5. Expand ODBC Data Sources, select the ScribeInternal_MS, and click OK.

6. Select Test to confirm the connection works.


Moving And Testing The TIBCO Scribe Insight Cluster | 93

7. Click Finish. The TIBCO Scribe Console opens.

8. Select Site Name, expand Administration, and select Site Settings.

9. In Collaborations, configure the Collaborations root directory.

10. In Site Main Queues, configure the following queues:

— Scribe Input Queue

— Scribe Retry Queue

— Scribe Dead Message Queue

11. Take the Scribe cluster offline.

Moving And Testing The TIBCO Scribe Insight Cluster

1. From the Failover Cluster Management Console, move the Insight role to Node 1.

2. Bring the TIBCO Scribe Insight cluster instance online.

3. Open the TIBCO Scribe Console.

4. Right-click the site name in the Console Root and click Delete site.

5. Right-click the TIBCO Scribe Console icon in the Console Root and click Add New Site. The New Site Wizard displays.

6. Add the new network site using the network name for the TIBCO Scribe Insight cluster instance.

7. Click Finish.

8. Create an integration process in the TIBCO Scribe Console.

9. Move the application from one node to the other.

10. Verify the process continues to run when the current owner changes.



Upgrading TIBCO Scribe Insight In A Failover Environment

1. Take the TIBCO Scribe Cluster Service offline. See Take The TIBCO Scribe Cluster Online And Offline on page 90.

2. Log into Node 1.

3. Run the Insight installer for the latest version of Insight. See Installing And Configuring TIBCO Scribe Insight On Node 1 on page 71.

4. After the installation completes, open TIBCO Scribe Workbench and re-register, then close TIBCO Scribe Workbench.

5. Set the following Scribe services to start manually:






See Configure Scribe Services On Node 1 on page 75 for more information.

6. Log into Node 2.

7. Run the Insight installer on Node 2.

8. When the installation completes, open and close TIBCO Scribe Workbench.

9. Open the TIBCO Scribe Console.

Because you registered when installing on Node 1, you should not be prompted to register again.


Upgrading TIBCO Scribe Insight In A Failover Environment | 95

10. Select Site Name, expand Administration, and select Site Settings.

11. In Collaborations, configure the Collaborations root directory.

12. In Site Main Queues, configure the following queues:

— Scribe Input Queue

— Scribe Retry Queue

— Scribe Dead Message Queue

13. Click Save.

14. Bring the TIBCO Scribe Insight Cluster Service back online.

Your TIBCO Scribe Insight installation is complete.




Installation Checklists | 97

Chapter 9 Installation Checklists

This section provides the checklists for TIBCO Scribe Insight installation and update with the most common features. These sections do not address installing:

• Scribe with the failover feature

• Scribe Workstation

• Scribe under unusual circumstances

For more information, see the remainder of this document or contact your TIBCO Scribe reseller for more information.

Installation Checklist

Step Task Page

Installation Prerequisites

Verify Hardware, Software, and Database Prerequisites 5

1. Determine where the SQL Server database for TIBCO Scribe Insight will reside.

2. Check your SQL Server version and verify its compatibility with Scribe (see the Release Notes for supported versions of SQL Server).

If you do not have SQL Server set up, you can install SQL Server Express Edition, included with the TIBCO Scribe Insight installer.

Configure SQL Server Authentication 15

1. Configure the authentication method for SQL Server

• For SQL Server Authentication

• For Windows Authentication


98 | Chapter 9 Installation Checklists

Determine A Failover Method 17

Determine if your site would be best served using application-based failover, Hyper-V clustering, or a mixed mode for failover.

Install TIBCO Scribe Insight Server

Download And Run The Installer 19

1. Download and unzip the TIBCO Scribe Insight installer.

Note: If using Windows authentication, log in as the user you created for this purpose (the Windows domain user that is a SQL Server principal with dbcreate rights).

2. Run Setup.exe to open the TIBCO Scribe Insight Setup window.

3. Verify the following prerequisites are installed:

• Microsoft Windows Installer 3.1

• Microsoft .NET Framework 4.0

• Microsoft .NET Framework 4.5.2

• (Systems requiring TLS 1.2 only)

• Microsoft .NET Framework 3.5 (Windows 2012 only)

• Microsoft SQL Express 2017 (optional for x64 operating systems)

Install Prerequisites 20

1. Run Setup.exe.

2. Install any prerequisites that are not installed.

3. Determine a Scribe Services User.

Step Task Page


Installation Checklist | 99

Install TIBCO Scribe Insight 20

1. Run Setup.exe and select Install Insight.

2. At the Product Selection and Destination window, select Insight Server.

3. Click Install, follow the prompts to install the program and components, read and accept the license agreements, and click Finish to close the Setup Wizard Completed window.

Add Scribe Services User 22

1. Stop Scribe Services.

2. Run InternalDB.

3. On the Internal Database tab, test the connection to validate the database and database indexes.

4. Change the user name under which the Scribe Services run.

Install SQL Server Express (Optional) 23

If you do not have SQL Server installed, you can install SQL Server Express to use with TIBCO Scribe Insight.

Install TIBCO Scribe Insight Server 25

After TIBCO Scribe Insight is installed, the TIBCO Scribe Database Setup window displays. Select the authentication method you configured in the SQL Server preparation step.

• SQL Server Authentication — Select SQL Server authentication and enter the password for either the SA user created when you installed SQL Server Express or the SA password for your SQL Server installation.

• Windows Authentication — Select Windows authentication using the network login ID.

Step Task Page



1. Specify how to run Scribe Services, as the default user or as another user. If Scribe Services were configured to run as a user, that user name appears.

Optionally:

• Use Database Settings to change the locations of:

— Scribe Internal data file

— Transaction log file

Create a Scribe sample database.

2. Verify you have your TIBCO Scribe serial number available.

3. Start the TIBCO Scribe Workbench and follow the directions in the TIBCO Scribe Registration Wizard to register your TIBCO Scribe products.

Install Adapters 30

1. If you selected Insight Adapters during the initial installation, the Adapter Installation window displays.

2. If you are installing adapters outside of installing TIBCO Scribe Insight, run Setup.exe, select Insight Adapters, and click Start Installation.

3. Select the adapter(s) you want to install, click OK, and follow the instructions in the Setup Wizard for each adapter.

Configuration Steps

Add Users To The Scribe Console Users Group 77

1. Add all local and network Windows users to the Scribe Console Users group that you want to access the TIBCO Scribe Console.

2. Log off the computer and log back in to have the changes to the Scribe Console Users group take effect.

Step Task Page



Create Scribe Console Admins Group, Add Administrative Users (Optional) 34

This is only necessary if any users require remote access to the Administration node in the TIBCO Scribe Console.

1. Create the Scribe Console Admins Group (Administrator privileges required).

2. Add any users to the group who require access to the TIBCO Scribe Console Security Settings node.

Manage Security Settings 35

1. Start the TIBCO Scribe Console.

2. In the Security Settings window, on the File Management tab, select Provide access to SELECTED folders on this server.

3. Navigate to the C:\users\Public\Public Documents folder and add the following folders to the Console Shared Folders list:

• Collaborations

• Samples

• Templates

• Tracing

• Utilities

4. Consider giving access to these other locations:

• Event file locations for any Integration Processes

• Application path, the location of pre/post programs used in integration Processes

• Other folders you wish to share across Collaborations

5. Save your changes.

6. On the Services tab, move the Scribe services from the All Services list to the Shared Services list.

7. Click Save to save your changes.

Step Task Page



8. Optional. If your site is using message queues, on the Message Queues tab, move the three Scribe queues from the Known Message Queues to the Shared Message Queue, and save your changes.

Configure Notification Groups 37

1. In the TIBCO Scribe Console, add the name of the user you want to be notified, specify at least one contact address and the alert types for which to send notifications.

2. Add this recipient to the DB Admin and System Admin groups.

Configure Site Settings 38

1. From the TIBCO Scribe Console, expand the Administration node, and select Site Settings.

2. Optional. Change the Collaboration Root Location on the General tab.

3. Configure the email settings for the server that determine which mail server will distribute the outgoing alerts.

4. Set the sleep period to coincide with backup operations.

5. Start the Notification Monitor.

Start The Remaining Monitors 41

1. Expand the Integration Server node and select Monitoring.

2. Select each of the system monitors and click Resume.

Create The ScribeIn Queue Monitor (Optional) 41

1. If your site uses message queues, create a ScribeIn Queue Monitor.

2. In the General Settings tab, select:

• Monitor Type — Queue

• Monitor Name — ScribeIn Queue Detail

3. On Step 2: Source Connection, select Scribe Input Queue.

4. On Step 3: Alert Criteria, select the alert criteria you want.

Step Task Page



5. On Step 4: Monitor Interval, set the Monitoring Interval Settings to Monitor every 15 minutes.

6. On Step 5: Activation, select Status – Active.

7. On Step 6: Alerting, select Critical.

Optional. Create A User For The Scribe Services 43, 22

If you did not specify a user for Scribe Services during installation, all Scribe services are set to run logged in as the Local System account. TIBCO Scribe suggests you create a Windows account to be used by the Scribe services:

• Give this account the necessary access on the local computer and on other computers on the network.

• Change the properties on the Scribe services to log on as this account.

• If Scribe processes need access to remote file servers or a network system, set up a specific user account with access to the remote files. Run the Scribe services under this user.

Step Task Page



Upgrade Checklist

Step Task Page

Perform Preinstallation Tasks 53

1. Pause all Publishers and any Integration Processes.

2. Export the Scribe Package.

3. Check the size of the following and run ScribeMaintenance.sql if they contain a large number of records:

• AlertLog

• ExecutionLog

• TransactionErrors

• Any rejected row tables

4. Contact your Database Administrator about backing up the Scribe Internal Database.

5. Copy the Collaborations folder.

6. Copy the Serial Number value and save it in Notepad.

7. Unregister the Computer.

8. Stop the Scribe Services.

9. End the Scribe.UpdateService.exe process.

10. If you are updating Insight from a version prior to 7.6.2, verify UAC is disabled.

11. If you are running an adapter that requires Windows Identity Foundation (WIF), do the following to install WIF on your operating system:

Windows Server 2012 – Enable/Install WIF 3.5 via Features

12. If WIF is installed but Microsoft .NET Framework 3.5 is not installed, for Windows Server 2012 – Enable/Install .NET 3.5 Framework via Features

If you are using the Dynamics AX, Dynamics CRM, Dynamics GP, Dynamics NAV, or Query Publishers, install the Microsoft Message Queuing (MSMQ).


Upgrade Checklist | 105

Install Insight And Adapters 54

1. If you are updating from Scribe Insight 6.4.0 or earlier, uninstall Insight.

2. Download and unzip the Scribe installer.

3. Open the TIBCO Scribe Insight Setup window and verify the following prerequisites are installed:

• Microsoft Windows Installer 3.1

• Microsoft .NET Framework 4.0

• Microsoft .NET Framework 4.5.2 (Salesforce with TLS 1.2 only)

• Microsoft .NET Framework 3.5 (Windows 2012 only)

• Microsoft SQL Express 2017 (optional x64 operating systems)

4. Restart your computer and open the TIBCO Scribe Insight Setup window again.

5. At the Product Selection and Destination window, select Insight Server, and click Install.

6. Specify the user name under which Scribe Services are to run, either the default user or another user.

7. Register the new version of Insight.

8. If you selected Insight Adapters during the initial installation, the Adapter Installation window displays.


10. Follow the instructions in each adapter Setup Wizard to install each adapter.

Step Task Page



Install Adapters Separately (Optional) 57

1. If you are installing adapters outside of installing Insight, run Setup.exe and select Insight Adapters.


3. Follow the instructions in the Setup Wizard to install each adapter. If you are installing multiple adapters, each Setup Wizard starts as soon as the previous installation finishes.

Update Scribe Internal Database 57

1. If the Scribe Internal Database will remain on the current server, choose the option to upgrade the existing DB.

2. If the Scribe Internal Database is being restored to a new server, install a new Scribe Internal Database and restore the existing Scribe Internal Database to the new SQL Server.

3. Run Program Files (x86)/Scribe/InternalDB.exe, then run the Update Database option.

Perform Post Installation Tasks 57

• If Insight was installed on a new server, correct the server references in the Scribe Internal Database.

• Register Insight through the Workbench.

• If you have issues registering Insight, run ClearScribeLicense.sql, found in the folder where Insight is installed.

• Verify the Scribe services LogOn user is a domain account that belongs to the local Administrators and Scribe Console Users groups.

• Restart the Scribe Services.

• Perform any post-installation steps required for the Adapters you have installed.

• If you are upgrading to an X.0.0 version, such as 7.0.0, open the DTS to upgrade it.

Step Task Page


Upgrade Checklist | 107

Add Users To Scribe Console Users Group 34

Use the Windows Computers Management tool to add to the Scribe Console Users group those users who need access to the TIBCO Scribe Console.

Troubleshooting 58

If you are installing Insight or the Scribe Internal Database on a new server, some problems you may find are:

• UAC is disabled.

• Scribe Services Logon User should be a domain account that belongs to the local Administrators group and the Scribe Console Users groups.

• Server name is correct in the various fields for the IntegrationServers, Ksync, and Monitors tables.

• Verify Path is correct in the Ksync table (CollaborationsRoot - KEYVALUE).

• If you are using Windows Authentication for the Scribe Internal database, verify the service logon user (db_owner) has permissions for the Scribe Internal database.

• Run ClearScribeLicense.sql and reregister in the Workbench.

Step Task Page




Troubleshooting | 109

Chapter 10 Troubleshooting

There are a number of ways to get help with TIBCO Software products, as well as to share your solutions with the TIBCO Scribe user community.

Technical Support

TIBCO Scribe technical support is available Monday through Friday, between the hours of 4:00 AM and 8:00 PM Eastern US time (except major local holidays).

To get started with technical support, call +1 603 622 5109 and press 3. A technical support representative will be happy to explain your support options and help you get started.

For on-line support information, visit Scribe Online Support.

Downloading Insight

You can download the Insight installation software by logging into eDelivery, searching for TIBCO Scribe Insight, and selecting the installer for your software. When you purchase Insight and any required adapters, you are provided with a serial number that allows you to register and use your product(s).

Before you register Insight, make sure you have your Insight serial number available.




https://www.scribesoft.com/services/support/technical-support/

110 | Chapter 10 Troubleshooting


TIBCO Scribe Insight With TLS 1.2 Only Enabled | 111

Appendix A TIBCO Scribe Insight With TLS 1.2 Only Enabled

When only the TLS 1.2 protocol is enabled you must have upgraded ODBC drivers to access the Scribe Internal Database and allow the Workbench to run.

The TIBCO Scribe ® Insight Installer requires that TLS 1.0 be enabled to complete the installation process. After the installation is complete, you may choose to disable TLS 1.0 and use TLS 1.2. After disabling everything but TLS 1.2 on a system, Insight cannot communicate with the internal database. Other adapters are also affected and cannot operate.

There are two Scribe ODBC DSN’s that need to be recreated using newer drivers.

Recreating The ODBC DSNs

1. Requires that one of the following 32 bit ODBC Drivers be installed:

Microsoft® ODBC Driver 13 for SQL Server® - Windows + Linux

See https://www.microsoft.com/en-us/download/details.aspx?id=50420 (msodbcsql.msi)

Or

SQL Server Native Client 11.0 (v 2011.110.6518.000) or later

2. Requires Microsoft® OLE DB Driver 18 for SQL Server®

See https://www.microsoft.com/en-us/download/details.aspx?id=56730 (msoledbsql.msi)

Verify that the version of Microsoft SQL Server you are using has all of the updates required for TLS 1.2.

SQL Server Native Client may already be installed on your system. Check the installed ODBC drivers.


https://www.microsoft.com/en-us/download/details.aspx?id=50420

https://www.microsoft.com/en-us/download/details.aspx?id=56730

112 | Appendix A TIBCO Scribe Insight With TLS 1.2 Only Enabled

3. Change the ScribeInternal_MS ODBC DSN to use the new driver:

Determine which ODBC DSN is used for Scribe Insight (if more than 1 exists)

From the folder where Insight is installed run InternalDB.exe. The ODBC DSN name is at the top.

4. Using C:\Windows\SysWOW64\odbcad32.exe (for 32-bit systems) or C:\Windows\SysWOW64\odbcad32.exe (for 64-bit systems) or the


Recreating The ODBC DSNs | 113

Add/Modify ODBC Data Source button on the Data Sources tab shown when you run InternalDB.exe:

a. On the System DSN tab, rename the old DSN, for example, ScribeInternal_MS to ScribeInternal_MS2).

b. Add a new System DSN with the same name as the original DSN, for example, ScribeInternal_MS.

c. Select either the new ODBC driver 13 for SQL Server or the SQL Server Native Client 11.00 depending on which driver you installed.

d. Enter the name of the server where the Scribe Internal Database is installed.

e. Select the one of the authorization types.

Windows Authentication

SQL Authentication - Username/password is typically SCRIBE/integr8!

f. Set the default database to be SCRIBEINTERNAL.

g. The remaining options can be the defaults.

5. Change the Scribe SQL Server Template ODBC DSN to use the new driver:

The Scribe SQL Server Template ODBC DSN is used when creating Native SQL connections in Insight, which only supports SQL Authentication. If your instance of SQL Server only allows Windows Authentication, this step is not necessary.

Using C:\Windows\System32\odbcad32.exe. (for 32-bit system) or C:\Windows\SysWOW64\odbcad32.exe (for 64-bit system) or the Add/Modify ODBC Data Source button on the Data Sources tab shown when you run InternalDB.exe:

a. On System DSN tab, rename the old DSN, for example, Scribe SQL Server Template to Scribe SQL Server Template2).

b. Add a new System DSN with the same name as the original DSN, for example, Scribe SQL Server Template).

c. Select either the ODBC driver 13 for SQL Server or SQL Server Native Client 11.0 depending on which driver you installed.

d. Enter the name of the server where Scribe Internal Database is installed.

e. Select SQL Authentication authorization type.

For SQL Authentication the username/password is typically SCRIBE/integr8!

f. The remaining options can be the defaults.


114 | Appendix A TIBCO Scribe Insight With TLS 1.2 Only Enabled


Date post:	03-Mar-2020
Category:	Documents
Upload:	others
View:	8 times
Download:	0 times