Avitek Medical Records Development Tutorials

Configuring Domains and Servers

Tutorial 1: Creating a WebLogic Domain and Server Instance for Development

In this tutorial you use the WebLogic Server Configuration Wizard to create a domain and server to deploy and run the MedRec applications.The tutorial also shows you how to start the server.

The Configuration Wizard asks for information about the domain you want to create based on the configuration template you select, and then creates a config.xml file, along with other supporting configuration XML files, for the domain based on your responses. The Configuration Wizard also creates startup scripts for the server instances in the domain, and other helper files and directories to help you start and use the new domain and its servers. You will work with these scripts and directories in later tutorials.

The tutorial includes:

Prerequisites

Before starting this tutorial:

Make sure WebLogic Server 9.1 and the server samples are installed on your computer.
Read Overview of the Avitek Medical Records Development Tutorials.

Procedure

To create the MedRec domain and the WebLogic Server instance to which you will deploy MedRec, follow these steps. You will use the domain and server in later tutorials.

Step 1: Create the MedRec domain and MedRec server.

The MedRec domain includes a single server that will host the MedRec back-end services, the MedRec Administration application, and the Patient application (both applications are Web applications).

Launch the Configuration Wizard:

Start—>All Programs—>BEA Products—>Tools—>Configuration Wizard

In the Welcome window, select Create a new WebLogic domain.

Click Next.

In the Select Domain Source window, select the option that begins Generate a domain configured automatically ...

For the sake of simplicity, do not check AquaLogic Service Bus or Apache Beehive.

Click Next.

In the Configure Administrative Username and Password window, enter:

weblogic for User Name
weblogic for User Password and Confirm user Password
An optional description.

You use this username and password when you start the server and log in to the Administration Console.

Note: In a production environment the user name and password should not be the same.

Click Next.

In the Configure Server Start Mode and JDK window, select:

Development Mode for WebLogic Domain Startup Mode
Sun SDK 1.5.0_XX @ JDK_location, under the BEA Supplied JDKs option, for JDK Selection

The Sun SDK is the default choice for Development mode. You can select either the Sun SDK or the JRockit SDK. The Sun SDK offers faster startup times, where as the JRockit SDK offers faster runtime performance on Intel architectures.

Click Next.

In the Customize Environments and Services Settings window, select Yes.

Click Next.

In the Configure the Administration Server window, enter or select:

MedRecServer for Name.
All Local Addresses for Listen Address.
7101 for Listen Port.

This tutorial specifies that you enter a port number that is deliberately different from the default port number of the Examples server (7011), which is also the general default WebLogic Server port number. If you have already configured this number for another WebLogic Server instance, enter a different value to avoid network communication conflicts. The port must be dedicated TCP/IP port for the Administration Server. The port number can be any integer from 1 to 65535.

The SSL Enabled check box.
7102 for SSL Listen Port.

This tutorial specifies that you enter an SSL port number that is deliberately different from the default SSL port number (7012). If you have already configured this number for the SSL listen port of another WebLogic Server instance, enter a different value to avoid network communication conflicts. The port must be dedicated TCP/IP port and cannot be the same as the Server Listen Port. The port number can be any integer from 1 to 65535.

Click Next.

Select Next in the following windows without making any changes:

Configure Managed Servers
Configure Machines

In the Review WebLogic Domain window, click on MedRecServer in the left pane and review your choices, then click Next.

In the Create WebLogic Domain window:

Enter MedRecDomain as the Domain Name.

Click Create to create the MedRec domain in the folder displayed in the Domain Location text box. When the Configuration Wizard finishes creating the domain, the Domain Created Successfully! message is displayed.

Click Done to close the Configuration Wizard.

Do not check Start Admin Server.

Step 2: Enable log4j for logging application messages.

The MedRec application suite uses log4j for logging application messages. You must copy the log4j properties file from the pre-configured MedRec domain and identify it using a startup option in MedRecServer startup script. You also need to copy the log4j jar files to the lib directory of the MedRec domain. To complete these steps:

Copy the log4j properties file from the pre-configured MedRec domain (under the main WebLogic Server installation directory) to the new domain you just created.

For example, if you installed WebLogic Server in the c:\bea directory, then enter the following in a command-line shell: prompt> copy c:\bea\weblogic91\samples\domains\medrec\log4jConfig.xml c:\bea\user_projects\domains\MedRecDomain

Open the setDomainEnv.cmd script, located in the bin directory of your newly created domain directory, for your new domain in a text editor. For example:

prompt> notepad c:\bea\user_projects\domains\MedRecDomain\bin\setDomainEnv.cmd

