PowerBuilder-InstallationGuide
PowerBuilder-InstallationGuide
PowerBuilder® 12.0
DOCUMENT ID: DC37771-01-1200-01
LAST REVISED: April 2010
Copyright © 2010 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. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617)
229-9845.
Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All
other international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at
regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any
form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase,
Inc.
Sybase trademarks can be viewed at the Sybase trademarks page at [Link] Sybase and
the marks listed are trademarks of Sybase, Inc. A ® indicates registration in the United States of America.
Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other
countries.
Unicode and the Unicode Logo are registered trademarks of Unicode, Inc.
All other company and product names used herein may be trademarks or registered trademarks of the respective companies
with which they are associated.
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 the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
Sybase, Inc., One Sybase Drive, Dublin, CA 94568
Contents
Installation Workflow ..............................................1
Planning Your Installation .........................................3
Installation Media Contents .................................3
System Requirements ........................................4
Obtaining a License ..........................................5
SySAM Troubleshooting ................................5
Software Requirements ......................................6
Preinstallation Tasks .............................................11
Starting the Common Setup Program .........................13
Providing Basic Information ....................................15
Installing SQL Anywhere .........................................17
About SQL Anywhere ........................................17
Installing InfoMaker ...............................................19
InfoMaker Components .....................................20
Installing PowerBuilder .........................................21
PowerBuilder Components .................................22
Completing the Setup Program .................................25
What the Setup Program Does .............................25
Installing in Silent (Unattended) Mode .......................29
Accepting the License Agreement ........................29
Silent Install and Uninstall for PowerBuilder Products
..............................................................30
Silent Install and Uninstall for the PBVM ................32
Postinstallation Tasks ............................................33
Upgrading Databases for jConnect for JDBC ............33
Installing the PBVM in EAServer ...........................34
Installing Ghostscript .......................................34
Installing PostScript Drivers ................................35
Uninstalling a PowerBuilder Product ..........................37
Obtaining Help and Additional Information ..................39
Index ..............................................................41
iv PowerBuilder
Installation Workflow
Installation Workflow
This workflow defines a path for planning and installing PowerBuilder® .
Uninstalling
Uninstalling a PowerBuilder Product on page 37
Installation Guide 1
Installation Workflow
2 PowerBuilder
Planning Your Installation
Installation Guide 3
Planning Your Installation
System Requirements
Make sure your system meets all requirements before you install PowerBuilder. See the
release bulletin for the most current information about required service packs.
4 PowerBuilder
Planning Your Installation
Obtaining a License
Before installing your product, choose a SySAM license model, gather information about the
license server, and obtain license files.
These steps summarize how to install a Sybase® Software Asset Management (SySAM)
license. For details, see the Sybase Software Asset Management Users Guide on the SyBooks
online bookshelf or on the Sybase Product Manuals Web site at [Link]
2. For the served license model, decide whether to use an existing or new license server.
The license server and your product installation do not need to share the same machine,
operating system, or architecture.
3. For the served license model, determine the type of server system:
• Install the new license server on a machine that does not have an existing license server.
• To install on a machine that is running a SySAM 1.0 license server, follow migration
instructions in the Sybase Software Asset Management User's Guide to migrate to the
newer SySAM version.
4. Before installing your product, get license files from the Sybase Product Download Center
(SPDC) at [Link] using SPDC access information you receive
from Sybase or your Sybase reseller.
SySAM Troubleshooting
This topic describes possible problems with SySAM licenses.
Read this topic if you experience problems with SySAM licensing. The information might
help you resolve the issues, or to collect information that Technical Support can use to
diagnose them. You can find more information about SySAM licensing on the SySAM Web
site at [Link] and in the SySAM Infocenter at http://
[Link]/help/topic/[Link]/[Link].
Installation Guide 5
Planning Your Installation
[pb]
LogSySAM = N
Software Requirements
Identify the software requirements for PowerBuilder.
6 PowerBuilder
Planning Your Installation
Installation Guide 7
Planning Your Installation
8 PowerBuilder
Planning Your Installation
Installation Guide 9
Planning Your Installation
10 PowerBuilder
Preinstallation Tasks
Preinstallation Tasks
This topic describes tasks to perform before installation.
• 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. Release bulletins for PowerBuilder and InfoMaker are also available on the Product
Manuals Web site at [Link] The release bulletins at
this site sometimes contain more recent information than the bulletins on the Getting
Started CD. A [Link] file for SQL Anywhere is available in the SQLAnywhere11
directory on the DVD.
• Make sure the drive on which you install PowerBuilder is not compressed. If compression
is enabled on the installation drive, the setup program fails.
• Make sure you have a TEMP environment variable that points to an existing directory
location with at least 300MB free space. The setup programs write files to this directory
during the installation and frees the space after the installation is complete.
• Close any open applications.
• Back up any files created with earlier versions of Sybase tools. Make sure that any
PowerBuilder PBLs you plan to migrate have been regenerated without error in your
current version of PowerBuilder before you back them up.
In addition to backing up your PBLs, back up any files that contain information you do not
want to lose, such as database files, INI files, preference information, and modified
database definition files. For more information about backing up and migrating existing
applications, see Postinstallation Tasks on page 33.
• Read Software Requirements on page 6 to determine whether you need to install any
software before installing PowerBuilder 12.
Installation Guide 11
Preinstallation Tasks
12 PowerBuilder
Starting the Common Setup Program
Installation Guide 13
Starting the Common Setup Program
14 PowerBuilder
Providing Basic Information
Proceeding Without a Valid License: You can select the local license or served license
option without loading a license file or specifying a server location. When you click Next,
the setup program displays an error message box. After you close the error message, the
setup prompts you to confirm that you will obtain a valid license key within 30 days. Click
Yes to proceed with the installation. Note that the installed products stop functioning after
30 days unless you install a valid license file or license server first.
4. In the License Key page:
a) Click Load.
b) Navigate to and select your license file, and click Open.
c) Click Next. Wait for a few seconds until the setup program validates the license.
Installation Guide 15
Providing Basic Information
5. On the License Agreement page, select your location from the drop-down list, read the
license agreement, select the I AGREE radio button, and click Next to continue.
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. Use the same folder for shared files for all products in this set.
9. On the Select Components page, select the products you want to install and click Next to
continue.
10. Complete the setup program for each product you selected.
16 PowerBuilder
Installing SQL Anywhere
1. In the Choose Setup Language dialog box, select the language you want to use in the
Installation wizard and click OK.
2. On the Welcome page, click Next.
3. On the License Agreement page, select your location from the drop-down list, read the
license agreement, select the I accept the terms of this agreement option, and click Next
to continue.
4. On the Setup Type page, select Complete if you want to install all components, or select
Custom and click Next.
5. If you selected Custom in the previous step, click the down arrow next to any feature you
do not want to install, select This feature will not be available from the cascading menu,
and click Next.
6. On the Ready to Install the Program page, click Install to begin the installation.
7. Optionally select the check boxes in the InstallShield Wizard Completed page to view the
ReadMe file or the iAnywhere Online Resources page.
8. Click Finish to close the SQL Anywhere installation wizard.
Note: Sometimes, a dialog opens with this erroneous message:
Invalid license data. Reinstall is required.
Click OK to dismiss the dialog; the SQL Anywhere installation completes normally.
Installation Guide 17
Installing SQL Anywhere
18 PowerBuilder
Installing InfoMaker
Installing InfoMaker
This topic describes how to install InfoMaker, an easy-to-use tool for creating applications
that query and report on databases.
The common setup program installs InfoMaker in default drives and directories unless you
specify otherwise. If a directory you specify does not exist, setup creates it.
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.
2. On the Choose Destination Location For Shared Files page, click Next to accept the
destination folder path shown, or browse to select the Sybase\Shared directory.
3. On the Select Components page, unselect 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 unselect subcomponents of top-level
components, and click Select All or Unselect All to select or unselect all the check boxes.
You cannot unselect the InfoMaker Base Components option. See InfoMaker
Components on page 20. To install optional painters, select the Database Write option.
The Demo Database is selected by default if you select the Tutorial component.
4. On the Select Program Folder page, select the program folder to which program icons will
be added or specify a new one, and click Next.
5. On the Start Copying Files page, review your settings, then click Next to begin installing
files or Back to change your selections.
6. On the InstallShield Wizard Complete page, select the check box if you want to read the
Readme file, and click Finish to return to the common setup program.
Close the Readme file to continue.
Installation Guide 19
Installing InfoMaker
InfoMaker Components
The setup program lets you install the base InfoMaker software and additional, optional
components.
Native Database Inter- Interfaces that enable you to interact with server databases natively. Expand
faces the tree view to select which interfaces to install.
OLE DB Driver Interface to connect to databases using an OLE DB data provider.
JDBC Driver Interface to connect to databases using JDBC.
Internet Tools The DataWindow Web Control for ActiveX is a fully interactive Data-
Window control. It requires a browser that supports ActiveX.
InfoMaker Tutorial Source files for the tutorial in the Getting Started book. If you want to do the
InfoMaker tutorial or use the sample library, install SQL Anywhere 11.0.1
or later if it is not already installed on your computer. When you install
InfoMaker, the setup program creates an ODBC data source for the demo
database. If SQL Anywhere is not installed on your system when you install
InfoMaker, setup does not install the demo database, sample library, or
tutorial files.
Demo Database A SQL Anywhere database used in the tutorial, the sample library, and
examples in the documentation.
Online Help Files The [Link] and [Link] compiled HTML Help files.
20 PowerBuilder
Installing PowerBuilder
Installing PowerBuilder
Run the PowerBuilder setup program to install PowerBuilder .NET and PowerBuilder
Classic.
Prerequisites
You must have Administrator privileges to fully install this product.
Task
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.
2. On the Choose Destination Location For Shared Files page, click Next to accept the
destination folder path shown, or browse to select the Sybase\Shared directory.
3. On the Select Components page, unselect any components you do not want to install, and
click Next.
You cannot unselect the PowerBuilder Base Components option.
Select or select the check boxes of individual components, or click Select All or Unselect
All to change all the check boxes.
The Demo Database is selected by default if you select the Tutorial component.
4. On the Select Program Folder page, select the program folder to which program icons will
be added, or specify a new one; then click Next.
5. On the Start Copying Files page, review your settings, then click Next to begin installing
files, or Back to change your selections.
6. On the InstallShield Wizard Complete page, select the check box if you want to read the
Readme file, then click Finish to return to the common setup program.
Next
After installing, make sure users have write permission for their user profile directories (for
example, My Documents in Windows XP and Documents in Windows Vista), and for
HKEY_CURRENT_USER in the Windows registry.
Installation Guide 21
Installing PowerBuilder
PowerBuilder Components
The setup program lets you choose which PowerBuilder components to install.
Table 5. Components
Component Description
PowerBuilder Base Installs the ODBC driver, ORCA Software Development Kit (SDK), the
Components PowerBuilder Document Object Model extension, the ability to save Da-
taWindow objects as PDF using the distill or XSL-FO methods, support for
rich text, support for EAServer, and JDK 1.6. You must install the base
components: you cannot unselect this option.
.NET Targets Available under PowerBuilder Base Components, deploys Windows
Forms, smart client, and Web Forms applications to .NET, and deploys
NVOs as .NET assemblies and Web services.
PowerBuilder .NET The PowerBuilder .NET IDE hosts the Visual Studio isolated shell and is
designed for full compliance with the common language specifications
for .NET. Used for deploying Windows Forms, smart client, and Web Forms
applications to .NET and deploying NVOs as .NET assemblies and Web
services.
Native Database Inter- Interfaces that enable you to interact with server databases natively. Expand
faces the tree view to select interfaces to install.
[Link] Driver Interface to connect to databases using an [Link] data provider.
OLE DB Driver Interface to connect to databases using an OLE DB data provider.
JDBC Driver Interface to connect to databases using JDBC.
SCC Interface Interface for connecting to any source code control system that supports the
Microsoft SCC interface.
DataWindow Web The DataWindow Web Control for ActiveX is a fully interactive Data-
Control for ActiveX Window control. It requires a browser that supports ActiveX.
PB Native Interface An SDK for developing extensions to PowerBuilder in C++. Optional wiz-
ards are installed in Visual Studio 2005 and Visual Studio .NET 2002 and
2003 if they are available on your system.
EJB Client The EJB Client PBNI extension, which enables you to develop clients for
EJBs running on J2EE-compliant servers.
Web Services The extensions and other files that enable you to create clients for Web
services using the .NET or EasySoap Web service engines.
PowerDesigner Plug- A plug-in that provides the class diagram functionality of the OOM inside
in the PowerBuilder development environment.
22 PowerBuilder
Installing PowerBuilder
Component Description
Tutorial Source files for the tutorial in the Getting Started book. If you want to do the
PowerBuilder tutorial or use the code examples, install SQL Anywhere
11.0.1 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. If SQL Anywhere is not installed on your system when
you install PowerBuilder, setup does not install the demo database, code
examples, or tutorial files.
Demo Database A SQL Anywhere database used in the tutorial, the Code Examples sample
application, and examples in the documentation.
Code Examples The Code Examples application, which demonstrates many coding techni-
ques, and the Web DataWindow PBL, which can be used as a model for a
custom Web DataWindow server component.
Translation Toolkit Tools to help you translate applications into other languages.
PowerBuilder Re- A utility to help determine whether there are sufficient USER/GDI resour-
source Monitor ces available in the operating system to open a painter.
PowerBuilder Runtime A tool that packages files required for deployment into an MSI file.
Packager
Online Help Files The [Link] Windows Help file, the Getting Started book in
PDF format, and the [Link] compiled HTML Help file. Sev-
eral *.HxS Help 2 files are used in the PowerBuilder .NET IDE.
Installation Guide 23
Installing PowerBuilder
24 PowerBuilder
Completing the Setup Program
1. On the InstallShield Wizard Complete page, click Finish to complete the installation.
If you do not unselect the check boxes on this page, setup displays the readme file and
launches a browser so that you can complete online registration.
2. On the System Reboot Required page, click Finish to reboot your computer, or choose to
reboot your computer later.
After installing any of the PowerBuilder products, always shut down and restart your
computer before using it.
Installation Guide 25
Completing the Setup Program
Documents\Sybase\PowerBuilder
12.0\Tutorial
On Windows 7:
My Documents\Sybase\PowerBuilder
12.0\Tutorial
The locations of writable PowerBuilder files reserved for individual use are set in
HKEY_CURRENT_USER registry entries for each PowerBuilder user. For example, the
location of the [Link] file that is copied to each user's local application data directory is
26 PowerBuilder
Completing the Setup Program
Registry changes
The setup program makes the following changes to the Windows registry:
• Creates a root registry key at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft
\AppEnv\9.0\Apps\pbshell_6082CEF1-0148-4a14-
BD24-57A47D547729
• During execution, dynamic information is rooted at HKEY_CURRENT_USER
\Software\Microsoft\AppEnv\9.0\Apps
\pbshell_6082CEF1-0148-4a14-BD24-57A47D547729
• Creates or updates the Sybase key in HKEY_CURRENT_USER\Software and
HKEY_LOCAL_MACHINE\Software
• Updates system and user paths in HKEY_CURRENT_USER\Environment
• Adds the appropriate paths to the registry path HKEY_LOCAL_MACHINE\Software
\Microsoft\Windows\CurrentVersion\App Paths
• Adds the paths of compiled HTMLHelp files to the registry path
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\HTMLHelp
Installation Guide 27
Completing the Setup Program
28 PowerBuilder
Installing in Silent (Unattended) Mode
Prerequisites
Complete installation planning.
Task
Installation Guide 29
Installing in Silent (Unattended) Mode
[Link]
[ " lic = licPathNameOrServerName " " opt = product " " dir = directoryName " "
shr = sharedDirectoryName " " log = logFileName " ]
[ { help | /? } ]
All of the parameters for the silent installation 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.
The parameters can be listed in any order and are not case sensitive. Parameter values are also
not case sensitive.
Silent installation Description
parameter
licPathNameOrServer- The full path to a valid license file with an LIC extension, or the name of
Name a server hosting a served license. If a license server requires a port
number, you can include the port number after the server name, sepa-
rated by a colon. For example:
[Link] “lic=myServer:1688”
product Names the product or products to install. Values are:
30 PowerBuilder
Installing in Silent (Unattended) Mode
The following example uses all five parameters for the silent installation command:
[Link] "lic=D:\pb120\[Link]" "opt=pb" "dir=D:
\pb120" "shr=D:\shared" "log=D:\[Link]"
When installing PowerBuilder, the silent installation writes warnings to its log file if the setup
computer does not have any of these items:
When installing InfoMaker, the log file includes a warning if the setup computer does not have
a working copy of SQL Anywere. If SQL Anywhere is not found, the demonstration databases
and code examples are not installed for PowerBuilder or InfoMaker.
To start the standard silent uninstallation, run the [Link] command in the main
installation directory.
[Link]
[ " all " ]
[ { help | /? } ]
By default (with no arguments), silentuninstall uninstalls only PowerBuilder and InfoMaker.
To uninstall SQL Anywhere, specify the all argument.
Installation Guide 31
Installing in Silent (Unattended) Mode
Note: Uninstalling SQL Anywhere on 64-bit editions of Windows Vista requires elevated
privileges.
[Link]
[ " asp = aspPathName " " shr = sharedDirectoryName " " log = logFileName " ]
You can list the parameters in any order. Parameters and their values are not case sensitive.
Silent installation Description
parameter
aspPathName Names the full path where the EAServer support files are to be installed.
If you omit this parameter, the default value is the EAServer folder.
For example:
%SystemDrive%\Program Files\Sybase\EASe-
rver
sharedDirectoryName Indicates the shared directory for PowerBuilder or InfoMaker. If you
omit this parameter, the installed directory is %SystemDrive%
\Program Files\Sybase\Shared.
logFileName Names the log file for the installation. If you omit this parameter, the log
file is written to the system Temp directory with the file name, si-
[Link].
The following example uses all three parameters to silently install the PBVM:
[Link] "asp=D:\EAServer" "shr=D:\shared" "log=D:
\[Link]"
To uninstall the PBVM in silent mode, run the [Link] script in the PBVM
directory.
32 PowerBuilder
Postinstallation Tasks
Postinstallation Tasks
Before using PowerBuilder after installation, you might need to perform some migration or
configuration tasks.
Installation Guide 33
Postinstallation Tasks
1. Run the [Link] program in the PBVM directory on the PowerBuilder 12.0 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 is installed; then
click Next.
3. On the Choose Destination Location for Shared Files page, click Next if the default
destination location is correct, or click Browse to navigate to the directory you specified in
Step 2 or to the Sybase\Shared directory; then click Next.
The setup program installs the PBVM in a PowerBuilder subdirectory of the directory
you select, installs the Web DataWindow and debugger components in the Repository
directory, and exits.
Installing Ghostscript
Install Ghostscript if you plan to use the distill method for saving DataWindows as PDF.
To install Ghostscript:
34 PowerBuilder
Postinstallation Tasks
1. Into a temporary directory on your computer, download the self-extracting executable file
for the version of Ghostscript you want from one of the sites listed on the Ghostscript Web
site at [Link]
See the PowerBuilder release bulletin for the version of Ghostscript that was used for
testing.
2. Run the executable file to install Ghostscript on your system.
The default installation directory is C:\Program Files\gs.
Installation Guide 35
Postinstallation Tasks
36 PowerBuilder
Uninstalling a PowerBuilder Product
Installation Guide 37
Uninstalling a PowerBuilder 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.
38 PowerBuilder
Obtaining Help and Additional Information
Installation Guide 39
Obtaining Help and Additional Information
40 PowerBuilder
Index
Index
download image, installing from 13
.NET target
PowerBuilder component 22
software requirements 6 E
.NET Web Forms
software requirements 6 EAServer
.NET Windows Forms installing the PBVM in 34
smart client deployment, software software requirements 6
requirements 6 EJB client
PowerBuilder component 22
software requirements 6
A
ActiveX F
InfoMaker component 20
PowerBuilder component 22 FDCC
[Link] See Federal Desktop Core Configuration
data access, software requirements 6 features, PowerBuilder 6
driver for PowerBuilder 22 Federal Desktop Core Configuration, compliance
ASA 25
See SQL Anywhere files, shareable and user-specific installed 25
[Link] 13 FO processor, for saving DataWindows as PDF 6
form painter, InfoMaker component 20
B
G
backup requirements 11
before you install 11 Getting Started CD 3
Ghostscript, for saving DataWindows as PDF 6, 34
C
H
CDs and DVDs in package 3
common setup program hardware requirements 4
completing 25 help files
providing basic information 15 InfoMaker 20
results 25 PowerBuilder 22
starting 13
I
D
[Link] file 25
data pipeline painter, InfoMaker component 20 image, installing from 13
database painter, InfoMaker component 20 InfoMaker
demo database components 20
InfoMaker 20 installing in silent mode 29
PowerBuilder component 22 installing interactively 19
SQL Anywhere required for 6 system requirements 4
disk space requirements 4, 11
Installation Guide 41
Index
42 PowerBuilder
Index
Installation Guide 43
Index
44 PowerBuilder