ASG-Becubic Installation and Implementation Guide
Total Page:16
File Type:pdf, Size:1020Kb
becubic Installation and Implementation Guide Version: 9.9.1 Publication Date: December 2020 ©2021 ASG Technologies Group, Inc. All rights reserved. The information contained herein is the confidential and proprietary information of ASG Technologies Group, Inc. Unauthorized use of this information and disclosure to third parties is expressly prohibited. This technical publication may not be reproduced in whole or in part, by any means, without the express written consent of ASG Technologies Group, Inc. All names and products contained herein are the trademarks or registered trademarks of their respective holders. ASG Technologies Worldwide Headquarters Naples Florida USA | asg.com | [email protected] 708 Goodlette Road North, Naples, Florida 34102 USA Tel: 239.435.2200 Fax: 239.263.3692 Toll Free: 800.932.5536 (USA only) Contents becubic Installation 1 ASG Access Updates and Service Packs 1 Open Source Components 1 Installing becubic 3 Prerequisite 3 Installation Procedure 4 Customizing Memory Allocation Parameters 17 Allocating Memory for Java on a 64-bit Machine 18 Specifying Temporary Folder 18 Setting Up becubic Database Server 18 Overview 18 Installing a DBMS 18 Installing Oracle DBMS 19 Installing Microsoft SQL Server DBMS 22 Preparing Database Creation 25 Calculating Required Disk Space 25 Distributing Data Files 28 Creating and Initializing a Dedicated Database 30 For Oracle 30 For Microsoft SQL Server 30 Checking Database Parameters 40 Initializing the Database 40 Adding becubic-specific Storage Area 44 Oracle Tablespaces for becubic 44 Microsoft SQL Server Filegroups for becubic 45 Next Step 46 Configuring an Application Server 46 Deploying Server Applications 46 Configuring the Connections 47 Setting Up Apache Tomcat Server 47 Configuring Apache Tomcat Server 48 Starting and Stopping the Preconfigured Tomcat Server 49 i Setting Tomcat Server URI Encoding 50 Configuring Redirection 50 Setting Up WebLogic Server 50 Setting Up WebSphere Server 51 Using Ant-based Deployment 51 Generating WAR File with Connection Information 52 Generating Standalone WAR/EAR by Ant Task 56 Configuring the Server for Remote Access 56 Securing Remote Admin Access on a Tomcat Server 56 Securing Remote Admin Access on WebSphere 58 Configuring the Web Server’s web.xml File 59 Managing Java Security 60 Implementing a becubic Project 61 Using Model Wizard 61 Starting Model Wizard 62 Creating and Updating Projects 62 Creating a New ADU Project 62 Creating a New Project Using an XMI Model 66 Updating an Existing Project 67 Upgrading a Repository from an Earlier Version 68 Creating and Initializing a CAE Entry Point 72 Output Directory Dialog 76 Establishing the List of Exposed Locales 80 Creating and Initializing the becubic Repository 80 Under Oracle 80 Under Microsoft SQL Server 84 Database Actions 89 Uploading a Project to a Remote Server 94 Managing Projects on a Remote Server 97 Accessing Remote Projects 97 Taking Action on a Remote Server 98 Redocumentation Sequence 100 Preparing to Run the Redocumentation Sequence 100 Running the Redocumentation Sequence 101 ii Working with a Local Project 105 Managing Source Category Associations 105 Working with Remote Projects 107 Managing Remote Files 108 Working with a Remote Redocumentation Sequence 110 Running an Executable File on a Remote Server 110 Setting up becubic ODBC Bridge 111 Configuring the Dharma SDK Server 112 Verifying Connectivity with the Dharma ISQL Tool 113 Configuring the ODBC Clients 114 becubic ODBC Bridge Output 115 becubic Data Mapped to SQL 115 Examples of Retrieving Data with Microsoft Query 118 Retrieving Data with a Microsoft Excel Macro Statement 133 Implementing Business Names 134 Creating Business Names 134 Opening a Business Name Definition for Editing 136 Selecting User Roles 136 Defining Localized Business Name Definition Names 136 Defining Aliases 138 Removing Aliases 140 Working with Sequence Editor 140 Creating a Redocumentation Sequence 140 Opening a Redocumentation Sequence for Editing 141 Saving a Redocumentation Sequence 141 Specifying Repository Connection 142 Managing Concurrent Executions 144 Editing a Redocumentation Sequence 144 Elements in Redocumentation Step Definition 144 Adding Steps and Substeps 146 Defining a Task for a Step or a Substep 150 Step Tree Shortcut Menus 151 Copying and Pasting Steps, Substeps, and Tasks 153 Using Ant-based Tools 153 Adding Custom Tasks to a Redocumentation Sequence 181 iii Sample Custom Tasks 181 b3:types 182 b3 Features 183 Editing a Redocumentation Sequence’s Properties 184 Assigning Variable Values to Properties 186 Editing a Property Value 186 Deleting a Property 186 Restoring a Property Value 186 Running a Redocumentation Sequence 187 Executing the Whole Sequence 187 Executing Contextually to Callable Steps 188 Tracking a Redocumentation Sequence 188 Generating a BAT File to Run the Redocumentation Sequence 193 Implementing Load Balancing 194 Principle of Operation 195 Installing and Deploying the Tomcat Web and HTTP Apache Servers 195 Required Software 195 Procedure 195 Deploying Only the WAR File in Multiple Standalone Tomcat Servers 199 Hardware and Software Configurations 199 becubic Collectors 199 Mainframe 199 Distributed Architecture 199 becubic Analyzer 199 becubic Database Server 200 List of Supported Database Platforms 202 becubic Application Server 203 List of Supported Database Platforms 204 becubic Clients 205 becubic Rich Client 206 becubic Web Client 206 becubic Reporting Client 207 Virtual Machine Support 207 List of becubic and CAE Queries 208 iv Setting Up Database by DBA 211 Sample Scripts 213 Database Creation Scripts 213 Running Model Wizard without the System User 215 Creating the Repository Owner User 216 Running Model Wizard 216 Running Model Wizard through Command Line 217 Logical Models 217 Logical DWR Model 217 Logical Scanner Models 223 Transformation Rules for Logical Scanner Models 223 Data Lineage Support 237 v becubic Installation becubic Installation This section shows the becubic setup program’s windows, and provides information on the installation options. ASG Access Updates and Service Packs ASG encourages you to visit the ASG ACCESS Portal: https://access.asg.com. This ASG portal allows you to verify whether any ASG product or documentation revisions, new maintenance, or service packs apply to this product release. Open Source Components becubic includes these open source components, which are listed by their contributors: Contributor Component License ANTLR Ver- http://www.antlr.org BSD sion 3.0 http://www.antlr.org/license.html Apache Com- mons (e.g., Collections, DBCP, JXPath, and Pool) Ant Batik http://www.apache.org http://commons.apache.org Compass http://lucene.apache.org/java/docs/index.html Apache Software Foundation Log4J http://www.apache.org/licenses/LICENSE-2.0 Lucene Struts Tomcat Bouncy Castle bouncycastle http://www.bouncycastle.org 1 Contributor Component License http://www.bouncycastle.org/licence.html (for MIT X11 License) Eclipse Ver- http://www.eclipse.org Eclipse sion 1.0 http://www.eclipse.org/legal/epl-v10.html Htmlparser http://www.gnu.org http://www.gnu.org/copyleft/lesser.html (for Free Software Foundation Jfreechart LGPL License) xom FOP FOP http://xmlgraphics.apache.org/fop/ JavaGeom JavaGeom http://geom-java.sourceforge.net/ http://www.jgrapht.org JGraft JGraft http://www.jgrapht.org/LGPL.html JNA (Java Nat- JNA https://github.com/twall/jna ive Access) https://sourceforge.net/projects/jtidy/ (for JTidy JTidy W3C Free License) http://geek.net/ JDBM http://jdbm.sourceforge.net/ Geeknet http://swtcalendar.sourceforge.net swtcalendar http://swtcalendar.sourceforge.net/license.html (for MIT License) http://graphviz.org Graphviz Ver- Graphviz http://www.graphviz.org/License.php (for CPL sion 1.0 License) http://cssparser.sourceforge.net/ CSSParser CSS Parser http://www.gnu.org/copyleft/lesser.html (for LGPL License) 2 Installing becubic Installing becubic If you are upgrading from an earlier release, you cannot use existing repositories with becubic Ver- sion 8.7.2. It is important that you contact ASG Customer Support for guidance. ASG-License Server (herein called License Server) must be installed on an accessible server machine to be able to validate your license keys. If you intend to upgrade your existing becubic projects, you can install becubic either in a directory in which an earlier version was installed or in a separate directory. Do not, however, rename the directory that contains the earlier version. Renaming the directory will make it impossible for the installer to detect the earlier version. If you have the preconfigured JBoss server installed on the machine on which you want to upgrade becubic, you must stop and remove it (i.e., through the console or the corresponding Windows service). The preconfigured application server is replaced with Tomcat 7. Prerequisite becubic and its underlying software (i.e., Eclipse, Ant, and Apache Tomcat) require the Java Runtime Environment (JRE). You must have a JRE installed before installing becubic. l See Hardware and Software Configurations for information about the version compatibility. l If you have different versions of JRE/JDK compatible with becubic installed, the most recent version is selected by the setup program. l If you use a JRE (not a JDK), you may encounter the warning message Unable to locate tools.jar. in different log files. You can ignore this warning since it has no effect on using becubic. Local Administrator Rights The becubic setup does not require the Local Administrator rights.