installation guide - sapinfocenter-archive.sybase.com/.../pdf/installation.pdf · enterprise...

Installation Guide

Sybase® PowerDesigner®

12.5Windows

Part number: DC38092-01-1250-01Last modified: April 2007

Copyright © 1991-2007 Sybase, Inc. and its subsidiaries. All rights reserved.

Information in this manual may change without notice and does not represent a commitment on the part of Sybase, Inc. and its subsidiaries.

Sybase, Inc. provides the software described in this manual under a Sybase License Agreement. The software may be used only in accordance withthe terms of the agreement.

No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, orotherwise, without the prior written permission of Sybase, Inc. and its subsidiaries.

Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for theDOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.

Sybase, SYBASE (logo), ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture, Adaptive Server, AdaptiveServer Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server Enterprise Replication, Adaptive ServerEverywhere, Advantage Database Server, Afaria, Answers Anywhere, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute,APT-Translator, APT-Library, ASEP, Avaki, Avaki (Arrow Design), Avaki Data Grid, AvantGo, Backup Server, BayCam, Bit-Wise, BizTracker,Certified PowerBuilder Developer, Certified SYBASE Professional, Certified SYBASE Professional Logo, ClearConnect, Client-Library, ClientServices, CodeBank, Column Design, ComponentPack, Connection Manager, Convoy/DM, Copernicus, CSP, Data Pipeline, Data Workbench,DataArchitect, Database Analyzer, DataExpress, DataServer, DataWindow, DataWindow .NET, DB-Library, dbQueue, Dejima, Dejima Direct,Developers Workbench, DirectConnect Anywhere, DirectConnect, Distribution Director, Dynamic Mobility Model, e-ADK, E-Anywhere, e-BizIntegrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, EII Plus, Electronic Case Management, Embedded SQL, EMS,Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager, Enterprise Portal (logo),Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement Accelerator,eremote, Everything Works Better When Everything Works Together, EWA, ExtendedAssist, Extended Systems, ExtendedView, Financial Fusion,Financial Fusion (and design), Financial Fusion Server, Formula One, Fusion Powered e-Finance, Fusion Powered Financial Destinations, FusionPowered STP, Gateway Manager, GeoPoint, GlobalFIX, iAnywhere, iAnywhere Solutions, ImpactNow, Industry Warehouse Studio, InfoMaker,Information Anywhere, Information Everywhere, InformationConnect, InphoMatch, InstaHelp, Intelligent Self-Care, InternetBuilder, iremote,iScript, Jaguar CTS, jConnect for JDBC, KnowledgeBase, Logical Memory Manager, lrLite, M2M Anywhere, Mach Desktop, Mail AnywhereStudio, Mainframe Connect, Maintenance Express, Manage Anywhere Studio, MAP, M-Business Anywhere, M-Business Channel, M-BusinessNetwork, M-Business Suite, MDI Access Server, MDI Database Gateway, media.splash, Message Anywhere Server, MetaWorks, MethodSet,mFolio, Mirror Activator, ML Query, MobiCATS, Mobil 365, Mobileway, MySupport, Net-Gateway, Net-Library, New Era of Networks, NextGeneration Learning, Next Generation Learning Studio, O DEVICE, OASiS, OASiS logo, ObjectConnect, ObjectCycle, OmniConnect, OmniQ,OmniSQL Access Module, OmniSQL Toolkit, OneBridge, Open Biz, Open Business Interchange, Open Client, Open ClientConnect, OpenClient/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions, Optima++, Partnerships thatWork, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, Pharma Anywhere, PhysicalArchitect, Pocket PowerBuilder, PocketBuilder,Power++, Power Through Knowledge, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner,PowerDimensions, PowerDynamo, Powering the New Economy, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio,PowerTips, Powersoft Portfolio, Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Pylon, Pylon Anywhere,Pylon Application Server, Pylon Conduit, Pylon PIM Server, Pylon Pro, QAnywhere, Rapport, Relational Beans, RepConnector, Report Workbench,Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Resource Manager,RFID Anywhere, RW-DisplayLib, RW-Library, SAFE, SAFE/PRO, Sales Anywhere, Search Anywhere, SDF, Search Anywhere, Secure SQLServer, Secure SQL Toolset, Security Guardian, ShareSpool, Sharelink SKILS, smart.partners, smart.parts, smart.script, SOA AnywhereTrademark,SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug, SQL Edit, SQL Edit/TPU, SQLEverywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART, SQL Toolset, SQL Server/CFT, SQL Server/DBM,SQL Server SNMP SubAgent, SQL Station, SQLJ, Stage III Engineering, Startup.Com, STEP, SupportNow, S.W.I.F.T. Message Format Libraries,Sybase 365, Sybase Central, Sybase Client/Server Interfaces, Sybase Development Framework, Sybase Financial Server, Sybase Gateways, SybaseIQ, Sybase Learning Connection, Sybase MPP, SyberLearning LIVE, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup,Sybase Synergy Program, Sybase Virtual Server Architecture, Sybase User Workbench, SybaseWare, Syber Financial, SyberAssist, SybFlex,SybMD, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular Data Stream, The Enterprise Client/Server Company, TheExtensible Software Platform, The Future Is Wide Open, The Learning Connection, The Model For Client/Server Solutions, The Online InformationCenter, The Power of One, TotalFix, TradeForce, Transact-SQL, Translation Toolkit, Turning Imagination Into Reality, UltraLite, UltraLite.NET,UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Unwired Accelerator, Unwired Orchestrator,Viafone, Viewer,VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL, WatcomSQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-Library, XA-Server, XcelleNet, XPServer, XTNDConnect, and XTNDACCESS are trademarks of Sybase, Inc. or its subsidiaries.

