Installation Guide PowerBuilder® Enterprise 11.
DOCUMENT ID: DC37771-01-1150-01 LAST REVISED: September 2008 Copyright © 2008 by Sybase, Inc. All rights reserved. This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. To order additional documents, U.S.
Contents About This Book ............................................................................................................................ v CHAPTER 1 Installing PowerBuilder Enterprise ............................................... 1 PowerBuilder Enterprise contents .................................................... 1 System requirements ....................................................................... 3 Product licensing with SySAM 2.0................................................
Contents iv PowerBuilder Enterprise
About This Book Audience This book is for anyone installing Sybase® PowerBuilder® Enterprise. How to use this book Read this book before you run the setup program to install PowerBuilder, InfoMaker®, and SQL Anywhere™. Related documents For a complete list of PowerBuilder documentation, see the preface of PowerBuilder Getting Started.
Sybase certifications on the Web Technical documentation at the Sybase Web site is updated frequently. ❖ ❖ ❖ Finding the latest information on product certifications 1 Point your Web browser to Technical Documents at http://www.sybase.com/support/techdocs/. 2 Click Certification Report. 3 In the Certification Report filter select a product, platform, and timeframe and then click Go. 4 Click a Certification Report title to display the report.
About This Book Padlock icons indicate that you do not have download authorization for certain EBF/Maintenance releases because you are not registered as a Technical Support Contact. If you have not registered, but have valid information provided by your Sybase representative or through your support contract, click Edit Roles to add the “Technical Support Contact” role to your MySybase profile.
viii PowerBuilder Enterprise
CH A PTE R 1 About this book Contents Installing PowerBuilder Enterprise This book explains how to install the PowerBuilder Enterprise product set on Windows XP, Windows Server 2003, Windows Vista, and Windows Server 2008. Topic PowerBuilder Enterprise contents Page 1 System requirements Product licensing with SySAM 2.0 3 4 Pre-installation tasks Starting the PowerBuilder 11.
PowerBuilder Enterprise contents Table 1-1: PowerBuilder 11.5 contents Additional license entitlements CD or DVD Getting Started CD Contents Customer Service Reference Guide, SyBooks Installation Guide, PowerBuilder and InfoMaker Release Bulletins, order card for printed documentation, and this Installation Guide. PowerBuilder DVD Common setup program for PowerBuilder 11.5 (all editions) and InfoMaker 11.5, setup program for SQL Anywhere 11.
CHAPTER 1 Installing PowerBuilder Enterprise System requirements This section provides system requirements for each product in PowerBuilder Enterprise. All tools require a DVD-ROM drive. The disk space requirements provided are approximate. The actual disk space you need for each tool might vary depending on hard disk size, partitioning, and the features you choose to install. Additional temporary space is required on the hard disk during installation for uncompressing install files.
Product licensing with SySAM 2.0 Product licensing with SySAM 2.0 PowerBuilder uses the Sybase Software Asset Management System (SySAM) for product licensing. If you have purchased PowerBuilder, you have either a standalone local license or a served license. For more information about licensing, see the SySAM Documentation at http://www.sybase.com/sysam. For troubleshooting help, see “Troubleshooting SySAM issues” on page 28.
CHAPTER 1 Installing PowerBuilder Enterprise Pre-installation tasks Before you install PowerBuilder Enterprise, you need to perform the following tasks: • Read the release bulletins for the latest information on the products that you are installing. Pay close attention to the “Special Installation Instructions” section. Release bulletins for PowerBuilder and InfoMaker are available in the product package on the Getting Started CD.
Pre-installation tasks For additional information about backing up and migrating existing applications, see “Before using PowerBuilder Enterprise” on page 24. Required software for PowerBuilder features Table 1-3 lists the software required for PowerBuilder Enterprise features. Some of this software is installed automatically when the feature is installed.
CHAPTER 1 Installing PowerBuilder Enterprise Feature Required software Notes .NET Web Forms development and deployment .NET Web Forms development and deployment AJAX extensions You can download and install the Microsoft ASP.NET AJAX Extensions version 1.0 from the ASP.NET Web site at http://www.asp.net/ajax/downloads/archive. Web Forms use these controls to display correctly and to provide functionality for the Tab, TreeView, and Toolbar controls. If you choose to install the .
Pre-installation tasks Feature Required software Notes Application server component development and deployment PowerBuilder Application Server Plug-in Version 1.1. Run the setup program in the PBVM directory on the PowerBuilder DVD to install PowerBuilder 11.5 runtime files in the server plug-in. JBoss 4.0.4, BEA WebLogic 9.2, or IBM WebSphere 6.1 For more information about the server plug-in, see the Web service clients Sun JDK 1.5 or later Microsoft .NET Framework Version 3.0 or 3.
CHAPTER 1 Installing PowerBuilder Enterprise Starting the PowerBuilder 11.5 setup program To install PowerBuilder Enterprise, insert the PowerBuilder DVD into your DVD drive. The setup program starts automatically. Installing from a downloaded image If you have downloaded an installable image from the Sybase Web site, run the autorun.exe file. If you run setup.exe, the procedure described in “Providing basic information” on page 11 starts and you will not be able to install SQL Anywhere.
Installing SQL Anywhere Installing SQL Anywhere Sybase SQL Anywhere is a fully-featured relational database and data management tool. The SQL Anywhere installation is restricted to development use only. Deployed systems require a separate SQL Anywhere license or the SQL Anywhere Runtime Edition (see “SQL Anywhere Runtime Edition” next).
CHAPTER 1 Installing PowerBuilder Enterprise 7 On the Ready to Install the Program page, select Install to begin the installation. 8 On the Setup Complete page, select the check box if you want to view the ReadMe file or the iAnywhere Online Resources page, and click Finish to return to the start page of the SQL Anywhere 11.0 setup program. Installing SQL Anywhere documentation If you want to install documentation for SQL Anywhere, select Install SQL Anywhere Documentation.
Providing basic information 3 On the License Type page, select the type of license you want to use and click Next. If you select Evaluation You can use PowerBuilder without purchasing a license for a 30 day testing period. When you click Next after selecting the Evaluation license type, the License Agreement page displays and you can continue with the installation at Step 5 of this procedure. The Evaluation license allows you to install the Enterprise edition of PowerBuilder for evaluation purposes only.
CHAPTER 1 Installing PowerBuilder Enterprise 6 On the Customer Information page, enter your name and your company’s name. 7 On the Choose Destination Location page, click Next to accept the destination path shown, or click Browse and select a different path, click OK, and click Next. 8 On the Choose Destination Location For Shared Files page, click Next to accept the destination path shown, or click Browse and select a different path, click OK, and click Next.
Installing InfoMaker Table 1-4: InfoMaker components Component InfoMaker Base Components InfoMaker Database Write Option Description Installs InfoMaker as a reporting and query tool only. No optional painters are installed. You cannot open forms in the InfoMaker tutorial library; those forms require use of the optional painters that are installed with the database write option. This option installs the ODBC driver.
CHAPTER 1 Installation procedure Installing PowerBuilder Enterprise The InfoMaker setup program installs InfoMaker in default drives and directories unless you specify otherwise. If a directory you specify does not exist, setup creates it. ❖ To install InfoMaker: 1 On the Choose Destination Location page, click Next to accept the destination folder path shown, or click Browse and select a different path, click OK, then click Next.
Installing PowerBuilder Installing PowerBuilder What to install The PowerBuilder setup program lets you choose which components to install. You must install the base components. Table 1-5 lists all the components.
CHAPTER 1 Component Description PowerBuilder Tutorial Source files for the tutorial in the Getting Started book. If you want to do the PowerBuilder tutorial or use the code examples, you must install SQL Anywhere 11.0 or later if it is not already installed on your computer. When you install PowerBuilder, the setup program creates an ODBC data source for the demo database.
Completing the setup program 3 On the Select Components page, clear the check box next to any components you do not want to install, and click Next. You can expand the tree view to select or clear subcomponents of top-level components, and click Select All or Unselect All to select or clear all the check boxes. You must select the PowerBuilder Base Components option. For information on what to select, see “What to install” on page 16.
CHAPTER 1 3 Installing PowerBuilder Enterprise On the setup program’s start page, choose to view the readme, Product Manuals Web site, or Sybase Web site, then click Exit to close the setup program. Network install The installation procedure presented above assumes you are installing from the PowerBuilder 11.5 DVD. If you are a system administrator, you might want to allow users to install PowerBuilder Enterprise from a network drive rather than from a DVD.
Completing the setup program Files reserved for Individual users Other writable files are installed in the default Program Files\Sybase subdirectories, but are copied to different locations the first time a user starts PowerBuilder. In this way, each PowerBuilder user gets a private copy of these files. The following table lists the files that are copied and updated in the directories of all users who run an instance of PowerBuilder.
CHAPTER 1 Installing PowerBuilder Enterprise Silent install and uninstall You can install and uninstall PowerBuilder 11.5 and the PowerBuilder virtual machine (PBVM) without displaying messages or windows during the setup or removal process. However, you must accept the Sybase license agreement before you can run the silent install file.
Silent install and uninstall All of the parameters for the silent install are optional. If you do not provide a value for the “lic” parameter, the installer searches the files in the installer directory in ascending alphabetic order for a valid license file. It uses the first valid license file it finds to install PowerBuilder and InfoMaker. If you do not provide the “lic” parameter and there is no license file in the installer search path, an evaluation version of PowerBuilder is installed.
CHAPTER 1 Installing PowerBuilder Enterprise When installing PowerBuilder, the silent install writes warnings to its log file if the setup computer does not have any of the following items: SQL Anywhere 11, Microsoft .NET Framework 2.0 or later, Microsoft .NET Framework 2.0 SDK or later, Microsoft IIS 5.0 or later, or AJAX Extensions version 1.0. When installing InfoMaker, the silent install includes a warning in the log file if the setup computer does not have a working copy of SQL Anywere 11.0.
Before using PowerBuilder Enterprise You run the PBVM silent uninstall by double-clicking the silentuninstall.bat file in the PBVM directory or running it from a command line. Before using PowerBuilder Enterprise Before you use PowerBuilder Enterprise, you might need to perform some additional migration or configuration tasks: • Migrating applications to PowerBuilder or InfoMaker 11.
CHAPTER 1 Installing PowerBuilder Enterprise Upgrading databases for jConnect for JDBC If you plan to use any of the products in PowerBuilder Enterprise with SQL Anywhere or Adaptive Server® Enterprise databases, including databases that were previously prepared for jConnect™ for JDBC™ 4.x, you need to prepare the databases for jConnect 5.5 by installing additional tables and stored procedures.
Before using PowerBuilder Enterprise ❖ To install the PBVM on EAServer or the Application Server Plug-in: 1 Run the setup.exe program in the PBVM directory on the PowerBuilder 11.5 DVD. 2 On the Choose Destination Location page, click Next if the default destination location is correct, or click Browse to navigate to the directory where EAServer or the Application Server Plug-in is installed and click Next.
CHAPTER 1 Installing PowerBuilder Enterprise Installing PostScript drivers If you want to use the distill method for saving DataWindows as PDF, you must have a PostScript printer or printer driver installed on your system. If you do not, use the Windows Add Printer wizard to add a PostScript printer. If you have never installed a PostScript printer, the Microsoft pscript5.dll file, which is required to add a PostScript printer, may not be available on your computer.
Troubleshooting SySAM issues Troubleshooting SySAM issues If you experience issues with your SySAM license, read this section to find information that might help you troubleshoot licensing issues, or help you collect information that Technical Support can use to diagnose licensing issues. You can find more information about SySAM licensing on the SySAM Web site at http://www.sybase.com/sysam and in the SySAM Documentation at http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.sysam/title.
CHAPTER 1 Installing PowerBuilder Enterprise Additional SySAM files The pb115_sysam.properties and PB115.lic files are installed in the same directory as PB.INI. On Windows XP and Windows 2003, these files are located in C:\Documents and Settings\All Users\Documents\Sybase\ PowerBuilder 11.5 and on Windows Vista and Windows 2008, in C:\Users\Public\Documents\Sybase\PowerBuilder 11.5. These files contain information that might be useful to Technical Support.
Removing a product Stopping the setup maintenance program Unlike the setup program, the setup maintenance program has no Back or Cancel button. Once you click Yes in the procedure below, the program cannot be stopped. ❖ To use the setup maintenance program to remove a product: 1 Make a backup copy of any files you might want to reuse (such as DB, INI, and PBL files) if you plan to reinstall. 2 Open the Control Panel from the Start menu and double-click the Add/Remove Programs icon.
Index A F Apache FO processor, required for XSL-FO save as PDF method 8 Application Server Plug-in, installing PBVM 25 ASA. See SQL Anywhere autorun.exe 9 FDCC.
Index L license additional product entitlements local 4 obtaining 4 providing information 11, 12 served 4 troubleshooting 28 2 pre-installation tasks 5 removing 29 required software 6 setup program 9, 11 system requirements 3 PowerBuilder Runtime Packager, requirements PowerDesigner plug-in, required software 8 product licensing SySAM 4 troubleshooting 28 8 M memory requirements 3 Microsoft .
Index SySAM product licensing 4 providing information troubleshooting 28 system requirements 3 11 T temp directory 5 TEMP environment variable 5 tutorials and examples, requirements 7 U uninstalling PowerBuilder Enterprise 29 W Web DataWindow, requirements Web services, installing 16 Installation Guide 7 33
Index 34 PowerBuilder Enterprise
