PowerBuilder Tips, Tricks, and Techniques

Berndt Hamboeck

Subscribe to Berndt Hamboeck: eMailAlertsEmail Alerts
Get Berndt Hamboeck: homepageHomepage mobileMobile rssRSS facebookFacebook twitterTwitter linkedinLinkedIn


Related Topics: Java EE Journal, Apache Web Server Journal, ERP Journal on Ulitzer

J2EE Journal: Article

Working with the Enterprise Portal

An Overview Part 1

Sybase uses the FLEXlm licensing system to license its products. With FLEXlm, a customer can add new seats to an existing multi-user license simply by adding a new incremental key for the extra users to the existing license file. Other "extra" features can be added to the license file with similar ease.

Types of Licensing
When we talk about licensing software, you should know that there are two different types of licensing. The first is called a node-locked system, which means that for every installation, a (different) license key is necessary. PowerBuilder follows this license scheme, but it's not absolutely restrictive because the same key can be entered on different machines. From the vendor's view, it's not perfect. Likewise, from the company's view, it's not perfect because it needs a license for every machine where the product is installed. This might mean that there are more licenses available than absolutely necessary because not all machines are using the software at the same time.

The second type of licensing is called floating licenses. This means that a software license is valid on any machine in your company (or the company's network). A central license server is used: An installed software product checks or requests a license, and then the software runs (or prevents the user from running it). Now, instead of having to buy a separate license for each machine that might need to use the software, a company needs to buy only enough licenses to cover the largest number of people who'll need to use the software at a one time. If more users are needed, additional licenses can easily be added, and because all licensing is centrally controlled, if additional features are needed (for example, in ASE, the Java in the database feature), updates take place quickly at a single location and all users are available to use them immediately.

A time might come where an unforeseen situation arises and you need more licenses than you bought. This could be very critical for you or your company if everything would stop working, so FLEXlm also allows a flexible limit on the number of users on a network. By using FLEXlm, the user (or at least the administrator) typically is presented with a message that the maximum number of authorized users has been exceeded but that access is being given. Don't forget, however, that you are still violating the licensing scheme; you should add the extra licenses as soon as possible.

Take care that you don't lose or give anyone your paper named SySAM Certificates. If you lose it and want to reinstall your licensed software, you will have to contact Sybase for a new one.

Where to Find It
FLEXlm licensing is controlled from a user-accessible plain text file (you'll find it in your SYSAM-1_0\licenses directory) that contains one or more encrypted license keys that determine how the software behaves. To view your licenses, enter this command in a DOS-Window from within the %SYBASE%\SYSAM-1_0\bin directory: lmutil lmdiag -c <yourlicensefile>

Adaptive Server Enterprise
This is the product you will start your Enterprise Portal installation with. Make sure if you've already installed some Sybase products on your machine (such as EAServer) that the Sybase EP Management Agent service and the SYSAM service are already running before you start your installation; otherwise, you might lose your previous installation information. If you already have an ASE installation, you can use it, but check that the Java in the database is licensed and enabled on this server. Enterprise Portal installs three databases on this server (entldb, portalsearch, and portalinterface), which will be used by all portal users in your single instance of Adaptive Server Enterprise.

Where to Find It
You'll find the installed files in the %SYBASE%\Sybase\ASE-12_5 directory. The databases are stored below in the Data directory.

EAServer
EAServer is the foundation for many of the portal services. By installing Enterprise Security and the portal application on the same machine as EAServer, you don't need to install any extra servers for these products' dependencies. Portal Interface, Portlet Designer, and search services will be installed as Web applications in your EAServer installation. If you already have an installation of EAServer, you can keep it, but you should check the version you have installed (see your Jaguar.log file, or start Jaguar Manager and connect to your server, then look into the Help menu and choose About in Jaguar Manager), this should be version 4.1.2 (which also ships with the Enterprise Portal) or version 4.2 (which ships with PowerBuilder 9). Make sure that your listeners are changed after the EP installation is complete. The EAServer installation comes directly after the Adaptive Server Enterprise installation.

Where to Find It
You will find the installed server in the directory %SYBASE%\EAServer. A good place to look if you encounter a problem with the transaction server is the Jaguar.log file that you'll find in the \bin directory of EAServer.

Enterprise Security
Every installation of Enterprise Portal, whether standalone or in a multi-machine environment, has a central database that stores all of the user's authorization and authentication information, such as username and password credentials, digital certificates, and access permissions to the portal components.

More Stories By Berndt Hamboeck

Berndt Hamboeck is a senior consultant for BHITCON (www.bhitcon.net). He's a CSI, SCAPC8, EASAC, SCJP2, and started his Sybase development using PB5. You can reach him under admin@bhitcon.net.

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.