PGX 20.2.2
Documentation

Deploying PGX into Oracle Weblogic

This guide will show you step by step how to deploy PGX as a web application with Oracle Weblogic Server. If you want to use Apache Tomcat instead, check out the corresponding guide.

For evaluation only

Below steps are meant for testing out PGX only. For any serious deployment, you should configure Tomcat to enforce proper authentication and authorization, store the credentials securely and only allow connections over HTTPS (see Weblogic's TLS/SSL howto)

Install Weblogic

This guide uses Weblogic version 12.2.1.3.

  1. Download the Zip distribution with Oracle WebLogic Server only from Oracle OTN.
  2. Unzip the downloaded file into a location of your choice, e.g.

    unzip $HOME/Downloads/fmw_12.2.1.3.0_wls_Disk1_1of1.zip -d $HOME
    
  3. Run the installer.

    cd fmw_12.2.1.3.0_wls_Disk1_1of1
    java -jar fmw_12.2.1.3.0_wls.jar
    
  4. The script will start installation and prompt you to create a domain: choose Yes

  5. Enter username and password for the admin console. The password must be at least 8 alphanumeric characters with at least one number or special character in it.

  6. Set the MW_HOME environment variable, e.g.

    export MW_HOME=$HOME/Oracle/Middleware/Oracle_Home
    
  7. Start the server

    cd $MW_HOME/user_projects/domains/base_domain
    ./bin/startWebLogic.sh
    
  8. The server will then start up. You will know that it is running when something like the following is printed to the console:

    <Nov 26, 2014 4:36:14 PM PST> <Notice> <WeblogicServer> <BEA-000360> <The server started in RUNNING mode> 
    <Nov 26, 2014 4:36:14 PM PST> <Notice> <WeblogicServer> <BEA-000365> <Server state changed to RUNNING.>
    

Problems when starting Weblogic

We noticed that on some distributions the last step of the installation (starting Weblogic) fails, because Weblogic can not determine the IP address of the machine. Read more about this problem and the solution in the troubleshooting.

Set up Weblogic

Open the Weblogic Admin Console by opening localhost:7001/console in your browser. Log in using the credentials you specified during the previous installation step.

Enable Tunneling

To deploy PGX's WAR over HTTP, we need to enable tunneling first. In the Weblogic admin console, click on Environment (left panel) → Servers (left panel) → myserver(admin) (main panel) → Protocols (top tab bar) → Check the box Enable Tunneling → Click Save button.

Deploy PGX

Deploy PGX WAR via command line, passing your admin credentials and the PGX WAR file:

cd $MW_HOME/user_projects/domains/base_domain
. bin/setDomainEnv.sh
java weblogic.Deployer -adminurl http://localhost:7001 -username <username> -password <password> -deploy -upload $PGX_HOME/shared-memory/server/pgx-webapp-20.2.2.war

If everything was successful, the command will print something like

...
Target state: deploy completed on Server myserver

Test the Connection

Check whether you can connect to the server:

$PGX_HOME/bin/pgx-jshell -b http://localhost:7001/pgx