Home > Installation

Install Note for WebLogic 8.1

Warnings

• This chapter describes a quick installation example of EBX.Platform on BEA WebLogic Application Server.

• It does not replace the documentation of this application server.

• It is not a general installation recommendation, since current installation process is fixed by architecture choices (technical environment, applications mutualization, delivery process, company choices, etc.).

• The complete description of the components needed by EBX.Platform is given in chapter Components. 

• In this document, we do not deploy an additional EBX.Platform module. For this, a good practice would be to rebuild an EAR with the EBX.Platform module as a Web application at the same level as other EBX.Platform Web applications. In this case, the web application must declare its class-path dependency in the standard manner specified by Java™ 2 Platform Enterprise Edition Specification, v1.4:

  J2EE.8.2 Optional Package Support

  (...)

  A JAR format file (such as a .jar file, .war file, or .rar file) can reference a .jar file by naming the referenced .jar file in a Class-Path header in the referencing JAR file’s Manifest file. The referenced .jar file is named using a URL relative to the URL of the referencing JAR file. The Manifest file is named META-INF/MANIFEST.MF in the JAR file. The Class-Path entry in the Manifest file is of the form

  Class-Path: list-of-jar-files-separated-by-spaces

  In an "industrialized" process, we strongly recommend to develop a script that automatically builds the EAR, with the specific EBX.Platform module(s), the EBX.Platform Web applications and also all the shared libraries needed.

• In order to avoid unpredictable behavior, the minimal rule to follow is to avoid any duplication of ebx.jar or other libraries on the class-loading system.

Installation Example Overview

• Create the EBX_HOME directory: copy ebx.properties

• Install EBX.Platform library: add libraries in the CLASSPATH environment variable

• Configure JVM arguments (Java system properties): Create the JAVA_OPTIONS environment variable

• Create an application domain by using the "Configuration Wizard"

• Deploy EBX.Platform application by using WebLogic Server Console

Installation Example Detail

1. Create a EBX_HOME directory, for example C:\EBX\home

2. Create a EBX_LIB directory, for example, C:\EBX\lib

3. Create a EBX_EAR directory, for example C:\EBX\ear

4. Copy ebx.software\files\ebx.properties file to EBX_HOME. In our example, we will then have the following file:

   C:\EBX\home\ebx.properties, a text file

5. Copy third-party library files to EBX_LIB directory. In our example, we will have:

   C:\EBX.software\lib\activation.jar

   C:\EBX.software\lib\mail.jar

   C:\EBX.software\lib\hsqldb.jar

   The exact description of these components is given in chapter Components. Obviously, if those components are already deployed on the class-loading system, they don't have to be duplicated.

6. Copy the file ebx.software/webapps/ear-packaging/ebxPlatformForWebLogic.ear to the EBX_EAR directory. In our example, we will have:

   C:\EBX\ear\ebxPlatformForWebLogic.ear

7. Create environment variables

   Variable name CLASSPATH: add C:\EBX\lib\mail.jar;C:\EBX\lib\hsqldb.jar;C:\EBX\lib\activation.jar

   Variable name EBX_HOME_WEBLOGIC: variable value to set is C:\EBX\home

   Variable name JAVA_OPTIONS: variable value to set is

   -Debx.home=%EBX_HOME_WEBLOGIC% -Debx.properties=%EBX_HOME_WEBLOGIC%\ebx.properties

8. Launch the console "BEA WebLogic Platform 8.1 – Configuration Wizard"

9. Select "Create a new Weblogic configuration"

10. Click on the button "Next"

11. Select "Basic WebLogic Server Domain"

12. Click on the button "Next"

13. Select "Express"

14. Click on the button "Next"

15. Configure the name and password for the administrator. In our example, the name is weblogic and the password is weblogic.

16. Click on the button "Next"

17. Select "Production Mode", "Sun SDK 1.4.2_08@ …"

18. Click on the button "Next"

19. Select "Template –Server - myserver", and replace "mydomain" by "ebxDomain" in the field "Configuration Name"

20. Click on the button "Create"

21. Select "Start Admin Server"

22. Click on the button "Done"

23. In the console "C:\WINDOWS\system32\cmd.exe – startWebLogic.cmd", type "weblogic" for user name and "weblogic" for password

24. Launch "Internet Explorer" (or Firefox), enter the url: http://localhost:7001/console

25. Enter "weblogic" for user name and "weblogic" for password

26. In the menu on the left, click "ebxDomain/Deployments/Applications". In the page on the right, click "Deploy a new Application…"

27. In "Location", select the ebxPlatformForWebLogic.ear directory. In our example, it is: C:/EBX/ear

28. Select ebxPlatformForWebLogic.ear, then click on the button "Continue"

29. Click on the button "Deploy". The EBX.Platform application is deployed and launched (see information in the command console)

30. Quit the server: in the command console, press simultaneously on Ctrl-C, then close the console

31. Restart the server: Windows – Start – All programs – BEA WebLogic Platform 8.1 – User Projects – ebxDomain – Start Server

32. Enter http://localhost:7001/console in Internet Explorer (or Firefox)

33. In the menu on the left, click on "ebxDomain/Deployments/Applications/ebxPlatformForWebLogic"

34. In the page on the right, select "Deploy", then click on the button "Start Application"

35. Run EBX.Platform.

After Tomcat launch, run EBX.Manager Web application: http://localhost:7001/ebx/. 

At first launch, EBX.Platform Wizard helps you to configure the default properties of your initial repository.

 

Home > Installation