Back to Contents

Installation

Summary:

• Package Installation
• Platform-specific Notes

Package Installation

Starting with version 2.11.04, Genero Web Services (GWS) are provided as a bundle including GWS and BDL. The new package is named FGLGWS. After installation, the target directory reflects the same organization as a GWS installation on top of a BDL installation.

Prior to version 2.11.04, Genero Web Services are packaged as an add-on to the Genero Business Development Language. For versions prior to 2.11.04, you must install BDL first and then GWS:

• The version of the Genero Business Development Language package must match (that is, the version number must be the same, to two decimal places: 2.00, 2.01, etc.). 
• The Genero BDL package must be installed before installing the Genero Web Services Extension. If the appropriate version of the Genero Business Development Language is not installed on your system, you MUST install it before installing the Genero Web Services Extension.

The Genero Application Server package is required to manage your Web Services in a deployment environment. Unless you are interested in testing deployment issues, it is not required for Web Services development.

Important: Starting with version 2.0, you no longer need to create a runner that includes the Genero Web Services Extension package. Now, your applications should include the following line at the top of each module to import the Genero Web Services Extension library named com:

   import com

Platform-Specific Notes

IBM AIX

• The "IBM C++ Runtime Environment Components for AIX" must be installed in order to use "Genero Web Services Extension 2.0". See the IBM support center for more information about downloading the component.
  
  Note: If not installed, you will get the following error message:
  Could not load C extension library 'com'.
  Reason: A file or directory in the path name does not exist.

 

• Due to an IBM issue on 64Bits platforms, the openssl library is unable to open the system /dev/urandom device to generate a PRNG number.
  Therefore you must install the Entropy Gathering Daemon (a.k.a EGD) if you need security in your GWS application, and especially if you access a server in HTTPS.