Plex-XML Community Edition (Start)

From Plex-XML
Jump to: navigation, search
By following the next steps you should be able to deploy and run our tutorial application on your local PC.
All necessary applications like the Tomcat servlet engine and the MySQL database will run locally on your PC. No external server is involved.


Contents

Before you start

Before you can start you need to ...

  • Install Plex (7.0 incl. PTF >= 38.001)
  • Install Java runtime environment ( >=1.6)
  • Install Apache Tomcat ( >=7.0)
  • Install MySQL (>=5.0.36) ( Typical installation should be sufficient)
    • the only configuration change I have done is to select the "Multilingual Character Set" as default
  • Install Eclipse (>= 3.7 recommended, but not necessary)
  • Install the JDBC driver
    • Download the MySQL JDBC Driver from (http://www.mysql.com/products/connector/)
    • unpack th zip and copy mysql-connector-java-5.x.y-bin.jar to C:\Program Files\Apache Software Foundation\Tomcat 7.0\lib or where ever you installed to Tomcat

If one of these components is not running properly you may find additional help at our tutorial.


Run your first Plex-XML application

  1. Download the PCE.ZIP file and unzip it
  2. Read the Plex-XML community edition license which is available here and in the ZIP file and make sure it fits to your needs.
  3. Import the enclosed Eclipse-Project to your Eclipse workspace.
  4. Get the tutorial.sql MySQL file from the database folder and restore it to your MySQL database ( the following code is an example using the mysql command line client):
    1. mysql -u<adminuser> -p<adminpassword>
    2. create database tutorial; -- creates the database
    3. grant all privileges on tutorial.* to xxx@localhost identified by 'xxx'; -- creates a user 'xxx' with all privileges on the new database
    4. use tutorial; -- switch to database
    5. source tutorial.sql; -- create tables and views and import some base data
    6. exit
  5. Your have to accept one of the available license agreements for the release 4.1 of the Ext JS framework. Download the Ext JavaScript library (Release 4.1 from http://www.sencha.com/products/extjs/download unzip it and put the resources folder and the ext-all.js into the web/jscript/ext4 folder.
  6. Open the "default.ant.properties" file in the root directory of the project and adjust the "tomcat.home=C:/Java/Tomcat70" to your tomcat home directory. Be aware to use the Slash ("/") instead of the BackSlash("\")
  7. Open the "deployment/localtomcat.properties" file and adjust the JDBC settings with your configuration.
  8. Drag the "build.xml" file to your Ant perspective and execute the "deployLocal" task.
  9. Open your first Plex-XML application http://127.0.0.1:8080/plexxml/aServlet :-)
  10. Smile and start to write the web application you always dreamed of.


Any hick ups so far?

Please check our page of most common Plex-XML rookie problems


Continue to create some more functionality

Personal tools