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 and lists the features that will be available to you when you start your edition of PowerBuilder. If you want to be able to upgrade to another edition later without running the setup program again, leave all the features you might want to use selected. If you do not plan to upgrade and want to conserve disk space, use the table to determine which features you need not install.

For more information about upgrading, see “Upgrading a local license”.

Table 1-5: PowerBuilder components

Component

Description

Edition

PowerBuilder Base Components

Includes the PowerBuilder ODBC driver, Orca Software Development Kit (SDK), the PowerBuilder Document Object Model extension, the ability to save DataWindow objects as PDF using the distill or XSL-FO methods, support for rich text, JDK 1.5, and (for Enterprise) support for EAServer and COM/COM+.

All

.NET Targets

Deploying Windows Forms, smart client, and Web Forms applications to .NET and deploying NVOs as .NET assemblies and Web services.

Professional (Windows Forms only)

Enterprise

Native Database Interfaces

Interfaces that enable you to interact with server databases natively. Expand the tree view to select which interfaces to install.

Enterprise

ADO.NET Driver

Interface to connect to databases using an ADO.NET data provider.

Enterprise

OLE DB Driver

Interface to connect to databases using an OLE DB data provider.

Enterprise

JDBC Driver

Interface to connect to databases using JDBC.

Enterprise

SCC Interface

Interface for connecting to any source code control system that supports the Microsoft SCC interface. (Professional and Enterprise.)

Professional

Enterprise

DataWindow Web Control for ActiveX

The DataWindow Web Control for ActiveX is a fully interactive DataWindow control. It requires a browser that supports ActiveX.

Professional and Enterprise only

PowerBuilder Native Interface

An SDK for developing extensions to PowerBuilder in C++. Optional wizards are installed in Visual Studio 2005 and Visual Studio .NET 2002 and 2003 if they are available on your system.

All

EJB Client

The EJB Client PBNI extension, which enables you to develop clients for EJBs running on J2EE-compliant servers.

Enterprise

Web Services

The PowerBuilder extensions and other files that enable you to create clients for Web services using the .NET or EasySoap Web service engines.

Enterprise

PowerDesigner Plug-in

A plug-in that provides the class diagram functionality of the PowerDesigner OOM inside the PowerBuilder development environment.

Enterprise

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. 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.

All

Demo Database

A SQL Anywhere database used in the tutorial, the Code Examples sample application, and examples in the documentation.

All

Code Examples

The Code Examples application, which demonstrates coding techniques, the Web DataWindow PBL, which can be used as a model for a custom Web DataWindow server component, and other examples.

All

Translation Toolkit

Tools to help you translate PowerBuilder applications into other languages.

Enterprise

PowerBuilder Resource Manager

A utility to help PowerBuilder determine whether there are sufficient USER/GDI resources available in the operating system to open a painter.

All

PowerBuilder Runtime Packager

A tool that packages files required for deployment into an MSI file.

All

Online Help Files

The pbhlp115.hlp file, the Getting Started book in PDF format, and the pbman115.chm compiled HTML Help file.

All

Installation procedure

You must have Administrator privileges to fully install this product. After installing, make sure users have write permission for the PowerBuilder 11.5 directory and the Windows registry.

The PowerBuilder setup program installs PowerBuilder in default drives and directories unless you specify otherwise. If a directory you specify does not exist, setup creates it.

StepsTo install PowerBuilder:

  1. Select PowerBuilder 11.5.

  2. On the Welcome page, click Next.

    If you have not installed prerequisites for any feature, the next page in the wizard informs you what needs to be installed. You can click Cancel to exit the wizard or Next to continue without installing the prerequisites. For more information, see Table 1-4.

    NoteBack and Next Use the Back and Next buttons to step backward and forward through the wizard to modify specifications as necessary.

  3. On the License Type page, select the type of license you want to use.

    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..

    If you select Standalone Seat - Local License When you click Next, the License Key page displays. Click the Load button, navigate to the location of your license file, select it and click Open, then click Next. Wait for a few seconds while the setup program validates the license.

    If you select Standalone Seat - Served When you click Next, the Server Information page displays. Enter the name of the license server provided by your system administrator. You may also need the TCP port number if the administrator who installed the license server defined a non-default TCP port number. Click Next and wait for a few seconds while the setup program validates the license.

    NoteProceeding without a valid license You can select the local license or served license option without loading a license file or entering a server location. If you do this and click Next, the setup program displays an error message box. After you close the error message, additional dialog boxes ask if you want to proceed and prompt you to certify that you will obtain a valid license key within 30 days. Clicking Yes in these dialog boxes allows you to proceed with product installation, but the installed products cease to function after 30 days unless you install a valid license file or license server before the trial period expires.

    For more information, see “Product licensing with SySAM 2.0”.

  4. If the Select Edition page displays, select your edition of PowerBuilder and click Next.

  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. You must use the same folder for shared files for all products in this set.

  9. On the Select Components page, select PowerBuilder and click Next to continue.

    NoteCancel To interrupt the installation process, use the Cancel button in the wizard. When you click Cancel, you can choose to exit or resume the installation. If you choose to exit, you can exit the current setup program and continue with your other selections, or exit setup completely.

  10. 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, and click Next.

  11. 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.

  12. 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”.

    NoteDemo Database The Demo Database is selected by default if you select the Tutorial component.

  13. 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.

  14. On the Start Copying Files page, review your settings, then click Next to begin installing files or Back to change your selections.

  15. On the InstallShield Wizard Complete page, select the check box if you want to read the Readme file, and click Finish.

    You must close the Readme file to continue. PowerBuilder registers the components you installed.

  16. On the next InstallShield Wizard Complete page, click Finish to complete the installation.

    If you do not clear the check boxes on this page, setup displays the install readme file and launches a browser so that you can complete online registration.

  17. If the System Reboot Required page displays, click Finish to reboot your computer, or choose to reboot your computer later.

    You should always shut down and restart your computer before using PowerBuilder.