Ready GXP is deprecated. Please use the OpenGeo Suite Client SDK instead.
The intention of this project is to provide a simple reusable template for GeoExt applications bound for a servlet container. To get started, see http://github.com/ahocevar/gxp-simpledemo/ for a simple WMS/WFS browser/editor created on top of the structure provided by Ready GXP.
curl -L https://github.com/opengeo/readygxp/raw/master/readygxp.sh | sh -s myapp
- Use git from the Windows command prompt (this is an option at setup)
- Download https://github.com/opengeo/readygxp/raw/master/readygxp.bat into the directory where you want to create your app
- Run readygxp.bat
Enhancements to come later. For now, an application can be run as follows:
Loads all scripts uncompressed.
ant init ant debug
This will give you an application available at http://localhost:8080/ by
default. You only need to run
ant init once (or any time dependencies
To create a servlet run the following:
The servlet will be assembled in the build directory.
Ready GXP uses Cargo to deploy apps to a remote
OpenGeo Suite instance's servlet container. The name of the app is set in root element of the
build.xml file and defaults to
<project name="readygxp" default="dist" basedir=".">
deploy-static target to deploy, otherwise use
deploy. A typical ant
command to deploy your app named
readygxp to http://my.suite-instance.com:8080/readygxp/` is
ant deploy-static -Dcargo.host=my.suite-instance.com -Dcargo.password=abc123
To undeploy the app, use
ant undeploy -Dcargo.host=my.suite-instance.com -Dcargo.password=abc123
There are more Cargo options available to the
ant deploy-static and
ant undeploy commands, and all are appended by using
cargo.host: The OpenGeo Suite host to deploy to. Default is
cargo.port: The port the OpenGeo Suite's servlet container runs on. Default is
cargo.container: The servlet container used by the OpenGeo Suite. Available values are
jetty8x. Default is
cargo.username: The username for the container management servlet. Default is
- cargo.password: The password for the container management servlet. No default.
cargo.context: The name of the servlet context for the app (i.e. the url path for the app). Default is the project name specified in the
The OpenGeo Suite's servlet containers are configured to accept remote deployments. On a fresh OpenGeo Suite installation, the password for remote deployments needs to be configured on the servlet container.
For Windows and OSX installations, the password can be set in the
realm.properties file in the
C:\Program Files\OpenGeo\OpenGeo Suite\etc\ (Windows) or
/opt/opengeo/suite/etc/ (OSX) folder. To use
mypassword as password, this file would have a line like the following:
This means that the username is "manager" (
manager:), and the account is valid for the "manager" group (
For Linux installations, the password can be set in Tomcat's
tomcat-users.xml file. On Debian based distributions (e.g. Ubuntu) with Tomcat 6, this file can be found in
<tomcat-users> <role rolename="manager"/> <user username="manager" password="mypassword" roles="manager"/> </tomcat-users>
The above sets up a user with user name
manager and password