All other trademarks are the property of their respective owners.

ii

Contents

About This Manual v

1 Installing PowerDesigner 1Installation Options . . . . . . . . . . . . . . . . . . . . . . . . 2Installing PowerDesigner in Standalone Mode . . . . . . . . . 4Setting up a License Server . . . . . . . . . . . . . . . . . . . 13Installing PowerDesigner in Administrative Mode . . . . . . . 19Installing PowerDesigner in Silent Mode . . . . . . . . . . . . 22

2 Installing the Repository 25Repository Installation Options . . . . . . . . . . . . . . . . . 26Installing SQL Anywhere . . . . . . . . . . . . . . . . . . . . . 27Installing the Repository Proxy . . . . . . . . . . . . . . . . . 35

Index 41

iii

About This Manual

Subject

This book describes the installation procedures for:

♦ All modules in the PowerDesigner product line

♦ Sybase SQL Anywhere client and authenticated server to use with thePowerDesigner repository. If you already have SQL Anywhere, install ofcurrent version is not mandatory

♦ The PowerDesigner repository proxy

Audience

This book assumes that you are an experienced Windows user.

PowerDesigner modules

The combination of modules installed differs for each product in thePowerDesigner line. The example used in this installation guide is for agiven combination, however, the installation process is the same for allPowerDesigner products.

v

CHAPTER 1

Installing PowerDesigner

About this chapter This chapter describes how to install PowerDesigner.

Contents Topic: page

Installation Options 2

Installing PowerDesigner in Standalone Mode 4

Setting up a License Server 13

Installing PowerDesigner in Administrative Mode 19

Installing PowerDesigner in Silent Mode 22

1

Installation Options

Installation OptionsThis section explains the system requirements and various install options ofPowerDesigner.

PowerDesigner has the following minimum system requirements:

♦ Microsoft Windows XP,

Microsoft Windows Server 2003, or

Microsoft Windows Vista

♦ Pentium 500 MHz

♦ 256 MB RAM

♦ SVGA or higher-resolution graphics adapter and compatible colormonitor (800x600)

♦ CD-ROM drive

♦ Up to 500MB for installation of all the core modules that make up theStudio Enterprise Edition.

You can choose among the following installation modes:

♦ Standalone mode - is the typical install scenario, where PowerDesigneris installed directly on each client machine (see “InstallingPowerDesigner in Standalone Mode” on page 4).

♦ Administrative mode - installs PowerDesigner for use from a networkmachine (see “Installing PowerDesigner in Administrative Mode” onpage 19).

♦ Silent mode – allows you to deploy PowerDesigner on a large number ofmachines, using exactly the same setup options (see “InstallingPowerDesigner in Silent Mode” on page 22).

Depending on which version of PowerDesigner you have purchased, youwill be able to install one or more of the following modules:

♦ Requirements Model (RQM)

♦ Business Process Model (BPM)

♦ Conceptual Data Model (CDM)

♦ Physical Data Model (PDM)

♦ Information Liquidity Model (ILM)

2

Chapter 1. Installing PowerDesigner

♦ Object-Oriented Model (OOM)

♦ XML Model (XSM)

♦ Repository

♦ Free Model (provided with all PowerDesigner configurations)

♦ Reports (provided with all PowerDesigner configurations)

In addition to the standalone version, you can also install PowerDesignerplug-ins for use in the Eclipse and Visual Studio 2005 IDEs.

3

Installing PowerDesigner in Standalone Mode

Installing PowerDesigner in Standalone ModeStandalone mode is the standard method for installing PowerDesigner onone or more individual workstations. For mass installations and networkinstallation, see “Installing PowerDesigner in Silent Mode” on page 22 and“Installing PowerDesigner in Administrative Mode” on page 19.

Non-AdministratorsNon-Administrator users may receive a warning message during installa-tion. Setup requires write access on certain directories and on the registrythat a non-Administrator user may not have. Setup can go on despite thismessage.

v To install PowerDesigner in standalone mode

1. Insert the PowerDesigner CD-ROM in your drive.

If setup does not automatically start, then double-click the SETUP.EXEfile in the setup directory of the CD-ROM.

2. Click the Install PowerDesigner 12.5 button to open the welcome page,and then click Next to go to the license selection page:

3. Select one of the following license types, and then click Next to go to thelicense agreement page.

♦ Trial version – is a full-featured version, valid for an evaluation periodof 15 days, that allows you to perform any design task. Contact Sybaseif you require a limited extension.

4


♦ Local standalone license – is installed on and locked to a particularmachine. Click next to go to the license key page, where you must loada valid license file (see “Obtaining a license key file” on page 10).

♦ Served standalone license – is provided by one or more SySAMlicense servers, and is locked to a particular machine. Click Next to goto the license server page, where you must enter the name of yourlicense server.

♦ Served floating license – is provided by one or more SySAM licenseservers, which manage the allocation and recuperation of licenses

