Analytix: Mapping Manager Installation Guide Version 2.3.1 Page 1 of 15
Copyright Notice This manual is 2007. All rights reserved. No part of this manual may be reproduced, distributed or transmitted, in whole or in part, in paper, electronic or any other form or by any means other than as expressly permitted in the applicable Mapping Manager Software License Agreement or Software License and Maintenance Agreement, or as otherwise expressly permitted by Analytix data Services. Trademark Notice MAPPING MANAGER, ANALYTIX MAPPING MANAGER ANALYTIX: MAPPING MANAGER MAPPING MANAGER are trademarks of Analytix Data Services and may not be used without the express written permission of Analytix Data Services. This list of trademarks may not be complete; other trademarks or registered trademarks may be owned by Analytix Data Services from time to time and may be used in this manual. All other trademarks or service marks are the properties of their respective owners. Proprietary and Confidential Information Notice Analytix Data Services software products contain valuable trade secrets and proprietary information and are protected internationally, including without limitation, by Canadian, United States and international copyright, trademark, and other intellectual property laws and treaties. Unauthorized use of this manual or Analytix Data Services software products is strictly prohibited and may result in civil damages and criminal prosecution. See the applicable Analytix Data Services Software License Agreement or Software License and Maintenance Agreement for additional information. License Requirements for Third-Party Software included with Analytix: Mapping Manager Certain third-party software such as Eclipse Rich Client may be included with Analytix Data Services Software. Such software is provided pursuant to their respective licenses and not under Analytix Data Service s licenses. Please see their respective license documents for their terms and conditions. Disclaimers Analytix Data Services reserves the right to revise this manual and make periodic changes to its content without obligation on Analytix Data Services Corporation's part to notify any person of such revisions or changes. Analytix Data Services does not assume responsibility for the use of this manual. Analytix Data Services makes no representation or warranty as to the accuracy of the contents of this manual. All statements made and information provided in this manual is provided on an errors and omission accepted (E. & O.E.) basis only. Page 2 of 15
Table of Contents Terminology... 4 Customer Support... 4 Architecture Diagram... 4 Installing Analytix: Mapping Manager... 6 1. Pre Install Checks... 6 2. Installation JDK1.6 and Tomcat Server... 7 3. ICC Database installation... 12 4. Deploying ICC Application... 14 5. Using the ICC Web Application:... 14 Page 3 of 15
Terminology ICC. Integration Control Center (ICC) is referenced throughout this document and references the database name (metadata repository) and is referred to synonymously with the Mapping Manager for purposes of installation. The product should commonly be referred to as Analytix Mapping Manager. Customer Support For technical support please call (641) 715-3800 and enter your customer number or contact your sales associate. Support hours of operation: Monday-Friday 9am-5pm CST. Architecture Diagram The Mapping Manager/ICC application supports both a single server and distributed architecture. Page 4 of 15
Page 5 of 15
ICC Web Application Setup guide This document guides you through installation of Integration Control Center Application. ICC Documentation includes the following: ICC Installation Guide. This guide contains instructions for installing and configuring ICC on Windows platform and also helps you test the installation. ICC User Guide. This guide describes administration and gives a general description of how to create, maintain ICC Application. Installing Integration Control Center / Analytix: Mapping Manager 1. Supported Environment Windows Server: v2005/2008 Microsoft SQL Server Database: v2005/2008 (Note: SQL Express may also be used but not recommended for Enterprise Production Deployments). Browser: Internet explorer 6.0 or greater (Note: version 8 requires compatibility settings for production url), Mozilla Firefox v 3.0 or greater (Note: requires download of IE Explorer add-on from Mozilla). Sun JDK: 1.6 or greater (packaged or download from Sun Microsystems) Tomcat 6.0 (packaged) 2. Pre Install Checks The following are the requirements to setup Integration Control Center. Sun JDK1.6 (Included and shipped with ICC Installation CD) SQL Server 2005 (Not included) Tomcat 6.0 (Included and shipped with ICC Installation CD) Windows XP Professional or Later (Not Included) IE Browser 6.0 or Later (Not included) ICC Libraries (Included and shipped with ICC Installation Package) The installation and setup of Web application involves three step processes: 1. Installation of JDK1.6 and Tomcat6.0. 2. Deploying ICC Libraries. 3. Installation SQL Server DB and Creation of ICC DB in SQL Server Page 6 of 15
3. Installation JDK1.6 and Tomcat Server Here we are illustrating the guidelines to install and configure the Tomcat 6.0.10, as a standalone web server only for Microsoft Windows. Please Note: Apache Tomcat is sometimes referred, as Jakarta Tomcat. Step 1: Installation of JDK: Install JDK1.6 on your system located in installation CD (if not installed already) and set the class path as described in step 2. o Alternate installation of Sun JDK. The latest version of Sun JDK can be found on Sun s website at: https://cds.sun.com/is-bin/intershop.enfinity/wfs/cds- CDS_Developer-Site/en_US/-/USD/ViewProductDetail- Start?ProductRef=java_ee_sdk-5_07-jdk-6u16-oth-ml-JPR@CDS- CDS_Developer Step 2: Setting the class path variable for JDK: There are two methods to set the class path. Set the class path using the following Command at command prompt. o Set PATH= C:\ProgramFiles\Java\jdk1.5.0_08\bin ;%PATH% o The other way of setting the class path variables are: o Right click on the My Computer->properties->advance- >Environment Variables-> path. o Edit PATH Variable and append the following C:\ProgramFiles\Java\jdk1.5.0_08\bin Step 3:Installation process of Tomcat 6.0.10: o Tomcat comes in two forms:.zip file or the Windows installer (.exe file). Here we are describing the installation process by using the.exe file (Located in Installation CD). The directory o To Start Installation Double click on \\ADS\ICC\tomcat\apachetomcat-6.0.16.exe. You will see the welcome screen as below Just click on the Next button to continue the installation process. Page 7 of 15
Click I Agree button to continue the installation process. Click next to go with the default components chosen. Page 8 of 15
Choose the location for the Tomcat files as per your convenience. You can also choose the default location. Now choose the port number on which you want to run the tomcat server. Tomcat uses 8080 as its port. We recommend you to use port 80, since this will allow user to access ICC Application with out entering port number in browser otherwise the user required to specify the port number in browser. Note: Make note of the port chosen to run Tomcat as this information is required for application access in Section 6 below (Application Login). Example: If you choose the port number 8080, you need to follow URL to access tom cat default page: http//localhost:8080/index.jsp Page 9 of 15
If you choose port 80 you just need the following URL to access tom cat default page http://localhost/index.jsp. Note that we do not need to specify any port number in the URL. Choose User name and password for Web Server Administration Now click on the Next button to continue the installation process. The installation process shows below screen. This window required you to the location of the installed Java Virtual Machine. Browse the location of the JRE folder (Location of JDK Installed in step 1) and click on the Install button. This will install the Apache tomcat at the specified location. Page 10 of 15
Click Finish button to complete the installation. If you check Run Apache Tomcat check box Apache Web server will try to start automatically After successful installation, a shortcut icon to start the tomcat server appears in the icon tray of the task bar as shown below. Double clicking the icon, displays the window of Apache Manager for Tomcat. It might show the Startup type as manual (if you change default installation Location). Setting Environment for Apache Tomcat Page 11 of 15
Step 4: Set JAVA_HOME Variable: Purpose of setting the environment variable JAVA_HOME is to specify the location of the java run time environment needed to support the Tomcat else Tomcat server does not run. This variable contains the path of JDK installation directory. Note that it should not contain the path up to bin folder. Set JAVA_HOME= C:\Program Files\Java\jdk1.6.0_06 (or where ever you have installed JDK) For Windows XP, Go through the following steps: o Start menu->control Panel->System->Advanced tab->environment Variables->New set the Variable Name as JAVA_HOME and Variable Value as C:\Program Files\Java\jdk1.6.0_06. It will set the JDK path. Starting and Stopping Apache Tomcat Server Service Start or stop can be done through Control Panel -> Administrator Tools -> Services - > Apache Tomcat Or Start the Tomcat Server: Start the tomcat server from the bin folder of Tomcat6.0 directory by double clicking the tomcat6.exe file. You can also create a shortcut of this.exe file at your desktop. Stop the Tomcat Server: Stop the server by pressing the Ctrl + c keys. 4. ICC Database installation This section explains the steps for installation of ICC Database: Pre-requisite: SQL Server 2005 should be installed and running on Windows Server. Step 1. Follow the steps to create ICC DB and tables in SQL Server: Right click on icc_ddl_v2.3.sql (located under \\ADS\ICC\sql) file in the explorer (release folder) Choose Open with SQL Server. The SQL Server prompts for user id and password. Enter the user-id and password and click OK. Opens the schema in a editable window shown below Page 12 of 15
Next Verify the correct database name & Click on Execute button on the tool bar to create the database tables. The above steps creates ICC database, tables and default system table data required to run the Mapping Manager Application. Step 2. Create a Database Owner / Application User Account on SQL Server. Set the ICC database owner to the user, specifically created for application purpose. Note: It is recommended to create a System User Id for the application to use to login to the database. Analytix Recommends a system user id of: AnalytixMM (or similar according to corporate standards) with full dbo, read, write, update, delete, and execute permission. 1. Note: This is the user account the Mapping Manager Application uses to login to the database. Specific user accounts are created through the Mapping Manager application user interface. 2. Note: Make note of the System User Id and password (created in the step above). This information is needed in step 5C below. Page 13 of 15
5. Deploying ICC Application For the first time ICC Application is a two step process and from the next time onwards, simply proceed with step B Step A: Copy the all files from \\ADS\ICC\lib directory to %TOMCAT_HOME%\lib folder. Step B: Deploy the ICC Web Application (Analytix Mapping Manager) : o Copy icc.war which can be found under \\ADS\ICC\war file to \\Program Files\Tomcat 6.0\webapps (default location) o Now you need to restart Apache tomcat service o Open Control Panel >> Administrator Tools >> Services o Right click on Apache Tomcat restart if its already running if its not already started please start the service Now ICC Application is deployed and ready to use. Step C: Open the <TOMCAT_HOME>\webapps\icc\WEB-INF\database.properties in any text editor and change values appropriately. You may need to change the values for only the bold text as shown below and replace italics with appropriate values (As advised by your SQL Server DBA) o Note: localhost:1433 (refers to the database port configured in sql server manager) DriverName=com.microsoft.sqlserver.jdbc.SQLServerDriver URL=jdbc:sqlserver://localhost:1433;databaseName=ICC; UserName=userid Password=Pwd 6. Using the ICC Web Application: This is the Url all users should be provided for system access and login to the Analytix Mapping Manager system. Step 1. Access the Analytix Mapping Manager Web Application. The web application can be accessed with the below URL: http://localhost:8080/icc/loginpage.jsp Note: 8080 refers to the port you setup in the Tomcat Server installation in section 3 Step3. If you chose a different port you may need to change the port 8080 in the url for system access. Page 14 of 15
Or http://localhost/icc/loginpage.jsp Step 2. Login. The default user-id and password for the Analytix Mapping Manager system is: User Name: Administrator Password: Administrator. Default Permissions: Administrator. Note: This user account can be used to create other user accounts and specify application role permissions (including other administrator user accounts) in the project and resource manager module of the application (see users Tab of Application and consult the QuickStart User Guide for further instructions). Page 15 of 15