apex listener

How to Use the Standalone APEX Listener [ID 1190053.1]


Starting with version 1.0.2.238.15.24, it is possible to run the APEX Listener from the command line without the installation of a J2EE web server, such as WebLogic, OC4J or Glassfish. This configuration is useful for running APEX in a desktop environment or as a debugging tool for APEX and / or  APEX Listener in a standard web server environment.

Running the APEX Listener in standalone mode will overwrite any existing apex-config.xml in the <java.io.tmpdir> location:
Windows: C:\Documents and Settings\dicook\Local Settings\Temp\apex
UNIX: /tmp/apex
Make sure to create a back up of the existing apex-config.xml file,  prior to running the APEX Listener in standalone mode.

Solution

Though this example is for Windows, the same concepts apply to running the APEX Listener on UNIX, as well.

Running the APEX Listener Standalone

The APEX Listener is dependent on the 1.6.0 JRE. To verify whether 1.6 is installed run the following command:

C:\>java -version
java version "1.6.0_20"
Java(TM) SE Runtime Environment (build 1.6.0_20-rev-b07)
Java HotSpot(TM) Client VM (build 16.3-b05, mixed mode, sharing)

 If a 1.6.0 version of the JDK does not exist on your machine, the latest JRE can  be downloaded from the following location:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
To run the APEX Listener in standalone mode:
1. Change directories to the location of the apex.war file:

D:\>cd apex_listener

2. Run the following command:

C:\Program Files\Java\jdk1.6.0_20\bin\java -jar apex.war

Where C:\Program Files\Java\jdk1.6.0_20 is the location of the 1.6.0 JDK on your machine.

3. When prompted for the images location, enter the directory for the APEX images:


4. Enter the username / password for the APEX Listener Administrator and Listener Administrator:

Enter the path to the directory containing the APEX static resources
Example: /Users/myuser/apex/images
or press Enter to skip: d:\apex\apex40\apex\images

Where d:\apex\apex40\apex\images is the location of the APEX images directory on the local machine.

Enter a username for the APEX Listener Administrator [adminlistener]: listeneradmin
Enter a password for listeneradmin:
Confirm password for listeneradmin:
Enter a username for the APEX Listener Manager [managerlistener]: listenermanager
Enter a password for listenermanager:
Confirm password for listenermanager:

5. The http://localhost:8080/apex/listenerConfigure page is brought up. Enter the APEX Admin and
database connection information, and click "Apply".