Sybase Powerbuilder User Manual
Installation Guide
PowerBuilder® Enterprise
11.5
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. 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 ma y co ntac t Customer Fulfillment via the above fax number. All other
international customers should contact their S ybase 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 h ttp://www.sybase.com/detail?i d=1011207. Sy bas e and t he mark s lis te d
are trademarks of Sybase, Inc. ® 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 mentioned may be 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
About This Book............................................................................................................................ v
CHAPTER 1 Installing PowerBuilder Enterprise ............................................... 1
PowerBuilder Enterprise contents.................................................... 1
System requirements ....................................................................... 3
Product licensing with SySAM 2.0.................................................... 4
Pre-installation tasks........................................................................ 5
Backing up your files ................................................................. 5
Required software for PowerBuilder features............................ 6
Starting the PowerBuilder 11.5 setup program ................................ 9
Installing SQL Anywhere................................................................ 10
Providing basic information............................................................ 11
Installing InfoMaker........................................................................ 13
Installing PowerBuilder................................................................... 16
Completing the setup program....................................................... 18
What the setup program does................................................. 19
Silent install and uninstall............................................................... 21
Silent install and uninstall for PowerBuilder and InfoMaker .... 21
Silent install and uninstall for the PBVM.................................. 23
Before using PowerBuilder Enterprise ........................................... 24
Migrating applications to PowerBuilder or InfoMaker 11.5...... 24
Setting up your DBMS............................................................. 24
Upgrading databases for jConnect for JDBC .......................... 25
Installing the PBVM in EAServer or the Application Server
Plug-in .............................................................................. 25
Installing Ghostscript............................................................... 26
Installing PostScript drivers..................................................... 27
Troubleshooting SySAM issues ..................................................... 28
Removing a product....................................................................... 29
Index ............................................................................................................................................. 31
Installation Guide iii
Contents
iv
PowerBuilder Enterprise
About This Book
Audience
How to use this book
Related documents
Other sources of
information
This book is for anyone installing Sybase® PowerBuilder® Enterprise.
Read this book before you run the setup program to install PowerBuilder,
InfoMaker®, and SQL Anywhere™.
For a complete list of PowerBuilder documentation, see the preface of
PowerBuilder Getting Started.
Use the Sybase Getting Started CD, the SyBooks™ CD, and the Sybase
Product Manuals Web site to learn more about your product:
• The Getting Started CD contains release bulletins and installation
guides in PDF format, and may also contain other documents or
updated information no t in cluded o n t he SyBooks CD. It is included
with your software. To read or print documents on the Getting Started
CD, you need Adobe Acrobat Reader, which you can do wnload at no
charge from the Adobe Web site using a link provided on the CD.
• The SyBooks CD contains product manuals and is included with your
software. The Eclipse-based SyBooks browser allows you to access
the manuals in an easy-to-use, HTML-based format.
Some documentation may be provided in PDF format, which you can
access through the PDF directory on the SyBooks CD. To read or
print the PDF files, you need Adobe Acrobat Reader.
Refer to the SyBooks Installation Guide on the Getting Started CD, or
the README.txt file on the SyBooks CD for instructions on installing
and starting SyBooks.
• The Sybase Product Manuals Web site is an online version of the
SyBooks CD that you can access using a standard Web browser. In
addition to product manuals, you will find links to
EBFs/Maintenance, T echn i cal Documents, Case Management,
Solved Cases, newsgroups, and the Sybase Developer Network.
To access the Sybase Product Manuals Web site, go to
Manuals at http://www.sybase.com/support/manuals/
Installation Guide v
Product
.
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.
❖ Finding the latest information on component certifications
1 Point your Web browser to Availability and Certification Reports at
http://certification.sybase.com/
.
2 Either select the product family and product under Search by Base
Product; or select the platform and product under Search by Platform.
3 Select Search to display the availability and certification report for the
selection.
❖ Creating a personalized view of the Sybase Web site (including support
pages)
Set up a MySybase profile. MySybase is a free service that allows you to create
a personalized view of Sybase Web pages.
1 Point your Web browser to
http://www.sybase.com/support/techdocs/
Technical Documents at
.
2 Click MySybase and create a MySybase profile.
Sybase EBFs and
software
maintenance
❖ Finding the latest information on EBFs and software maintenance
1 Point your Web browser to the Sybase Support Page at
http://www.sybase.com/support
.
2 Select EBFs/Maintenance. If prompted, enter your MySybas e user name
and password.
3 Select a product.
4 Specify a time frame and click Go. A list of EBF/Maintenance releases is
displayed.
vi PowerBuilder Enterprise
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 “T echn ical Support Contact”
role to your MySybase profile.
5 Click the Info icon to display the EBF/Maintenance report, or click the
product description to download the softwa re.
Accessibility
features
This document is available in an HTML version that is specialized for
accessibility. You can navigate the HTML with an adaptive technology such as
a screen reader, or view it with a screen enlarger.
PowerBuilder and the HTML documentation have been tested for compliance
with U.S. government Section 508 Accessibility requirements. Documents that
comply with Section 508 generally also meet non-U.S. accessibility guidelines,
such as the World Wide Web Consortium (W3C) guidelines for Web sites.
Note You might need to configure your accessibility tool for optimal use.
Some screen readers pronounce text based on its case; for example, they
pronounce ALL UPPERCASE TEXT as initials, and MixedCase Text as
words. You might find it helpful to configure your tool to announce syntax
conventions. Consult the docum entation for your tool.
For information about how Sybase supports accessibility, see
Accessibility at http://www.sybase.com/accessibility
. The Sybase Accessibility
Sybase
site includes links to information on Section 508 and W3C standards.
For more information about accessibility features of PowerBuilder, see the
chapter on building accessible applications in Application Techniques.
For a Section 508 compliance statement for PowerBuilder, go to the
Product Assessment Templates page at
http://www.sybase.com/detail_list?id=52484
.
Voluntary
If you need help
Each Sybase installation that has pu rchased a support contract has one or more
designated people who are au th orized t o co ntact Sy bas e Technical Support. If
you cannot resolve a problem using the manuals or online help, please have the
designated person contact Sybase Technical Support or the Sybase subsidiary
in your area.
Installation Guide vii
viii PowerBuilder Enterprise
CHAPTER 1
Installing PowerBuilder
Enterprise
About this book
Contents
This book explains how to install the PowerBuilder Enterprise product set
on Windows XP, Windows Server 2003, Windows Vista, and Windows
Server 2008.
Topic Page
PowerBuilder Enterprise contents 1
System requirements 3
Product licensing with SySAM 2.0 4
Pre-installation tasks 5
Starting the PowerBuilder 11.5 setup program 9
Installing SQL Anywhere 10
Providing basic information 11
Installing InfoMaker 13
Installing PowerBuilder 16
Completing the setup program 18
Silent install and uninstall 21
Before using PowerBuilder Enterprise 24
Troubleshooting SySAM issues 28
Removing a product 29
PowerBuilder Enterprise contents
CD and DVD contents
Installation Guide 1
PowerBuilder Enterprise includes the CDs or DVDs listed in Table 1-1.
The setup program on the PowerBuilder DVD can be used to install all
editions of PowerBuilder (Enterprise, Professional, and Desktop). The
editions available to you depend on the license you supply. For more
information, see “Product licensing with SySAM 2.0” on page 4.
PowerBuilder Enterprise contents
Table 1-1: PowerBuilder 11.5 contents
CD or DVD Contents
Getting Started CD Customer Service Reference Guide, SyBooks Inst allation
PowerBuilder DVD Common setup program for PowerBuilder 11.5 (all
PowerBuilder SyBooks CDDocumentation for PowerBuilder in HTML-based and
Guide, PowerBuilder and InfoMaker Release Bulletins,
order card for pri nted documentation, and this
Installation Guide.
editions) and InfoMaker 11.5, setup program for SQL
Anywhere 11.0, and a support folder that contains fil es
that can be used to rebuild the PowerBuilder extensions
for Web services clients and other supporting files.
PDF formats. For more information, see “Other sources
of information” on page v.
Additional license
entitlements
The license you purchase for the PowerBuilder 11.5 Enterprise edition is also
valid for a copy of PowerBuilder Application Server Plug-in 1.1 and entitles
you to a copy of PocketBuilder® 2.5. You can download these products from
the
Sybase Product Download Center (SPDC) at
http://www.sybase.com/downloads
. If you install PowerBuilder 11.5 with a local
license rather than a served license, you must install the PowerBuilder
Application Server plu g-in on the s ame computer as Po werBuilder . You do not
need a license file to install and run PocketBuilder.
For general information about Sybase licenses, see “Product licensing with
SySAM 2.0” on page 4. For information about selecting a license in the
PowerBuilder setup program, see “Providing basic information” on page 11.
You must log in to access the SPDC download site. After you log in, the main
SPDC download page displays. You can click the link to “Full Product
Releases for Licensed Customers”, then select PowerBuilder to view a list that
includes a link to the download page for PowerBuilder Application Server
Plug-in 1.1, or you can select PocketBuilder to view a list that includes a link
to the download page for PocketBuilder 2.5. After you install PocketBu ilder
2.5, you can go back to the main SPDC download page, and select
“Maintenance Releases and Bug Fixes (EBFs)” to view a link to the download
page for PocketBuilder 2.5.1.
2 PowerBuilder Enterprise
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. Th e disk sp ace r equirem ents
provided are approximate. The actual dis k 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 f iles.
Table 1-2: System requirements for PowerBuilder Enterprise
Minimum
Tool Computer
PowerBuilder Pentium 4 or higher 512MB 506MB for all
InfoMaker Pentium 4 or higher 256MB 302MB for all
SQL Anywhere 400 MHz or higher
Pentium-compatible
memory Hard disk space Operating system
components
components*
48MB in
addition to
memory
required by the
operating
system
300MB for all
components not
including UltraLite
and Window Mobile
Windows XP Professional
with SP 3, Windows XP
Ta blet PC Edition with SP 3,
Windows Server 2003 with
SP2, Windows Vista 32/64
bit Business with SP1, or
Windows Server 2008 for
runtime
Windows XP Professional
with SP 3, Windows XP
Ta blet PC Edition with SP 3,
Windows Server 2003 with
SP2, Windows Vista 32/64
bit Business with SP1, or
Windows Server 2008 for
runtime
Windows 2000, Windows
XP, Windows X P Tablet PC
Edition, Windows Server
2003, and Windows Vista
and Windows Server 2008
(x86, x64, IA64)
* Less disk space is required if PowerBuilder is installed on the same computer.
Installation Guide 3
Product licensing with SySAM 2.0
Product licensing with SySAM 2.0
PowerBuilder uses the Syba se Software Asset Management System (SySAM)
for product licensing. If you have purchased PowerBuilder, you have either a
standalone local license or a served license.
Installing a st andalone
local license
Installing a served
license
For more information about licensing, see the
http://www.sybase.com/sysam
or troubleshooting help, see “Troubleshooting SySAM issues” on page 28.
F
.
SySAM Documentation at
Typically, you must have a license file to install PowerBuilder on your
computer . You can download a license file from the
Center (SPDC) at https://sybase.subscribenet.com
Sybase Product Download
. If you are evaluating
PowerBuilder, refer to the information provided with your DVD or download.
Evaluation versions of PowerBuilder are usually valid for 30 days and do not
require a license file.
If you purchase PowerBuilder from Sybase, you receive an e-mail with a URL,
your login, and your pas sword for the SPDC. If you pu rchase PowerBuilder
from a Sybase reseller, you receive a certificate with a Web key registration
number and a download URL.
You must provide the host ID and computer name of the computer where you
want to install a local license when you contact the SPDC. If you have not
obtained your license information before you run the setup program, you can
find the host ID and computer name on the License Key page in the setup
program.
If you are installing a served license, y ou r organization need s a license server.
The license server controls license availability and allows you to use licenses
as needed. Using a served license makes license maintenance much easier for
organizations with multiple workstations, since a single license for all
workstations can be centrally managed.
T o install a served license, you must know th e server name. You may also need
the TCP port number if the administrator who installed the license server
defined a TCP port number that is different from the default. In this case, you
must specify this user-defined TCP port number.
Setting up a license
server
If you are responsible for setting up a license server, you can install a license
server using the S tandalone SySAM In staller.zip file in the Support directory on
the DVD. For more information, see the chapter on license server
administration in the
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc00530_0200/ht
ml/sysamug/title.htm
Sybase Software Asset Management User Guide at
.
4 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.
Release bulletins for PowerBuilder and InfoMaker are also available on
the
Product Manuals Web site at http://www.sybase.com/support/manuals/.
The release bulletins at this site sometimes contain more recent
information than the bulletins on the Getting Started CD.
A readme.txt file for SQL Anywhere is available in the SQLAnywhere11
directory on the DVD.
• Make sure the drive where you install PowerBuilder Enterprise 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 free the
space after the installation is complete.
CHAPTER 1 Installing PowerBuilder Enterprise
• Close any open applications.
• Back up your files. See “Backing up your files” next.
• Read “Required software for PowerBuilder f eatures” on page 6 to
determine whether you need to install any software before installing
PowerBuilder 11.5.
Backing up your files
Back up any files created with earlier versio ns of Syb ase tools. Make sure tha t
any PowerBuilder PBLs you plan to migrate have been regener ated without
error in your current version of PowerBuilder before you back them up.
Besides backing up your PBLs, you need to back up any files that contain
information you do not want to lose, such as database files, INI files,
preference information, and modified databa se defini ti on fi le s.
Installation Guide 5
Loading...