Run Java Smart Ticket Application 2.0 with the Borland® Enterprise Server™ 5.2.1

• Download and Install Borland Enterprise Server
• Download the Java 2, Micro Edition Wireless Toolkit
• Download the Java Smart Ticket 2.0 Application for Borland Enterprise Server
• Install the Persistence Manager Patch for Borland Enterprise Server 5.2.1
• Build the Java Smart Ticket 2.0 Application (optional)
• Deploy Smart Ticket Application to Borland Enterprise Server
• Access Smart Ticket
• Support

If you do not already have Borland Enterprise Server then you can download a fully functional trial copy of Borland Enterprise Server from http://www.borland.com/besappserver. You must run Smart Ticket 2.0 with Borland Enterprise Server version 5.2.1 or later.

Follow the instructions in the Installation Guide.

The remainder of this document will refer to the installed Borland Enterprise Server directory as <bes_install>.

Download the Sun's Java(TM) 2, Micro Edition Wireless Toolkit 2.0 installer from http://java.sun.com/products/j2mewtoolkit/download-2_0.html, and execute it.

The remainder of this document will refer to the installed J2ME Toolkit directory as <j2metk_install>.

Download the Sun's Java(TM) Smart Ticket for Borland Enterprise Server from http://www.borland.com/devsupport/bes/downloads/deployathon/smarticket/smartticket-2_0-ea.zip and unzip it.

The remainder of this document will refer to the unzipped smart_ticket directory as <smart_ticket_install>.

If you are running Borland Enterprise Server 5.2.1, you will need to patch the Persistence Manager in order to run Smart Ticket 2.0.

To patch Borland Enterprise Server 5.2.1's Persistence Manager, copy the <smart_ticket_install>/share/patches directory to your <bes_install>/lib directory.

Please note that this patch can only be used with Borland Enterprise Server 5.2.1. It is not required for subsequent versions of Borland Enterprise Server.

This step is optional. You can build Smart Ticket from scratch by changing directory to the <smart_ticket_install>/src directory, and:.

• Set the J2MEWTK_HOME environment variable to your <j2mewtk_install> directory.
• Set the BES_HOME environment variable to your <bes_install> directory
• Run the provided build script (build.bat or build.sh)

Windows:

  prompt> cd <smart_ticket_install>
  prompt> set J2MEWTK_HOME=<j2mewtk_install>
  prompt> set BES_HOME=<bes_install>
  prompt> build.bat

Unix (Bourne or Korn Shell):

  prompt> cd <smart_ticket_install>
  prompt> export J2MEWTK_HOME=<j2mewtk_install>
  prompt> export BES_HOME=<bes_install>
  prompt> build.sh

This will build the smart_ticket.ear in the <smart_ticket_install>/src/app/server/build and the smart_ticket-client.jar and smart_ticket-client.jad in the <smart_ticket_install>/src/app/client/build directory.

You can either just deploy the smart_ticket.ear provided in the <smart_ticket_install> directory, or the one you have optionally built in the <smart_ticket_install>/src/app/server/build directory.

Deploying smart_ticket ear:

Run up the Borland Enterprise Server Console, select the Wizards menu, then select select the Deployment Wizard.

• Select Add... and browse to either
  • The <smart_ticket_install> directory, or
  • The <smart_ticket_install>/src/app/build directory, if you've run the Smart Ticket build.
    
• Select smart_ticket.ear, then OK, then Next.
• Make sure the Deploy to a Set of Partitions option is checked.
• Select a Target Partition.
• Click Finish. The Deploying Modules dialog indicates when the deployment is complete.

Smart Ticket is a J2ME Mobile Information Device Profile (MIDP) application. To run Smart Ticket, you will need to either:

• Use the J2ME Wireless Toolkit emulator, or
• Use a mobile device that supports J2ME.

To run with the J2ME Wireless Toolkit emulator, you will need to:

• Select the Windows Start Menu, select Programs, select J2ME Wireless Toolkit 2.0, and
  • Double click on the Run MIDP Application ... shortcut, and
  • Select the smart_ticket-client.jad file from either the <smart_ticket_install> directory, or, if you've run the Smart Ticket build, from the <smart_ticket_install>/src/app/build directory

  or:

• Change directory to the <smart_ticket_install> directory - or, if you've run the Smart Ticket build, from the <smart_ticket_install>/src/app/build directory - and execute <j2metk_install>/bin/emulator -Xdescriptor:smart_ticket-client.jad

This will open the emulator with the Smart Ticket J2ME Wireless Toolkit MIDP app (the smart_ticket-client.jad file). Please note that the smart_ticket-client.jad file must be located in the same directory as the smart_ticket-client.jar.

To run with a J2ME mobile device, you will need to obtain this device from a service provider which supports J2ME. You can browse a list of such mobile devices at http://wireless.java.sun.com/device.

For example, Motorola manufactures J2ME phones which are available and serviced through Nextel. To run with a Motorola J2ME device with Nextel as your carrier:

• Obtain a Motorola J2ME (which supports MIDP 1.2 or 2.0) phone through any Nextel store.
• Get details about the iDEN Developer Program at http://idenphones.motorola.com/iden/developer/developer_home.jsp
• Follow the instructions at https://idenonline.motorola.com/ideveloper/program/program_jal.cfm to:
  • Register for a Nextel developer plan,
  • Obtain a iDEN Developer Program userid,
  • Download the iDEN Update Software Application, and
  • Use the iDEN Update Software Application to provision the J2ME client software onto your phone.

From either the J2ME emulator or mobile device, follow the menus to run the Smart Ticket app.

The j2meblueprints interest list is the place to get answers to questions about running Smart Ticket with Java 2 SDK, Enterprise Edition 1.3 for Solaris. To join the interest list, send an email to listserv@java.sun.com. Specify subscribe j2meblueprints-interest yourlastname yourfirstname in the body of the email.