| Download Docs | Site Map | Glossary | |
|
|
|||
| bea.com | products | dev2dev | support | askBEA |
|
|
|
|||||||
 |
| e-docs > WebLogic Server > WebLogic Server Partners' Guide > Distributing WebLogic Server |
|
WebLogic Server Partners' Guide
|
Instead of requiring your customers to purchase, install, and maintain both your application and a J2EE application server, you can bundle BEA's core technologies with your application and distribute both items as a single product. The plug-and-play environment of WebLogic Server makes it an ideal choice for integration with your product.
To distribute WebLogic Server, you must obtain and install a special license called an ISV license. (You do not need an ISV license to develop your application or to configure WebLogic Server.) Installing an ISV license for a WebLogic Server modifies the server and inextricably links files. Your distribution must include these modified WebLogic Server files.
To set up a WebLogic Server that you can distribute, complete the following tasks:
Enroll in the BEA Star Partner Program
BEA Systems, Inc. manages its relationships with Independent Software Vendors (ISVs) and Application Software Providers (ASPs) through the Star Partner Program. For more information about this program, including information on how to enroll, refer to the following topics:
Install the Partner Development Kit
After you enroll in the program, BEA ships a CD collection of all major BEA products. When the Partner Development Kit arrives, install the software from the CDs. For information on installing WebLogic Server, refer to the Installation Guide on the BEA documentation Web site, http://www.oracle.com/technology/documentation/index.html.
Caution: If you already have BEA products installed on the computer that you want to host your distributable WebLogic Server, back up your current BEA_HOME\license.bea file before installing the Partner Development Kit. For more information about the BEA home directory and the license.bea file, refer to BEA Home Directory in the Installing BEA WebLogic Server guide.
Instead of waiting for the CDs, you can download BEA software from the BEA Systems Download Center, http://commerce.beasys.com/downloads/products.jsp. If you have an active WebSUPPORT account, you can use your WebSUPPORT login password for software downloads.
After verifying your eligibility for the Star Partner Program, BEA sends an email that includes your customized ISV license in an attached file named isv.jar. This section describes how to install the ISV license file for WebLogic Server version 7.0 only. If you are installing an ISV license for other versions of WebLogic Server, please consult the relevant installation instructions for your software version.
There are three main steps to installing an ISV license:
Step 1: Preparing to Install an ISV License
Before you install an ISV license file, do the following:
Note the location of the BEA home directory that the BEA installer uses. It contains a license.bea file, which will be updated in subsequent steps of this process. For more information about the BEA home directory and the license.bea file, refer to BEA Home Directory in the Installing BEA WebLogic Server guide.
You are now ready to extract the ISV license data and link it to WebLogic Server files.
Step 2: Extracting the License Data and Linking WebLogic Server Files
To extract the ISV license data and link it to WebLogic Server files, enter one of the following commands from BEA_HOME:
where BEA_HOME is an absolute pathname for your BEA home directory, and
WL_HOME is an absolute pathname for the directory in which you installed WebLogic Server.
Caution: Do not interrupt this process once it has started.
The command generates a file named BEA_HOME\license_isv.bea, which contains the ISV license data. It also links files within the WL_HOME directory to the specific ISV license. Only the files in the WL_HOME directory that you specified will be able to use the ISV license data that you extracted to license_isv.bea.
Note: With some platforms and JDKs, you might encounter an "Out of Memory Error." To address this error, increase the value for the -Xmx argument (which sets the maximum heap size in megabytes) and run the command again. For example, -Xmx150m increases the default heap size to 150 megabytes.
To complete the process for installing an ISV license, you must update the Weblogic Server license with the data in license_isv.bea.
Step 3: Updating the WebLogic Server License
To update the license.bea file with the newly generated license_isv.bea file, enter one of the following commands from BEA_HOME:
The UpdateLicense command merges the license_isv.bea file with the license.bea file. After you run UpdateLicense, you do not need to keep the license_isv.bea file.
Next Steps: Configuring Your Application and WebLogic Server
After you install your ISV license, start the ISV-licensed WebLogic Server, deploy your application, and configure the server components. For more information, refer to the following topics (available from http://www.oracle.com/technology/documentation/index.html):
When you are ready to distribute WebLogic Server with your application, you must make sure that your installer includes the BEA license file (BEA_HOME\license.bea) and the WL_HOME\lib\weblogic.jar file that you specified in Step 3: Updating the WebLogic Server License.
If you do not install both of the files that you specified, your embedded WebLogic Server will not start.
You can use this same license.bea-weblogic.jar pair for all of your licensed installations.For information on using the WebLogic Server silent install process, see Installing WebLogic Server Using Silent Installation.
Upgrading an Embedded WebLogic Server
BEA does not support upgrades to the license.bea-weblogic.jar pair. For example, if you installed your application with a bundled release of WebLogic Server 6.1, you must do the following to upgrade your bundled WebLogic Server to release 7.0:
|
|
|
|
||
 |
|
|
 |
 |
 |
|
||