5


among a pool of users. Click Next to go to the license server page,where you must enter the name of your license server.+ For more information about PowerDesigner licensing, see the“Managing PowerDesigner Licenses” chapter in the General FeaturesGuide .

4. [for served licenses] Click Next to go to the package selection page,where you can select which package to install. The list displays all thepackages that are available on the server but it does not necessarily reflectthe availability of a license for a particular package:

5. Click Next to go to the License Agreement page. Select the locationwhere you are installing the software, read the License Agreement, andthen click the I Agree radio button to accept the terms of the agreement.If you click I Do Not Agree, you cannot proceed with the Setup programand you have to cancel install.

Printing the License AgreementYou can print the License Agreement from the Setup\Licenses directoryon the product CD.

6. Click Next to go to the directory selection page, where setup suggests adirectory in which to install PowerDesigner files. You can specify analternate directory by clicking the Browse button.

For major versions, this directory is different from the directories forprevious major versions of PowerDesigner. We recommend that you do

6


not install a new major version of PowerDesigner in a directory that holdsa previous version.

7. Click Next to go to the component selection page, which lists theproducts and features that are available to install. Each node can beexpanded in order to let you select or deselect sub-features:

8. Select or clear check boxes to add or remove products or features andclick Next.

If you have Microsoft Visual Studio 2005 and Team Foundation installed

7


on your computer, you can select the Visual Studio 2005 plug-in and itsfeature Team Foundation for installation.

Modify installWhen modifying an install, if you deselect a check box, the featurewill be removed (see “Uninstalling PowerDesigner and InstallationMaintenance” on page 11).

If you selected the Eclipse 3 plug-in in the list of components, the Eclipsedirectory selection page is displayed. Click the Browse button to specifya directory containing a valid Eclipse 3.1 or higher installation.

Upgrading the Eclipse pluginIf you had manually installed the Eclipse plug-in in PowerDesignerversion 10 or 11 and want to upgrade to version 12.x you have toremove the plug-in manually. To do so, open the Eclipse directory,and remove any PowerDesigner-related folder under the \configuration,\features, and \workspace\.metadata\.plugins folders.

9. Click Next to go to the Program Folders page. You can select the defaultfolder, or select or create another:

8


10. Click Next to go to the Current Settings page, which lists all yourselections. Select the Keep PowerDesigner Settings check box to retainany settings from a previous version of PowerDesigner.

11. Click Next to begin the install. Setup begins copying files to thedestination directory.

12. Wait for the setup complete page to appear and click Finish.

Depending on your working environment, Setup may ask you to rebootyour machine.

9


Readme.htmlThe Readme.html file contains important release information. You canopen it using a text editor from the /PowerDesigner directory by default.

Obtaining a license key file

You must have a license key file to install PowerDesigner. License files canbe downloaded on the Sybase Product Download Center site (SPDC) athttps://sybase.subscribenet.com/.

♦ When you purchase PowerDesigner from Sybase, you receive an E-mailwith an URL, your login, and your password for the SPDC.

♦ When you purchase PowerDesigner from a Sybase reseller, you receive acertificate with a Web key registration number and a download URL.

Host ID Before accessing the download site, make sure you know your licenseconfiguration, the host ID and the name of the computer that will receivethe license key file. You can find the host ID and the computer name in theInstallation program, these details are automatically calculated anddisplayed in the third page of the installation where you are asked to load orcopy a license file to proceed.

For Windows platforms, if your machine does not have a network adapter analternate Hostid of type Disk Serial Number is supported. To get this host id,use the “lmutil lmhostid -vsn”command or get the disk’s volume serialnumber by executing “DIR C:”, remove “-” from the value and prefix“DISK_SERIAL_NUM=“ to the serial number to get the host id.

Each host ID type has valid formats that will be checked when generating alicense. Make sure the value entered matches these valid formats.

Ethernet addresses are 12 character hex values consisting of digits 0 through9 and characters A through F. They may be entered in any of the followingformats:

♦ 12AB34CD56EF

♦ 12-AB-34-CD-56-EF

♦ 12:AB:34:CD:56:EF

Host Ids are 8 character hex values consisting of digits 0 through 9 andcharacters A through F. They may be entered in the following formats:

♦ 12AB34CD

♦ 12AB-34CD

10


Note: For some platforms, host IDs can also be entered in decimal formats,in this case prefix the host id with a “#” sign. Example: #1039716963

Disk Serial Number is always entered with a “DISK_SERIAL_NUM=“prefix. For example: DISK_SERIAL_NUM=3e2e17fd

Manual fonts installation

If setup fails to define default fonts, you can do it manually. You shouldperform the following modifications:

1. Select the Fonts page in the General Options dialog box and define fontsfor UI, Code and RTF Editor.

2. Create a new report, select Report ä Change Font and define new fonts.

3. Verify that the following registry key does not exist:HKEY_CURRENT_USER\Software\Sybase\PowerDesigner12\DisplayPreferences\Font Name.

4. Create a registry key named Font Name (with the following string values:Name, Size, Style) for all symbols in the following registry key:HKEY_LOCAL_MACHINE\Software\Sybase\PowerDesigner12\DisplayPreferences\Font Name.

Uninstalling PowerDesigner and Installation Maintenance

