ISV Partners' Guide
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
WebLogic Server provides a rich set of system installation, configuration, and administration tools that enable you to install and configure a custom environment in which WebLogic applications can run. Whether you are redistributing WebLogic Server with your value-added solution, or distributing an application that runs on WebLogic Server, you will want to use these tools to package a product that your customers can install and use easily.
This chapter introduces tools for the following tasks:
The following topics are included:
The configuration tasks that you or your customers undertake may include the following:
As a partner, accommodating these tasks typically requires you to do the following:
The remaining sections of this chapter introduce two sets of tools: configuration tools for creating a domain, a domain template, or an extension template, and tools for incorporating templates or template extensions into your customers' environments.
As summarized in Configuration Wizard, the Configuration Wizard is a stand-alone Java application that can be run independently of WebLogic Server to simplify the jobs of creating, configuring, and customizing a WebLogic domain. A domain is the basic unit of administration in a WebLogic Server environment: it comprises the WebLogic Server components, user-written programs, machines, and resources, such as databases, needed for a particular application.
The Configuration Wizard is designed to simplify and automate the following processes:
The Configuration Wizard operates off-line; that is, when WebLogic Server is not running. It is not designed for use online when a WebLogic Server instance is running.
Typically, the Configuration Wizard is used to:
For complete details about using the Configuration Wizard, see Creating WebLogic Domains Using the Configuration Wizard.
For complete details about WebLogic domains, see the following:
The Domain Template Builder is a stand-alone Java application you use to create custom configuration and extension templates that can be used later for creating and updating domains. Using an existing domain or template, the Domain Template Builder guides you through the process of creating custom configuration and extension templates. You can then package these templates or extension templates with your software so your customers can use them to customize their WebLogic Server environments.
The Domain Template Builder is especially useful for ensuring that the required environment for WebLogic-based products can be installed and configured easily by your customers at their sites.
For more information about the Domain Template Builder, see Creating Templates Using the Domain Template Builder.
The unpack
command provides a highly streamlined way to create a full domain or a Managed Server domain. You may use unpack
only with a template compatible with your current installation. The template can be any of the following:
pack
command pack
command. A Managed Server template, by default, contains only those files necessary for creating a Managed Server domain. When you use the unpack
command with a domain template, unpack
creates a domain containing all the application and resource files defined in the template. It also creates necessary start scripts, and certain security and configuration files.
For more information, see Creating Templates and Domains Using the pack and unpack Commands.
The WebLogic Scripting Tool (WLST) is a command-line interface that you use to configure WebLogic Server instances and domains, and manage and persist WebLogic Server configuration changes.
WLST enables you to do the following:
config.xml
file Based on the Java scripting interpreter, Jython, WLST interprets commands either interactively, as they are supplied, one at a time, from a command prompt, or in batches, when they are supplied in a file (script) or embedded in your Java code. You can use the scripting tool online (connected to a running server) or offline (not connected to a running server).
For more information about WLST, see WebLogic Scripting Tool.
WebLogic Server provides a number of administration tools, in addition to the Configuration Wizard, that you can use to customize the environment in which you run WebLogic Server or any of its components. This section briefly describes some of these tools.
The BEA WebLogic Server Administration Console is a Web browser-based, graphical user interface you use to manage a WebLogic Server domain. A WebLogic Server domain is a logically related group of WebLogic Server resources that you manage as a unit. A domain includes one or more instances of WebLogic Server and may also include WebLogic Server clusters. Clusters are groups of WebLogic Server instances that work together to provide scalability and high-availability for applications. You deploy and manage your applications as part of a domain.
One instance of WebLogic Server in each domain is configured as an Administration Server. The Administration Server provides a central point for managing a WebLogic Server domain. All other WebLogic Server instances in a domain are called Managed Servers. In a domain with only a single WebLogic Server instance, that server functions as both Administration Server and Managed Server. The Administration Server hosts the Administration Console, which is a portal application accessible from any supported Web browser with network access to the Administration Server.
You can use the Administration Console to:
In version 9.0, the architecture of the WebLogic Server Administration Console provides many new features for customization and extensibility. For a summary of the extensibility features, see Administration Console Extensions.
For complete details about the WebLogic Server Administration Console, see Administration Console Online Help.
WebLogic Server provides several techniques for starting server instances and clusters, all of which can be encapsulated in WebLogic Server startup scripts that are installed with the domain template. Your choice of technique for starting an embedded server depends on the complexity of the WebLogic Server domain that you install, the number of computers that host server instances within the domain, and the underlying operating system.
For example, which startup script you use may depend on whether any of the following statements apply to the domain in the target environment:
For more information about startup scripts, see Starting and Stopping Servers in Managing Server Startup and Shutdown.
After you create the domain templates or extension templates appropriate for your application, you need to consider how you want your customers to install WebLogic Server (or selected components) and configure their environments. This section introduces WebLogic Server utilities that can help you provide your customers with a simplified, easy-to-use method of configuring their environments:
Silent-mode installation is a non-interactive method of installing software on one or more machines. It is accomplished via a script that specifies the installation options that users provide during an interactive installation. A silent-mode installation can be performed on both Windows and UNIX systems.
When a customer uses silent-mode, the installation program reads the values for various installation options from the silent-mode script, instead of prompting the customer to enter values in real time. Once you set the required configuration options in a script, the same script can be used for multiple installations on different machines.
For more information about silent-mode installation, including sample scripts, see Running the Installation Program in Silent-Mode in BEA Products Installation Guide.
Two primary mechanisms are available for automating the configuration of a domain or domain extension from a script:
Domain configuration from a script enables you to define configuration information for a domain once, and then duplicate that domain on other machines. Thus, by using this feature, you can create a mechanism that allows you to duplicate a domain on customers' machines.
As mentioned in unpack Command, you can use the unpack
command to create a full domain or a Managed Server domain quickly from a domain template.
Using a WLST offline script, you can create a new domain or update an existing domain without connecting to a running instance of WebLogic Server. Your WLST script can configure a new domain by using a domain template JAR created by the Domain Template Builder or pack
command.
When you combine silent-mode installation and configuration from scripts, you have a powerful method that lets you install your WebLogic product and configure a domain for it in a way that is transparent to customers. When your customers run a silent-mode installation script, followed by a domain configuration script, they experience the work of setting up an environment as a seamless process.
Note that a silent-mode installation script cannot invoke either WLST or the unpack
command. However, you can create a simple shell script or command file that sequentially runs both the installation program in silent mode and WLST. For details about silent installation and domain configuration, see the following:
![]() ![]() |
![]() |
![]() |