Oracle Weblogic 11g
Oracle Weblogic 11g
This section explains how to deploy Elastic Path web applications on a Weblogic production server.
Note: Before you begin
Make sure that:
- A Java 7 JDK or JRE is installed.
- Oracle Weblogic 11g is installed.
- You have the Web Application .WAR files that were specifically built for Weblogic. For more information, see Elastic_Path_Maven_Commands.html#BuildingWARFiles.
- You have synchronized the date and time of all application servers with the date and time of your database server.
Installing Java Advanced Imaging
If you are using Storefront, you must install Java Advanced Imaging into your production server's JDK as detailed below:
- Go to: http://download.java.net/media/jai/builds/release/1_1_3/
- Download and unzip jai-1_1_3-lib.zip
- Copy the contents of JAI_HOME\lib to your Java_HOME\jre\lib\ext directory.
Preparing the Weblogic Domain
Creating the Domain
- Start the WebLogic Configuration Wizard.
- On Windows, from the Start menu, choose All Programs -> Oracle Weblogic -> Quickstart and select Getting Started with Weblogic Server 10.3.
- On Linux, launch <WEBLOGIC_HOME>/wlserver_10.3/common/bin/config.sh.Note: GUI Configuration Note
You must have an X server configured to use the GUI configuration tool.
- Select Create a new WebLogic domain and click Next.
- Select Generate a domain configured automatically to support the following Products and click Next.
- Enter a domain name and click Next.
- Enter a user name and password for the WebLogic administrator account and click Next.
- Select Sun SDK 1.7 in the Available JDKs list or select Other JDK and specify the Java Development Kit with Java Advanced Imaging installed.
- Make sure Production Mode is selected and click Next.
- Click Next without selecting any optional configurations.
- Review the Configuration Summary and click Create. WebLogic creates the domain in the <WEBLOGIC_HOME>/user_projects/domains directory.
- Click Done.
Configuring Startup Scripts
- On Windows, open <DOMAIN_HOME>\bin\setDomainEnv.cmdwith a text editor and add the following:
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 set USER_MEM_ARGS=-Xms256m -Xmx1536m -XX:MaxPermSize=512m set EXTRA_JAVA_PROPERTIES=%EXTRA_JAVA_PROPERTIES% -Dsun.lang.ClassLoader.allowArraySyntax=true
- On Linux, open <DOMAIN_HOME>/bin/setDomainEnv.shwith a text editor and add the following:
JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0" export JAVA_OPTIONS USER_MEM_ARGS=-Xms256m -Xmx1536m -XX:MaxPermSize=512m export USER_MEM_ARGS EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dsun.lang.ClassLoader.allowArraySyntax=true export EXTRA_JAVA_PROPERTIES
Extracting the Application Archives
The Elastic Path web applications need direct access to the file system, which means that they must be deployed in exploded form.
- In <DOMAIN_HOME>, create a directory (ie. EPWARs) for deploying Elastic Path WAR files.
- For each web application you want to deploy:
- Create a subdirectory inside the directory you just created. Name these subdirectories after the web application. (ie. storefront)
- Copy the web application's WAR file into your new subdirectory.
- In the command prompt, navigate to your subdirectory.
- Enter the following command to extract the WAR file's contents:
jar -xvf storefront.war
Configuring the Weblogic Domain
- Start WebLogic Server from the command prompt.
- On Windows, launch <DOMAIN_HOME>\startWebLogic.cmd.
- On Linux, launch <DOMAIN_HOME>/startWebLogic.sh.
- In a web browser, go to http://localhost:7001/console. This opens the Weblogic Administration Console.
- Log in using your domain's username and password.
- In the WebLogic Administration Console, under Change Center, click Lock & Edit.
Configuring SSL
- In the Domain Structure tree, expand the Elastic Path domain and click Environment -> Servers.
- In the Servers list, click AdminServer(admin).
- In Configuration -> General, select SSL Listen Port Enabled.
- Click Save.
Configuring the JNDI data source
- In the Domain Structure tree, expand the Elastic Path domain and select Services -> JDBC -> Data Sources.
- In the Summary of JDBC Data Sources pane, under Data Sources, click New.
- In the JDBC Data Source Properties page, enter the following information and click Next:
- In the Transaction Options page, click Next.
- In the Connection Properties page, enter your database connection information and click Next.
Note: MySQL Database NoteIn the Test Database Connection page, click Test Configuration. If your connection information is correct, you will see a success message.
If you are using a MySQL Database, enter the following Properties under the Properties box in the Test Database Connection page:
useUnicode=true user=%USERNAME% characterEncoding=utf-8 AutoReconnect=true
- Click Next.
- In the Select Targets page, select AdminServer and click Next.
- Click Finish.
Deploying Path Web Applications
- In the Domain Structure tree, expand the Elastic Path domain and click Deployments.
- Do the following for each Elastic Path web application you want to deploy:
- In the Summary of Deployments pane, click Install.
- Locate the directory where you extracted the war files. Click the radio button next to the subdirectory name and click Next.
- Select Install this deployment as an application and click Next.
- In the Optional Settings page, under Source accessibility, select the I will make the deployment accessible from the following location option. Then click Finish.
Note: Deploy the Search Server to use Cortex SearchYou must have the search server deployed and running to use Cortex API's search functionality.
- When you are done, click Activate Changes under Change Center.Note: Restart WebLogic
You may need to restart your WebLogic server before the new settings take effect.