After installing PowerDesigner on your machine, you access installationmaintenance when you select Control Panel ä Add/Remove Programs orwhen you restart installation.

The maintenance dialog box does not let you modify the type of licenseinstalled on your machine, you can only use it to add or remove componentsin the current PowerDesigner installation.

11


This mode allows you to perform the following:

♦ Modify the current installation in order to remove or add programfeatures on your current install. Select or clear components in thecomponents page.

♦ Repair the current installation. This option allows you to reinstall thesame PowerDesigner configuration as previously installed on yourmachine. You need to have the software CD or access to the networkdrive where installation files are copied to repair your current installation.

♦ Remove the current installation and clean up your registry. You do notneed the software CD or access to the network drive in this case.

Note that user files are not removed.

12


Setting up a License ServerYou need a license server when you have selected to install a standaloneserved or a floating served license. The license server allows you to shareand control licenses within a pool of users.

The license server controls license availability and allows you to use licensesas needed; in floating mobile mode the server also allows you to borrow andreturn licenses.

The license server also blocks use when all licenses are being used.However, it is possible to exceed the total number of purchased licenses by a10% overdraft. This is to let your organization operate temporarily out ofcompliance in order to maintain day to day operations while obtaining newlicenses and also to help you measure the new licenses needed to achievecompliance.

The license server program is available on the PowerDesigner CD-ROM.

License server and PowerDesigner applicationDo not install a license server and PowerDesigner on the same workstation.

Served licenses limitation If you are using a standalone served or a mobile floating license and youwork disconnected from the server, and if your workstation hosts otherproducts that also use Flexlm served licenses, you may have problems forreturning your license to the server.

Installing a license server

If a Flexlm license server (SYSAM) is already installed, PowerDesignerlicense server will be installed on the same server, otherwise aPowerDesigner license server is installed.

A Flexlm license server installed with PowerDesigner version 11 does nothave the same service name as a server for version 12.x and cannot readversion 12.x license files. If you no longer use the version 11 license server,we recommend that you remove it.

Prerequisites You need a license file to install the license server (see “Obtaining a licensekey file” on page 10).

+ For more information about SySAM, seehttp://sybooks.sybase.com/nav/detail.do?docset=833.

Diagnostic programs Lmutil.exe and lmtools.exe located in the \\SYSAM-2_0\Bin folder areprograms provided to help you diagnose problems you may encounter wheninstalling the Flexlm license server.

13

http://www.sybase.com/sysam

Setting up a License Server

+ For example, the following command can be used to find the user(s)who have currently borrowed the license(s):

lmutil lmstat -a -c <port>@<host> where <port> and <host> arelicense server information.

+ For more information about Flexlm and additional examples of theseprograms, see http://infocenter.sybase.com/help/index.jsp?topic=/com.-sybase.help.doc.ase_15.0.flexnet/html/title.htm .

v To install a license server

1. Click the Install Licenses Server button to open the Sybase SoftwareAsset Management for PowerDesigner wizard:

2. Click Next to display the license agreement page. Read the LicenseAgreement and click the I Agree radio button to accept the terms of theagreement. If you click I Do Not Agree, the installation will be cancelled.

3. Click Next to display the license file definition page.

4. Click the Load button if you already have a license file and browse to thefolder where your license file is located. The content of the license file isautomatically displayed in the License key box.

or

Download a license file from SPDC and copy the file content into theLicense Key box.

14

http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.doc.ase_15.0.flexnet/html/title.htm



5. Click Next.

The destination folder page is displayed if no other Flexlm license server(SYSAM) is detected. If another Flexlm license server exists on thecurrent machine, the destination folder page is skipped.

6. Click Next to accept the suggested destination folder.

or

Click Browse, select a different destination folder, and click Next.

15


The start copying files page is displayed:

7. Click Next to accept the current settings and start copying files.

The copy starts. A progress box is displayed and Setup copies files to thedestination directory.

The InstallShield Wizard Complete page is displayed.♦ If no other Flexlm server existed on the current machine you can

choose to start the license server as a service.

16


♦ If the PowerDesigner license server was installed on an existing licenseserver, you can choose to reread licenses in order to refresh the serverlicense file.

8. Click Finish.

Managing the license server

You can manage the license server from a specific interface.

v To manage the license server

1. Double-click lmtools.exe in the \\SYSAM-2_0\Bin folder.

The LMTOOLS dialog box is displayed to let you manage Flexlmservers.

2. Select SYSAM in the list of servers to configure using services.

3. Click the Start/Stop/Reread tab to display the Flexlm licenses Servicesinstalled on the server machine.

4. Click the Reread License File button to force the server to read again thefile sybpdes.lic and update license number.

5. Select File ä Exit to close the LMTOOLS dialog box.

6. Start PowerDesigner.

+ For more information about SySAM, you can look at the following Webaddress http://sybooks.sybase.com/nav/detail.do?docset=833.

+ For more information about Flexlm, you can look at the following Webaddress http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.-help.doc.ase_15.0.flexnet/html/title.htm.

17

http://www.sybase.com/sysam




Using SAMreport

SAMreport is a report generator that helps you report the usage of licenseson the server. SAMreport produces license usage reports based on licenseusage activity recorded in the FLEXnet report logs and on selected criteriaincluding product and feature name, user, date and time, display or host.

