Release 2019 R1 - Erwin, Inc.
erwin Mart ServerRelease NotesRelease 2019 R1
Legal NoticesThis Documentation, which includes embedded help systems and electronically distributedmaterials (hereinafter referred to as the “Documentation”), is for your informational purposes only and is subject to change or withdrawal by erwin Inc. at any time. This Documentation is proprietary information of erwin Inc. and may not be copied, transferred,reproduced, disclosed, modified or duplicated, in whole or in part, without the prior writtenconsent of erwin Inc.If you are a licensed user of the software product(s) addressed in the Documentation, youmay print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software,provided that all erwin Inc. copyright notices and legends are affixed to each reproducedcopy.The right to print or otherwise make available copies of the Documentation is limited to theperiod during which the applicable license for such software remains in full force and effect.Should the license terminate for any reason, it is your responsibility to certify in writing toerwin Inc. that all copies and partial copies of the Documentation have been returned toerwin Inc. or destroyed.TO THE EXTENT PERMITTED BY APPLICABLE LAW, ERWIN INC. PROVIDES THISDOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUTLIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR APARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL ERWIN INC. BE LIABLETO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROMTHE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS,LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF ERWININC. IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the termsof this notice.The manufacturer of this Documentation is erwin Inc.Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.Copyright 2019 erwin Inc. All rights reserved. All trademarks, trade names, servicemarks, and logos referenced herein belong to their respective companies.
Contact erwinUnderstanding your SupportReview support maintenance programs and offerings.Registering for SupportAccess the erwin support site and click Sign in to register for product support.Accessing Technical SupportFor your convenience, erwin provides easy access to "One Stop" support for all editions oferwin Data Modeler, and includes the following:Online and telephone contact information for technical assistance and customer servicesInformation about user communities and forumsProduct and documentation downloadserwin Support policies and guidelinesOther helpful resources appropriate for your productFor information about other erwin products, visit http://erwin.com/products.Provide FeedbackIf you have comments or questions, or feedback about erwin product documentation, youcan send a message to techpubs@erwin.com.erwin Data Modeler News and EventsVisit www.erwin.com to get up-to-date news, announcements, and events. View videodemos and read up on customer success stories and articles by industry experts.3
ContentsLegal Notices2Contents4New Features and Enhancements in erwin Mart Server12Log Management12Reporting12Performance Enhancements12SQL Server Support12PostgreSQL Support12Third Party Tools12Character Limitations15Mart Server Version Validation19Install and Configure an Oracle Mart21How to Install and Configure an Oracle Mart22Mart Architecture25Install a Mart or Upgrade a Mart?28Review the Prerequisites for an Oracle Mart29Create the Mart Database and Perform the Additional Tasks33Install erwin Mart Server37Enable SSL for Tomcat40Use Mart Server as a Windows Service43Enable Logging43Initialize an Oracle Mart454
Log In to erwin Mart Administrator and Configure Settings48Use a Pluggable Database50Create a Pluggable Database52Install erwin Mart Server with a Pluggable Database54Change the Mart Database Server55Troubleshooting56Unable to Create MartServer Service56Port out of range56Call failed on the server57Application Internal Error57ORA-12514 TNS listener does not currently know of service requested in connectdescriptor58Mart already exists. Specify another database name58Initialize page is not loading in Internet Explorer59The Tomcat server is not starting properly. The Configure button is disabled.59A connection with the server could not be established60The server name or address could not be resolved60Invalid user ID or password60Error 1202961Unable to load the web page from my web browser61Internet Explorer Redirects to a Different Link62I have a very long Windows user name and I cannot log in to the Mart through erwinData Modeler62SSL Certificate Error635
Unable to save a model to Mart with an existing model nameInstall and Configure a PostgreSQL MartHow to Install and Configure a PostgreSQL Mart636566Mart Architecture69Install a Mart or Upgrade a Mart?71Review the Prerequisites for a PostgreSQL Mart72Create a PostgreSQL Database75Install erwin Mart Server77Enable SSL for Tomcat80Use Mart Server as a Windows Service83Enable Logging83Initialize a PostgreSQL Mart85Log In to erwin Mart Administrator and Configure Settings88Change the Mart Database Server91Troubleshooting92Unable to Create MartServer Service92Port out of range92Call failed on the server93Application Internal Error93Mart already exists. Specify another database name94Initialize page is not loading in Internet Explorer94The Tomcat server is not starting properly. The Configure button is disabled.95A connection with the server could not be established956
The server name or address could not be resolved95Invalid user ID or password96Error 1202996Unable to load the web page from my web browser96Internet Explorer Redirects to a Different Link97Chinese characters are replaced with question marks97I have a very long Windows user name and I cannot log in to the Mart through erwinData Modeler98SSL Certificate Error99Unable to save a model to Mart with an existing model name99Install and Configure a SQL Server MartHow to Install and Configure a SQL Server Mart101102Mart Architecture105Install a Mart or Upgrade a Mart?108Review the Prerequisites for a SQL Server Mart109Create a SQL Server Database112Microsoft SQL Server 2005 Permissions113Specify Use of Foreign Characters With Microsoft SQL Server 2005114Install erwin Mart Server115Enable SSL for Tomcat118Use Mart Server as a Windows Service121Enable Logging121Initialize a SQL Server Mart123Log In to erwin Mart Administrator and Configure Settings1267
Change the Mart Database Server129Troubleshooting130Unable to Create MartServer Service130Port out of range130Call failed on the server131Application Internal Error131ORA-12514 TNS listener does not currently know of service requested in connectdescriptor132Mart already exists. Specify another database name132Initialize page is not loading in Internet Explorer133The Tomcat server is not starting properly. The Configure button is disabled.133A connection with the server could not be established134The server name or address could not be resolved134Invalid user ID or password134Error 12029135Unable to load the web page from my web browser135Internet Explorer Redirects to a Different Link136I have a very long Windows user name and I cannot log in to the Mart througherwin Data Modeler136SSL Certificate Error137Unable to save a model to Mart with an existing model name137Install and Configure a SAP ASE Mart139How to Install and Configure a SAP ASE MartMart Architecture1401438
Install a Mart or Upgrade a Mart?146Review the Prerequisites for a SAP ASE Mart147Create a SAP ASE Database151Transact-SQL Commands153Install erwin Mart Server155Enable SSL for Tomcat158Use Mart Server as a Windows Service161Enable Logging161Initialize a SAP ASE Mart163Log In to erwin Mart Administrator and Configure Settings166Change the Mart Database Server169Troubleshooting170Port out of range170Call failed on the server170Application Internal Error171ORA-12514 TNS listener does not currently know of service requested in connectdescriptor172Mart already exists. Specify another database name172Initialize page is not loading in Internet Explorer172The Tomcat server is not starting properly. The Configure button is disabled.173A connection with the server could not be established173The server name or address could not be resolved174Invalid user ID or password174Error 120291759
Unable to load the web page from my web browser175Internet Explorer Redirects to a Different Link175I have a very long Windows user name and I cannot log in to the Mart througherwin Data Modeler176Create a Customized Security Message179Prepare to Use IIS with Mart181Configure IIS Web Server181Implement SSL for IIS183Mart Server Log Files186Documentation Formats and Deliverables18710
11
New Features and Enhancements in erwin Mart ServerThe following new enhancement has been implemented in the current release of the erwinMart Server.Log ManagementA new feature, Log Management has been introduced. It lets you clear erwin Mart usagelogs.ReportingMart-level reporting now includes Naming Standard report and User Logs report.Performance EnhancementsFollowing performance enhancements have been made:LDAP log-in experience has been improved.Mart report sync time has been improved. For example, for a 10 Customer model,with total mart size 650 MB, earlier it used to take approximately 30 hours to sync.Whereas, now, it takes approximately 5 hours.SQL Server Supporterwin Mart Server is now certified to work with SQL Server 2017.PostgreSQL Supporterwin Mart Server is now certified to work with PostgreSQL v9.6.12, v10.7, and v11.2.Third Party ToolsSupport for third-party tools has been upgraded as follows:Tomcat has been upgraded from v9.0.5 to v9.0.14.12
Mart Server 64-bit now uses Oracle OpenJDK v11.0.2.Note: For Mart Server 32-bit, install Oracle (Sun) JRE V1.8.0 172 or higher and thenset the JRE HOME Environment Variable.13
14
Character LimitationsThere is a limitation on the number of characters you can use for certain Mart Server parameters. The following table gives information about such parameters:Parameter/FieldCharacter LimitationUser Name450 (Server User, Windows User, and Group)Note: For international OS (I18N), if the character setbeing used is DBCS (Double byte Character Set) thenthe character limit is 225.Password130Email Address130Profile Name130Profile Descrip- 2000tionCatalog Name255Catalog Descrip- 4000tion15
Mart Server Version ValidationFrom erwin Data Modeler (DM) and erwin Mart Server (MS) 2019R1 onward, while connecting to the erwin MS from erwin DM, version validation has been implemented as follows:1. Connecting from erwin DM 2019R1 to erwin MS lower than 2019R1 is not allowed.2. Connecting from erwin DM lower than 2019R1 to erwin MS 2019R1 is not allowed.
20
Install and Configure an Oracle MartThis section describes how you can install and configure a Mart on an Oracle database.This section contains the following topicsHow to Install and Configure an Oracle MartHow to Upgrade any r9 Series Mart to the Current VersionChange the Mart Database ServerTroubleshooting21
How to Install and Configure an Oracle MartIn the previous versions, erwin DM connected to the Mart database through the database client software. Now, the application connects to the Mart database through a web server. Thedatabase client software is no longer required.The Mart comprises the following components:DatabaseStores the user data for the Workgroup Edition. You can use an Oracle 10g, 11g, 12c,or the certified version 12c R2 database for the Mart database. If you are usingOracle 12c, you can use a pluggable database. You must use a new database and notan existing database that was created for an older version of the data modeling tool.ApplicationsIncludes a web-based component named erwin Mart Administrator that helps youmanage the Mart through a web console.Web serverHosts erwin Mart Administrator. You can use a web server of your choice. If you havenot installed a web server, use the erwin Mart Server option and install Tomcat.22
23
Complete the following steps in the same order to install and configure the Mart:1. Review the Prerequisites for an Oracle Mart2. Create the Mart Database and perform the additional tasks3. Install erwin Mart Server4. Use Mart Server as a Windows Service5. Initialize an Oracle Mart6. Log in to erwin Mart Administrator and configure settings7. Use a Pluggable DatabaseBack to Top24
Mart ArchitectureIn the previous versions, erwin DM connected to the Mart database through the database client software. Now, the application connects to the Mart database through a web server. Thedatabase client software is no longer required. The web server includes a web-based administration console erwin Mart Administrator. If you are using the Workgroup Edition, youmust install and configure erwin Mart Administrator.The Mart comprises the following components:DatabaseStores the user data for the Workgroup Edition. You can use an Oracle 10g, 11g, 12c,or the certified version 12c R2 database for the Mart database. If you are usingOracle 12c, you can use a pluggable database. You must use a new database and notan existing database that was created for an older version of the data modeling tool.ApplicationsIncludes a web-based component named erwin Mart Administrator that helps youmanage the Mart through a web console.Web serverHosts erwin Mart Administrator. You can use a web server of your choice. If you havenot installed a web server, use the erwin Mart Server option and install Tomcat.The following diagram shows the new architecture:25
The new architecture has the following benefits:Separate logical and physical users: In the previous versions, Mart (or Model Manager) users required database level privileges to access the Mart functionality. TheMart database administrators added or deleted users in the Mart database. Thisapproach is changed now. The logical users are separated from physical users, soMart Administrators can create the Mart users without creating the correspondingdatabase users.Authentication through Active Directory services: Earlier, if you wanted to provideaccess to a user group, you added each user individually. Now, because of the newarchitecture, you can use the Active Directory services and can provide access to thegroup. Anyone who is part of the group gets access.Mart administration outside erwin Data Modeler: In the previous versions, MartAdministrators used erwin Data Modeler for administrative activities such as managing permissions. This required non-modelers to know how to use erwin Data26
Modeler. In the new architecture, the administration component is built on a separatelayer on top of erwin Data Modeler and is hosted on a web server. Mart Administrators can access erwin Web Admin from any computer and can perform administrative activities through a web console.Back to Top27
Install a Mart or Upgrade a Mart?Use the following guidelines to determine if you must install a Mart or upgrade a Mart:If you are new to erwin Data Modeler and have purchased the current version ofWorkgroup Edition, then install the current version of the Mart. Use the How to Installand Configure a Mart procedure that is appropriate for your Mart database.If you have any earlier release of r9 series Mart, then upgrade the Mart to the current version. Use the How to Upgrade any r9 Series Mart to the Current Version procedure to upgrade your Mart. The models that are created in any earlier release of r9series are upgraded when a user connects to the current version Mart and opens themodels.If you have an existing Mart and the version is r7.3 through r8.2.9, install the currentversion Mart. Use the How to Install and Configure a Mart procedure that is appropriate for your Mart database. After installing the Mart, use the Upgrade Mart utilityto upgrade the Mart models from r7.3 through r8.2.9 to the current version.28
Review the Prerequisites for an Oracle MartBefore you install the Mart components, help ensure that the minimum system requirements that are outlined in this topic are met.You can use any of the following combinations to install erwin Data Modeler, the Mart database, and the MartServer application:Install erwin Data Modeler, the Mart database, and the MartServer application on thesame computer.Install erwin Data Modeler, the Mart database, and the MartServer application on different computers.Install erwin Data Modeler and the Mart database on one computer, and install theMartServer application on a different computer.Install erwin Data Modeler on one computer, and install the Mart database and theMartServer application on a different computer.Ensure that you always install the MartServer application on Windows operating system.System requirements for installing the MartServer applicationHardware requirements (based on physical hardware performance, not a virtual environment):Hardware requirements (based on physical hardware performance, not a virtual environment):2 GHZ or higher dual core processor4 GB RAM (8 GB or more for large marts)4 GB of disk space or more as required to support your specific martOperating system:Microsoft Windows 7 SP1Microsoft Windows 8.1Microsoft Windows 1029
Microsoft Windows Server 2008 R2 SP1Microsoft Windows Server 2012, R2Microsoft Windows Server 2016Microsoft Windows Server 2019Microsoft .NET Framework 4.0 and aboveAll current Microsoft Windows critical updates are appliedDatabase:The Mart Server can use a standalone or can share an existing database server for anOracle 10g, 11g, 12c, or the certified version 12c R2 database. If you are using Oracle12c, you can use a pluggable database.To create the Mart, you must be the database schema owner user and you must havethe DBA role in the target database on the Oracle server. The DBA role is required forthe user who is specified in the Configure MartServer dialog. If the DBA privilege ofthis user is revoked, then erwin DM users will not be able to save model changes tothe Mart.(Optional) You have modified the following parameters in the initialization file(InitSID.ora):Remote OS Authent TOS Authent Prefix TRUE(Optional) To use the Korean language with the Mart database, use KO16MSWIN949or AL32UTF8 character set depending on your operating system language pack. Formore information, see the Oracle documentation.erwin Mart Administrator web client:Supported browsers:Microsoft Internet Explorer v10 or newerMozilla Firefox v30 or newerGoogle Chrome v30 or newerApple Safari 6 or newer30
Note: Ensure that your screen resolution is 1024 x 768 or higher. If your screen resolution isless than the minimum supported, some portions of the screen will not be visible.Other requirementsHelp ensure that the following additional requirements are met:If you want to use Microsoft IIS as the web server, you have configured it.The DBMS is installed and prepared for creating the Mart Database.The Mart database is created. At least one user with administrator privileges ispresent. You have run the initial queries on the Oracle database. For more information about the initial queries, see the Implementation Guide.If you want to add Windows Group users as Mart users, you have the Active DirectoryServer details.Note: You can add Windows Group users as normal Mart users, but not as Martadministrators. A Mart administrator must be a server or Windows u
SQL Server Support erwin Mart Server is now certified to work with SQL Server 2017. PostgreSQL Support erwin Mart Server is now certified to work with PostgreSQL v9.6.12, v10.7, and v11.2. Third Party T
CA ERwin Data Modeler for Microsoft SQL Azure (see page 16) This Release Notes details new features, enhancements, updates, and known issues for all editions of CA ERwin Data Modeler. Note: Depending on the edition of CA ERwin Data Modeler you are using, not all features may be enabled fo
CA ERwin Data Modeler for Microsoft SQL Azure (see page 14) This Release Notes details new features, enhancements, updates, and known issues for all editions of CA ERwin Data Modeler. Note: Depending on the edition of CA ERwin Data Modeler you are using, not all features may be enabled for use. For more information about the differences between .
The following editions of erwin Data Modeler are available: Academic Edition (see page 13) Standard Edition (see page 11) Workgroup Edition (see page 12) Navigator Edition (see page 13) This Release Notes details new features, enhancements, updates, and known issues for all editions of erwin Data Modeler. Note: Depending on the edition of erwin .
CA ERwin Data Modeler Workgroup Edition (see page 13) Model Life Cycle Frameworks (see page 14) CA ERwin Data Modeler Workgroup Edition CA ERwin Data Modeler Workgroup Edition provides a multiuser modeling environment that makes coordinated, large-scale modeling possible. It enables collaboration among
September 1907 in Huntsville at the residence of the bride’s parents. 2 Sara Erwin Hix, personal interview by author, Huntsville, AL, 13 November 2002. 3 Joseph (Joe) Erwin, Tryon, North Carolina, letter to author. 11 January 2003. 4 According to Sara Erwin Hix this church was West Huntsville United Methodist Church.Author: Michael Thomas Hix
Starting erwin Data Modeler (DM) 12.0, you can connect erwin DM to Git repositories via Mart Server. This enables you to push Forward Engineering (FE) scripts for a Mart Model to GitLab or GitHub. You cannot store FE scripts or DDL on a Mart Server but only erwin mod-els. With Git support you can adopt DevOps principles as you can commit FE .
and data types, key attribute (underlined), and some constraints. Notice that the key attribute must not be null. We are going to create ER diagram using this example. To start ERwin: 'Start All Programs CA AllFusion ERwin Data Modeler r7 ERwin Data Modeler r7‟ {Clicking this shortcut will open up ERwin}
plates to provide custom SQL output using erwin DM r7.3 and later. For the rest of this document, the term "templates" refers to the Forward Engineering and Alter Script templates. Templates were present in AllFusion erwin DM r7.0 through AllFusion erwin DM r7.2. However, as noted in the documentation of those releases, these
