Checklist for Deployment
Verify that production servers and target computers meet all requirements
for running the .NET targets that you deploy from PowerBuilder
Classic.
Checklist for all .NET targets
For deployment of all .NET target types (Windows Forms, .NET
Assembly, .NET Web Service), production servers or target computers must have:
- The Windows XP SP2, Windows Vista, Windows 2008, or Windows 7 operating system
- .NET Framework 4.0
- The Microsoft Visual C++ runtime libraries msvcp100.dll,
msvcr100.dll, and the Microsoft .NET Active Template
Library (ATL) module, atl100.dll - PowerBuilder .NET assemblies in the global assembly cache (GAC)
- PowerBuilder runtime dynamic link libraries in the system path
Checklist for .NET Web Service targets
For .NET Web Service targets, production servers must
have:
- IIS 5 or later (See IIS Installation)
- ASP.NET (See Selecting the Default ASP.NET Version)
- ASP.NET permissions for all files and directories used by your applications
For an example of how to grant ASP.NET permissions, see
Setting Up a SQL Anywhere Database Connection.
For information on different methods for deploying .NET Web Service components, see
Deployment to
a production server.
Deploying PowerBuilder runtime files
The simplest way to deploy PowerBuilder runtime DLLs and .NET assemblies to production servers or target computers is to use the PowerBuilder Runtime Packager tool. The Runtime Packager creates an MSI file that installs the files you select, registers any self-registering DLLs, and installs the .NET assemblies into the global assembly cache (GAC).
For information on all the steps required to migrate .NET applications and components that you deployed with earlier releases of PowerBuilder, see Release Bulletin > Migration Information. PowerBuilder release bulletins are available from links on the Product Manuals Web site at http://www.sybase.com/support/manuals/.
For a list of base components deployed when you select PowerBuilder .NET Components in the Runtime Packager, see Application Techniques > Deploying Applications and Components. The Runtime Packager installs additional components depending on the options you select in its user interface.
| File name | Required for |
|---|---|
|
All .NET targets |
| pbrth126.dll | ADO.NET |
|
DataWindows and DataStores |
| pbdpl126.dll | Data pipelines (Windows Forms only) |
|
Edit masks |
|
Graphs |
|
Rich text |
|
XML export and import |
|
Web service DataWindows |
|
Web service clients |
| pblab126.ini | Label DataWindow presentation style |
|
Database connection tracing |
Sybase.PowerBuilder files are strong-named .NET assemblies that can be installed into the GAC. For more information about the GAC, see Installing assemblies in the global assembly cache.
| File name | Required for |
|---|---|
| pbin9126.dll | Informix I-Net 9 native interface |
| pbo90126.dll | Oracle9i native interface |
| pbo10126.dll | Oracle 10g native interface |
| pbsnc126.dll | SQL Native Client for Microsoft SQL Server native interface |
| pbdir126.dll | Sybase DirectConnect� native interface |
| pbase126.dll | SAP Adaptive Server� Enterprise native interface (Version 15 and later) |
| pbsyc126.dll | SAP Adaptive Server Enterprise native interface |
|
ADO.NET standard interface |
|
JDBC standard interface |
|
ODBC standard interface |
|
OLE DB standard interface |
Installing assemblies in the global assembly cache
When the Common Language Runtime (CLR) is installed on a
computer as part of the .NET Framework, a machine-wide code cache called the global
assembly cache (GAC) is created. The GAC stores assemblies that can be shared by
multiple applications. If you do not want or need to share an assembly, you can keep
it private and place it in the same directory as the application.
If you do not want to use the Runtime Packager to deploy your
application, you should use Windows Installer or another installation tool that is
designed to work with the GAC. Windows Installer provides assembly reference
counting and other features designed to maintain the cache.
On the development computer, you can use a tool provided with the
.NET Framework SDK, gacutil.exe, to install assemblies into the
GAC.
Assemblies deployed in the global assembly cache must have a strong
name. A strong name includes the assembly�s identity as well as a public key and a
digital signature. The GAC can contain multiple copies of an assembly with the same
name but different versions, and it might also contain assemblies with the same name
from different vendors, so strong names are used to ensure that the correct assembly
and version is called.
For more information about assemblies and strong names, see the
Microsoft library at http://msdn.microsoft.com/en-us/library/wd40t7ad(VS.71).aspx.