The SAMreport install program and the Flexnet Licensing End User Guidedocumentation are provided on the PowerDesigner CD under the \samreportfolder.

Sybase.opt To use SAMreport, make sure you create a file sybase.opt in the serverlicense file folder. This file should contain a line for accessing the report log:

REPORTLOG [+] report_log_path

18


Installing PowerDesigner in Administrative ModeSystem administrators can install PowerDesigner on a server and have clientmachines run the application from this central install. The client machinesdo not install any files but their registry is modified in order to be able toaccess PowerDesigner from the specified location. With this type ofadministrative mode install, there is only one instance of PowerDesigner todeploy and upgrade.

You can install any type of PowerDesigner license and specify anycombination of installation options on each client machine.

Creating the administrative install on the server

The first part of the administrative install consists in copying thePowerDesigner files to a server. You are not required to enter any productkey or select any feature to install. All PowerDesigner setup files aredecompressed and copied to the server, but the server registry and systemfiles will not be affected.

v To copy the files to the server

1. Insert the CD-ROM in the drive to automatically launch the setupprogram. The initial setup dialog box is displayed. Click theAdministrative Installation button.

or

Select Start ä Run, type the PowerDesigner setup.exe path followed by /ain the Run dialog box and click OK.

The welcome page is displayed:

19

Installing PowerDesigner in Administrative Mode

2. Click Next to display the network location page:

3. Specify the network location where you want to copy the product files,and then click Install.

The setup status page displays a progress box while the files are copied tothe destination directory. When this process is complete, the Completepage opens.

4. Click Finish to exit the InstallShield Wizard.

20


Installing client machines

Once you have created the administrative install on the server, you can set upthe client machines. The client install modifies the registry of the clientmachine in order to be able to reference the files located on the server, butdoes not copy any file onto the client machine. Consequently no space isrequired on the client machine.

v To install a client machine

1. On the client machine, open Windows Explorer, connect to the networklocation where you have created the administrative install anddouble-click the Setup.exe file.

The welcome page is displayed.

2. Click Next to open the license selection page, select a license type, andthen click Next again.

3. Define the appropriate installation parameters on the following pages,and then click Finish to begin the install.

Depending on your working environment, Setup may ask you to rebootyour machine.

+ For detailed information about license types and other setup parameters,see “Installing PowerDesigner in Standalone Mode” on page 4.

Upgrading an administrative install

If you want to pass the administrative install command to an upgradepackage downloaded from the web, you have to use the following syntax:

<name of the executable file.exe> -a <argument>pdupgrade.exe -a /a

Where -a is used to specify that command </a> is targeted to the executablefile within the downloaded package pdupgrade.exe.

21

Installing PowerDesigner in Silent Mode

Installing PowerDesigner in Silent ModeIf you need to deploy PowerDesigner on a large number of machines andwish to reuse exactly the same setup options and destination folder for eachmachine, you can use the silent install mode. Silent install runs without userinput, by using a response file (called setup.iss) that specifies all therequired installation options.

Installation log The silent installation mode does not provide any information about theinstallation itself. You can open the setup.log file in the directory containingthe setup.exe file to have a report about the silent install. The last section ofthis file called ResponseResult contains a line ResultCode=X, whichindicates whether the installation is successful. If X=0, installation wassuccessful.

CD or network locationYou can perform a silent install from the product CD or from a networklocation where the PowerDesigner installation files have been copied.

v To perform silent installs

1. To create a setup.iss response file, select Start ä Run to open theWindows Run dialog box and enter the following command:<PD-inst-dir>\setup\setup.exe /r /f1”<path>\setup.iss”

Complete the installation parameters as required and then click Finish tocreate the setup.iss file at <path>. For example, the following:

G:\setup\setup.exe /r /f1"setup.iss"

References a network drive G:, mapped to a location where thePowerDesigner files have been copied, and creates setup.iss in the setupdirectory for easy access.

1. Proceed to install the client machine with the following command:<PD-inst-dir>\setup\setup.exe /s /f1”<path>\setup.iss”.

Each new silent install will replace the content of the setup.log filelocated in the Installation drive.

Use the /f2 parameter to define a local directory where the setup.log filewill be stored on each client machine: G:\setup\setup.exe /s/f2”c:\temp\setup.log”

22


Silent installation of administrative modeFrom a client machine, map a drive to the server where the PowerDesignerfiles are copied. The drive letter must be the same as that on the server. Forexample, if your PowerDesigner files are located on drive R:\admin\setup.-exe, you must use the R drive on each client machine to access installationfiles.

Uninstalling PowerDesigner in Silent mode

A silent uninstall works in a similar fashion to the silent install, but requiresthat you locate the InstallShield PowerDesigner maintenance file. ForPowerDesigner v12.x this file is located, by default, at:

C:\Program Files\InstallShield Installation Information\{DA53ABD7-6592-45DA-A6DD-287A48F74D37}\setup.exe

Locating non-standard InstallShield maintenance filesIt may be that your maintenance file is not found in thestandard location. You can always retrieve its locationfile from the following registry key: HKEY_LOCAL_-MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{DA53ABD7-6592-45DA-A6DD-287A48F74D37}

v To perform silent uninstalls

1. To create an uninstall.iss response file, select Start ä Run to open theWindows Run dialog box to invoke the installshield maintenance file withthe following options: <path-to>\setup.exe /r /f1”<path>\uninstall.iss”

