|
|
After you install WebLogic Server Virtual Edition, you need to configure LiquidVM, using the LiquidVM Configuration Wizard to specify how it connects to VMware VirtualCenter. This wizard runs either in a GUI-driven, graphic mode or a command line-based console mode. Configuring LiquidVM is a critical step because this is where you identify the file system locations of all WLS-VE components. An improperly configured LiquidVM will not run. This procedure is described in these topics:
Before you run the LiquidVM Configuration Wizard, you need to know the configuration data listed in Table 6-1:
These should be provided to you by your VMware administrator (see VMware VirtualCenter). Please refer to VMware VirtualCenter Security Measures for critical security information about your VirtualCenter password.
|
|
This is optional parameter specifies the default VMware resource pool into which LiquidVM should place new VMs. You can override this parameter using the
VI_RESOURCE_POOL parameter in your WLS-VE startup scripts. A VMware resource pool is a mechanism provided by VMware that allows you to allocate resources dynamically across a large set of servers. Please see the VMware documentation for more information on resource pools.
|
|
This is the ISO file, reachable from the ESX host, that contains the LiquidVM and WebLogic Server classes that you use to host your business applications. Each physical machine that hosts an instance of WLS-VE needs access to this ISO image file. This image is installed during installation of your BEA software, and copied to the ESX server as described in Copying the ISO Image.
|
|
This is the public key certificate from VirtualCenter used to verify that the virtual machine really is itself when bringing up the HTTPS connection. You can obtain this public key certificate from the VirtualCenter machine and LiquidVM will store it for you in a keystore. On Windows, the certificate file is located at
C:\Documents and Settings\All Users\Application Data\VMware\VMware VirtualCenter\SSL\rui.crt
|
|
This optional parameter specifies the VMware virtual network to use. If not set, LiquidVM uses the first available VMware network. To view the available virtual networks in your VMware VirtualCenter client, select Inventory>Networks. You can override the virtual network in the
VI_NETWORK_NAME parameter of your WLS-VE startup scripts. Please see the VMware documentation for more information on virtual networks.
|
To run the LiquidVM Configuration Wizard in the graphic (GUI) mode, use this procedure. Be sure to read Before You Begin so that you gain familiarity with the data required to configure LiquidVM.
| Note: | If you are a Linux user and don't have access to a GUI, please use the procedure described in Configuring LiquidVM in the Console Mode |
On Linux, be sure that you have set the DISPLAY environment variable and enter the command:
<BEA_HOME>/tools/virtualization/control_1.0/bin/lvm_configwizard.sh
The Configuration Wizard runs and the Virtual Center Information Window appears
rui.crt) and, if necessary, its path. Use Browse, if necessary. On Windows, this certificate is stored on the machine that runs VirtualCenter in the directory: c:\Documents and Settings\All Users\ApplicationData\VMware\VMwareVirtualCenter\SSL\rui.crt. If you are not running this Configuration Wizard on the same host on which VirtualCenter was installed, you need to copy the certificate file from the VirtualCenter machine to this machine (that is, the machine running the Configuration Wizard before running the wizard).
The datacenter information window appears.
The LiquidVM disk location window appears.
[<storage name>] <path>/filename.iso
Remember to include the square brackets.
After a few moments, the successful configuration confirmation window appears.
Upon successfully configuring LiquidVM, the Configuration Wizard creates a file in your home directory named bea.lvm.info, which contains all of the information you provided running the wizard. WLS-VE will read this file upon launch to determine the location of critical files. For more information on the bea.lvm.info file, see The bea.lvm.info File.
Console-mode installation is an interactive, text-based method for configuring your software from the command line. This mode is useful for Linux users who don't have a GUI display or don't want to otherwise use the graphic configuration mode described in Configuring LiquidVM in the Graphic Mode. Be sure to read Before You Begin so that you understand the data required to configure LiquidVM.
To complete the console-mode configuration process, respond to the prompts by entering the text representing your choice (filepath, server name, etc.) or by pressing Enter to accept the default. To exit the configuration process, press CTRL-C in response to any prompt.
To configure LiquidVM from the console, use this procedure.
<BEA_HOME>/tools/virtualization/control_1.0>/bin.lvm_configwizard.sh or .cmdLiquidVM Configuration Wizard for ESX (text-mode)
-------------------------------------------------
Collecting information VMware Virtual Infrastructure environment...Virtual center serverUse secure connection (https) to virtual center? [Y/n]
Virtual center username
Do you want to provide the password for your virtual center user? if you do the password will be stored in the configuration file encrypted, if you don't you will be asked for the password every time you launch a LiquidVM. [Y/n]
Virtual center password (you will not see what you type)
| Note: | If you have already set up a password for the VirtualCenter server and want to use that one, simply press Enter. |
Press Enter and follow the appropriate instructions in Table 6-2.
.crt) and path to its location. Press EnterLooking up datacenters...
VMware Datacenter
[numbered list of available datacenters]
Please select one of the above numbers
Looking up compute resources (hosts) in datacenter [datacenter name]...
Default VMware Compute Resource (ESX Host or Cluster)
[numbered list of available resources]
Please select one of the above numbers
Looking up resource pools in [ESX host name]...
VMware Resource Pool (or type any for default resource pool)
Looking up VMware Networks available to[ESX host name]...
VMware Network (or type any to use any available)
[numbered list of available virtual networks]
Please select one of the above numbers [default: <any>]
ISO-image datastore [default: storage1]
Now you should provide the path on storage1 where to find the wlsve.iso
An example of a path is wlsve/wlsve921.iso
ISO-image path:
Checking path...
Datastore for new VMs
The system responds with this confirmation message:
The LiquidVM configuration has now completed successfully.
Configuration data has been stored in the `bea.lvm.info' file
Upon successfully configuring LiquidVM, the Configuration Wizard creates a file in your home directory named bea.lvm.info, which contains all of the information you provided running the wizard. WLS-VE will read this file upon launch to determine the location of critical files and other configuration information. For more information on the bea.lvm.info file, see The bea.lvm.info File.
As indicated above, once the LiquidVM Configuration Wizard successfully runs, it creates a file named bea.lvm.info and stores it in your home directory (for Windows users, that's //Documents and Settings/yourHome; for example C:/Documents and Settings/jtsmith). This file contains all of the configuration information you entered while running the wizard. Listing 6-1 shows an example of a bea.lvm.info file.
#BareMetal ESX-launcher configuration information
#Wed Mar 14 12:54:06 MDT 2007
keystorePassword=4f2e0e4edd112535
username=Administrator
diskDatastorePath=[storage1] training/wlsve921_77815.iso
vchost=cleese.bea.com
version=4
keystore=C\:\\Documents and Settings\\jtsmith\\bm_cleese.bea.com.keystore
esxhost=okra.bea.com
datacenter=ARC QA Infra
password=794f81c07b912561ec2f14fae0a01daf776d284b31cebd9a
| Note: | Please refer to VMware VirtualCenter Security Measures for critical security information regarding the password= property in the bea.lvm.info file. |
bea.lvm.info is read by the WLS-VE launcher (java_esx) at startup to glean your LiquidVM configuration specifics. The WLS-VE launcher looks for bea.lvm.info in the location specified by the LVM_INFO environment variable (your home directory by default). This file contains information about VirtualCenter and default information about which ESXServer to start new WLS-VE instances on. None of this information is typically specific to the machine that ran the Configuration Wizard so you can copy it between different launching machines; however, since the launcher will search for this file in your home directory, if you move it from there (or if you rename it), you will need to set the environment variable LVM_INFO to the path to the copy.
For information about how to troubleshoot problems that may result from how your LiquidVM instance is configured, see Troubleshooting WLS-VE Problems in Diagnostics and Troubleshooting.. That chapter also describes what steps you need to take to submit an issue to BEA Support.
|