Find the following line in the setDomainEnv.cmd script:

if NOT "%LOG4J_CONFIG_FILE%"=="" (

Add the following two lines immediately before the line specified in the preceding step:

set LOG4J_CONFIG_FILE=c:\bea\user_projects\domains\MedRecDomain\log4jConfig.xml

for %%i in ("%LOG4J_CONFIG_FILE%") do set LOG4J_CONFIG_FILE=%%~fsi

It is assumed in the preceding text that the MedRecDomain directory is c:\bea\user_projects\domains\MedRecDomain; enter your exact domain directory if it is different.

Save the file and exit your text editor.

Copy the log4j JAR files from the lib directory of the pre-configured MedRec domain to the lib directory of the new domain you just created:

prompt> copy c:\bea\weblogic91\samples\domains\medrec\lib\*.jar c:\bea\user_projects\domains\MedRecDomain\lib

All JAR files in the lib subdirectory of a domain directory are automatically added to the WebLogic Server system CLASSPATH when the servers in the domain start up.

Step 3: Add the MedRecDBMSPlugin.jar to the server's CLASSPATH.

The MedRec application suite uses a custom DBMS authenticator to retrieve login credentials from the configured PointBase RDBMS for a given username. The Java class that implements this authenticator is in the MedRecDBMSPlugin.jar file, located in the already-installed MedRec domain. You must add the JAR file to the MedRecServer's CLASSPATH so that you can successfully configure the custom authenticator using the Administration Console (described in Tutorial 3: Configuring WebLogic Server Resources with the Administration Console).

Open the setDomainEnv.cmd script, located in the bin directory of your domain directory, for your new domain in a text editor. For example:

prompt> notepad c:\bea\user_projects\domains\MedRecDomain\bin\setDomainEnv.cmd

Find the following line in the setDomainEnv.cmd script:

set PRE_CLASSPATH=

Update the PRE_CLASSPATH variable by adding the full path name of the MedRecDBMSPlug.jar file, which is located in the WL_HOME\samples\domains\medrec\security directory, where WL_HOME refers to the root directory of WebLogic Server (default c:\bea\weblogic91). For example:

set PRE_CLASSPATH=c:\bea\weblogic91\samples\domains\medrec\security\MedRecDBMSPlugin.jar

Save the file and exit your text editor.

Step 4: Start the MedRec Administration Server.

Start the MedRec Administration Server using one of the following methods:

From the Start menu:

Start—>All Programs—>BEA Products—>User Projects—>MedRecDomain—>Start Admin Server for WebLogic Server Domain

From a script:

In a command-line shell, go to the root directory of the MedRec domain, typically c:\bea\user_projects\domains\MedRecDomain. For example, from the command prompt, enter:

prompt> cd c:\bea\user_projects\domains\MedRecDomain

Invoke the startWebLogic.cmd script to start the MedRec server:

(Windows) prompt> startWebLogic.cmd
(UNIX) prompt> ./startWeblogic.sh

During startup, you will see a message similar to the following once the server is ready to be used:

<Dec 9, 2005 10:52:20 AM PST> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

Best Practices

Use the Configuration Wizard to create and configure domains. The Configuration Wizard creates the necessary configuration file (config.xml), supporting configuration XML files, directory structure, and startup scripts for each new domain.
Create domain directories outside the WebLogic Server program files. It is best not to mix application files with the application server files. By default, the Configuration Wizard creates domain directories in bea_home\user_projects\domains directory, typically c:\bea\user_projects\domains, which is parallel to the directory in which WebLogic Server program files are stored, typically c:\bea\weblogic91.
Use the lib subdirectory of your domain directory to add one or more JAR files to the WebLogic Server system CLASSPATH when servers start up. The lib subdirectory is intended for JAR files that change infrequently and are required by all or most applications deployed in the server, or by WebLogic Server itself. For example, you might use the lib directory to store third-party utility classes that are required by all deployments in a domain. You can also use it to apply patches to WebLogic Server.

The Big Picture

This tutorial is the basis for setting up your development environment. Before you can deploy applications to a server, you must first configure the domains and servers to which you want to deploy the applications. In this tutorial, you created the MedRec domain, which includes one server to host the MedRec applications. You use this domain for most tutorials.

Configuring Domains and Servers

Tutorial 1: Creating a WebLogic Domain and Server Instance for Development

Prerequisites

Procedure

Step 1: Create the MedRec domain and MedRec server.

Step 2: Enable log4j for logging application messages.

Step 3: Add the MedRecDBMSPlugin.jar to the server's CLASSPATH.

Step 4: Start the MedRec Administration Server.

Best Practices

The Big Picture

Related Reading