Complete the installation parameters as required and then click Finish tocreate the uninstall.iss file at <path>. For example, the following:

C:\Program Files\InstallShield Installation Information\setup.exe /r /f1"C:\temp\uninstall.iss"

Uses the standard maintenance file, and creates uninstall.iss in a tempdirectory.

1. Proceed to uninstall the client machine with the following command:<path-to>\setup.exe /s /f1”<path>\uninstall.iss”

23

CHAPTER 2

Installing the Repository

About this chapter This chapter explains how to set up the PowerDesigner repository server andclient, and also the optional repository proxy.

Contents Topic: page

Repository Installation Options 26

Installing SQL Anywhere 27

Installing the Repository Proxy 35

25

Repository Installation Options

Repository Installation OptionsThe PowerDesigner repository can be used to store your PowerDesignermodels and other files relating to your design projects.

An authenticated copy of Sybase SQL Anywhere is provided with thePowerDesigner repository module for use as the repository database server.This chapter provides instructions on installing SQL Anywhere, along withthe repository proxy.

Alternatively, you can host a repository database (with, or without the proxy)using any of the following supported databases via an ODBC connection:

♦ Oracle 7 and higher

♦ IBM DB2 Common Server and DB2 for OS/390

♦ Sybase Adaptive Server Enterprise

♦ Sybase SQL Anywhere

♦ Informix 2000

♦ Microsoft SQL Server 7 and higher

In addition, the following databases are supported via a native connection:

♦ Oracle 7 and higher

♦ Microsoft SQL Server 2000 and higher

+ For information about setting up a repository, see the Getting Startedwith the Repository chapter in Working with the Repository .

26

Chapter 2. Installing the Repository

Installing SQL AnywhereThe PowerDesigner repository is delivered with an authenticated version ofSybase SQL Anywhere, which can only be used to store yourPowerDesigner model repository.

PowerDesigner Trial versionThe trial version of PowerDesigner is supplied with a lighter version ofSQL Anywhere, for which the setup may be slightly different.

Installing SQL Anywhere on your repository server

v To install the SQL Anywhere authenticated server

1. Insert the software CD-ROM in the drive, and click the Install SQLAnywhere button. Choose your setup language, and then click Next toopen the SQL Anywhere InstallShield wizard

2. Click Next to go to the License Agreement page. Select your country orregion, review and accept the license terms, and then click Next to go tothe Choose Location page.

3. Accept the default install location or select one using the Browse button,and then click Next to go to the Choose Samples Location page.

4. Accept the default install location or select one using the Browse button,and then click Next to go to the Select Components page:

27

Installing SQL Anywhere

5. Accept the default components, and click Next to go to the ServerLicense page:

6. Enter your total number of PowerDesigner licenses in the Licensed Unitsfield, verify that the Networked Seat (per-seat) model radio button isselected, and then click Next to go to the Select Program Folder page.

7. Accept the default or enter a new folder name, and click Next to go to theStart Copying Files page, which summarizes your installation optionchoices:

28


8. Click Next to start the install. A status bar is displayed showing progress.

9. When the installation of the main program files is complete, you will beinvited to install documentation. Accept the default options and clickNext to continue.

10. When the documentation installation is complete, the Setup Completepage opens, inviting you to view the ReadMe and online resources. Makeyour choices and then click Finish to open the InstallShield WizardComplete page.

11. Select the Yes radio button and click Finish to restart your computer andcomplete the installation.

+ For information about setting up a repository, see the Getting Startedwith the Repository chapter in Working with the Repository .

Authenticating databases

You must create a database to store the repository tables in the server.

When you install the authenticated version of SQL Anywhere, existingdatabases and new databases cannot be used with the authenticated serverbecause these databases are not authenticated.

You have to perform the following actions to be able to use a database withthe authenticated server.

Authenticate any newdatabase

If you want to automatically authenticate any new database, you have tocopy the contents of the script authdb.sql delivered with the repositoryunder \Tools, into the file saopts.sql under \Script in the SQL Anywheredirectory, on the server machine.

The authentication string included in this file will let you use any newdatabase with the repository as soon as you create it.

Authenticate existingdatabase

When you install the authenticated version of SQL Anywhere, you cannotuse existing databases with the repository since they are not authenticated.However, you can authenticate these databases by executing the scriptauthdb.sql delivered with the repository under \Tools. This will let youuse the repository with any existing database.

v To execute the authdb.sql script on an existing database

1. Start Interactive SQL (dbisql.exe).

2. Type dba in the User ID box.

3. Type sql in the Password box.

29


4. Enter the data source name in the ODBC Data Source Name box.

5. Select the Database tab and click the Browse button.

6. Double-click the existing database in the file selection window, the filepath should appear in the Database File box.

7. Click OK.

The Interactive SQL window is displayed.

8. Open the script authdb.sql and execute it.

9. Close Interactive SQL.

This should stop the server. Your database is now authenticated and youcan start it to use it with the repository.

Creating a database

The following procedure explains how to create a database for the repositoryon your repository server.

30


v To create a database using Sybase SQL Anywhere

1. Navigate to the SQL Anywhere 10 program group and open SybaseCentral or run the SCJVIEW.EXE executable in the Sybase Centraldirectory.

2. In the Sybase Central window right-hand Plug-ins tab, double-click theSQL Anywhere 10 item to access its tools and features:

3. Click on the Tools button, and select Create Database from the list toopen the Create Database Wizard.

4. Click Next to go to the Select a Location page. The Create a database onthis computer is automatically selected. Click Next to go to the Specify aDatabase File page:

31


5. Click Next to go to the Specify the Transaction Log File page:

6. Make sure the check box Maintain the Following Transaction Log File isselected, accept or specify an alternate log file name and location, andthen click Next.

7. Continue clicking Next and accepting the default settings until you arriveat the Specify DBA User and Password page:

32


8. By default, the database is created with a super-user called DBA, andwith a password “sql”. Select these defaults or provide your ownparameters (being sure to remember them for later), and then click Nextto go to the Connect to the Database page.

9. Click Finish to create the database. A message box displays the progressand informs you when the creation is complete.

Installing the SQL Anywhere client on client machines

You must install the SQL Anywhere client on all machines that will accessthe repository database on the server.

v To install the SQL Anywhere client

1. Insert the software CD-ROM in the drive, and click the Install SQLAnywhere button.

2. Click Next to go to the License Agreement page. Select your country orregion, review and accept the license terms, and then click Next to go tothe Choose Location page.

3. Accept the default install location or select one using the Browse button,and then click Next to go to the Choose Samples Location page.

4. Accept the default install location or select one using the Browse button,and then click Next to go to the Select Components page:

33


5. Deselect all components except Network Database Client (inside SQLAnywhere), and then click Next to go to the Select Program Folder page.

6. Accept the default or enter a new folder name, and click Next to go to theStart Copying Files page, which summarizes your installation optionchoices.

7. Click Next to start the install. A status bar is displayed showing progress.

8. When the installation is complete, the Setup Complete page opens,inviting you to view the ReadMe and online resources. Make yourchoices and then click Finish to open the InstallShield Wizard Completepage.

9. Select the Yes radio button and click Finish to restart your computer andcomplete the installation.

+ For information about connecting to a repository, see the Getting Startedwith the Repository chapter in Working with the Repository .

34


Installing the Repository ProxyThe Repository is as a client-server application, in which the Client issuesSQL statements via an ODBC connection to be executed on the databaseserver. While such a system provides acceptable performance on a LocalArea Network (LAN), it may be less effective on a Wide Area Network(WAN).

SQL statements require several network packets, each of which must goback and forth before the next one is issued. While a LAN connectiontypically has a ping time of less than 10ms; a WAN connection (passingthrough the Internet via a Virtual Private Network (VPN) connection) has atypical ping of over 100ms.

+ The PowerDesigner repository proxy is intended to run on either therepository server (if it is a Windows machine) or on the same LAN. Clientsconnect to it from elsewhere in the WAN using a dedicated protocol, and itcan pool client requests, and provides a metadata cache, all of which reducenetwork communication and improve client response times.

Before you set up the repository proxy, you must install the repository (see“Installing SQL Anywhere” on page 27).

Next you should choose whether to install the repository proxy on therepository server, or on another windows machine on the same LAN, andthen accomplish the following steps:

♦ “Creating an ODBC system data source on the proxy server” on page 35on the proxy server

♦ “Installing the repository proxy on the proxy server” on page 36

♦ “Configuring the repository proxy” on page 39

After installation is complete, you can set up client machines to connect tothe repository via the proxy. See the Getting Started with the Repositorychapter in Working with the Repository .

Creating an ODBC system data source on the proxy server

The ODBC data source defines the connection between the proxy and therepository database. You must create a system (and not a user) data sourcefor the proxy to communicate with the repository.

35

Installing the Repository Proxy

v To define a system data source

1. Select Start ä Settings ä Control Panel ä Administrative Tools ä DataSources (ODBC) to open the ODBC Data Source Administrator window.

2. Click the System DSN tab, and then click the Add button.

3. Select the driver corresponding to your DBMS.

4. Click Finish.

The configuration box is displayed. Generally, you will have to declarethe data source name together with the name of the server where thedatabase is installed.

You may also be prompted to type the name of the user that will connectto the database and a password.

5. Test the connection if applicable and then save the new DSN by clickingOK to return to the System DSN page, where your new data source isdisplayed in the list.

6. Click OK to close the ODBC Data Source Administrator window.

Installing the repository proxy on the proxy server

The repository administrator is generally responsible for installing therepository proxy.

We recommend that you install the repository proxy on the same computeras the database or at least on the same LAN.

36


v To install the repository proxy

1. Insert the PowerDesigner software CD-ROM in the drive, and then clickthe Install PowerDesigner Repository Proxy button.

The Repository Proxy installation program opens to the Welcome page.

2. Click Next to go to the license agreement page, and select the locationwhere you are installing the software. Read the License Agreement andclick the I Agree radio button to accept the terms of the agreement. If youclick I Do Not Agree, you cannot proceed with the Setup program andyou will have to cancel the install.

Printing the License AgreementYou can print the License Agreement from the Setup\Licenses directoryon the product CD.

3. Click Next to go to the directory selection page. Setup suggests a locationin which to install the Proxy, which you can change by clicking theBrowse button.

37


4. Click Next to go to the Current Settings page which shows your choices:

5. Click Next to accept the current settings and start copying files.

The copy starts. A progress box is displayed and Setup copies files to thedestination directory. When the setup is complete, the following pageappears with two checkboxes selected by default, to let you start theproxy service and launch the configuration tool.

38


6. Click Finish to exit setup.

The Repository Proxy Configuration dialog box opens to let youconfigure the repository proxy (see “Configuring the repository proxy”on page 39).

Configuring the repository proxy

The Repository Proxy Configuration dialog box allows you to configure therepository proxy. This configuration phase simplifies the client connection tothe repository. When connecting to a repository, the client only has to selecta proxy repository definition in which the name of the proxy server, its portnumber and the instance of the proxy are specified.

The Repository Proxy Configuration dialog box can be divided into twomain parts:

♦ The Instances group box (on the left part), in which you enter all theparameters to create a new instance. You can also delete instances.

♦ All other group boxes (on the right part), such as Connection, Log file orCache allow you to parameter the Proxy itself. These group boxes aregenerally defined once for all instances

You have to enter the following parameters in the Repository ProxyConfiguration dialog box:

39


Groupbox Parameter Description

Instances New Delete An instance gathers the connection informa-tion between the proxy and the databaseserver. Click the New button to createan instance of the proxy for the repositorydatabase. Each time you create an instancewhile the repository proxy is already running,you must stop it and restart it again for the in-stance to be taken into account. You can alsoselect an instance in the Instances box andclick the delete button to delete an instance.

Name Name of the instance selected in the Instancesbox.

Data source Name of the system ODBC data source thatspecifies the database to use to connect to theserver. Note that user data source cannot beused by the proxy server

User Name of the user ID with which you log on tothe database on the proxy server.

Password Password for the connection to the databaseon the proxy server.

Connec-tion

Port Connection port of the server on which theproxy is installed and which allows the clientto communicate with the server using TCP/IPprotocol. The default port number is 32999.

Log file Log operationsIncluding suc-cess

Select the Log operations check box, if youwant to generate a log file. Select the Includ-ing success checkbox to display success in thelog file.

Cache Directory Path to the folder where you want to savethe cache. You can click the Question Markbutton to browse for a folder.

Max size Maximum value for the cache size. Thedefault value is 300MB.

Now that configuration is complete, you can set up client machines toconnect to the repository via the proxy. See the Getting Started with theRepository chapter in Working with the Repository .

40

Index

Aadministrative

mode 2administrative install 19

client 19client license 21copy files on server 19install client machines 21server 19

authdb.sql 29authenticate

existing database 29new database 29

Cclient

install 21SQL Anywhere 33

computer name 10copy files on server 19create

system data source 35create database 29, 30

Ddatabase

authenticate 29create 29, 30existing 29new 29

diagnostic program 13disk space 19

EEclipse plug-in 8

Ffloating served license

impossible to return 13limitation 13

fontgeneral options 11report 11symbol 11

Ggeneral options font 11

Hhard disk space 2host ID 10

Iinstall

administrative mode 2, 19authenticated server 27BPM 2CDM 2client machine 21copy files on server 19Eclipse plug-in 8font problem 11free model 2ILM 2license server 13maintenance 11maintenance mode 2modes 2network location 20non-administrator user 4OOM 2PDM 2PowerDesigner 4report 2repository 2, 26repository proxy 35, 36RQM 2SAMreport 18silent 22silent mode 2SQL Anywhere 27

41

Index

standalone mode 2upgrade administrative version 21Visual Studio 2005 plug-in 8XSM 2

Llicense agreement 6, 37

print 6, 37license file 10license server

install 13installation 13license file 13manage licenses on server 17reread 16SAMreport 18start 16

LMTOOLS 13, 17LMUTIL 13, 17

Mmaintenance

license 11mode 2modify 11remove 11repair 11

modify install 11

Nnetwork location 20non-administrator user 4

OODBC

SQL Anywhere 33ODBC system data source 35

PPowerDesigner

current setting 9install 4module 2README 9requirement 2

what to install 2proxy

cache 39configure 39connection 39instance 39log file 39

RRAM

PowerDesigner 2readme.html 9remove install 11repair install 11report font 11report log 18repository

create ODBC system data source 35install 26, 27, 35

repository proxycache 39configure 39connection 39install 36instance 39log file 39

requirementPowerDesigner 2system 2

reread license file 17reread license server 16response file 22return

floating served license 13standalone served license 13

SSAMreport 18

report log 18sybase.opt 18

saopts.sql 29SCVIEW.EXE 29served license

SAMreport 18server

check disk space 19copy files 19

42

Index

install 27install license server 13manage licenses 17SQL Anywhere 27

settingsPowerDesigner 9

setup.iss 22setup.log 22silent

mode 2silent install 22

response file 22setup.iss 22setup.log 22standalone local 22

SPDC 10SQL Anywhere

authenticated server 27client 33create database 29install 27network authenticated server 27ODBC 33repository 27

standalonemode 2

standalone local licenselicense file 10silent installation 22

standalone served licenseimpossible to return 13limitation 13

start license server 16Sybase Central 29Sybase Product Download Center 10sybase.opt 18symbol font 11

Uupgrade

administrative install 21

VVisual Studio 2005 plug-in 8

43

installation guide - sapinfocenter-archive.sybase.com/.../pdf/installation.pdf · enterprise...

Documents