To develop Jython on Django applications for Enterprise Server, you must do the following :
Install Jython
Install Django
Install the Jython container for Enterprise Server
Jython can be installed in one of the following ways:
Install Jython as a standalone product
Install Jython from GlassFish Update Center
The following sections explain these tasks in more detail.
You can download Jython and install it as a standalone product. If Jython is installed as standalone, you need to inform the Jython install location to the Enterprise Server.
Download Jython from the following location:
http://downloads.sourceforge.net/project/jython/jython/2.5.1/jython_installer-2.5.1.jar
Run the installer as follows:
java -jar jython_installer-2.5.1.jar
Set the following environmental variables:
Set the JYTHON_HOME variable to the Jython install location:
export JYTHON_HOME=/jython-install-location
Add the JYTHON_HOME/bin directory to the path:
export PATH=$JYTHON_HOME/bin:$PATH
You should now be able to invoke Jython from command line as follows:
jython
Inform and configure the Enterprise Server with the location of Jython installation with the following command:
asadmin deploy --property jython.home=/jython-install-location
The GlassFish Update Center provides a Jython package. The package installs a Jython instance that enables creation of Jython applications for the Enterprise Server. If you installed Jython from Update Center, there is no need for further configuration of jython.home property.
Start the Update Tool with the following command:
as-install/bin/updatetool |
Choose the following option from Available Add-ons and click Install:
Jython Runtime IPS package for GlassFish v3 |
Update center automatically completes the installation of the container and configures it for use with Enterprise Server.
Set the following environmental variables:
Set the JYTHON_HOME variable to the Jython install location:
export JYTHON_HOME=/as-install/glassfish/jython
Add the JYTHON_HOME/bin directory to the path:
export PATH=$JYTHON_HOME/bin:$PATH
You should now be able to invoke Jython from command line as follows:
jython
Download Django from the following location:
http://media.djangoproject.com/releases/1.1.1/Django-1.1.1.tar.gz.
Extract the tar file:
gunzip Django-1.1.1.tar.gz
tar -xvf Django-1.1.1.tar
Change to the extracted directory:
cd Django-1.1.1
Install Django with the following command:
jython setup.py install
The GlassFish Update Center provides the Jython container package. With this task you can install Jython Container module and Grizzly adapter JAR files in the as-install/glassfish/modules directory, and enable deployment of Jython/Django applications on the Enterprise Server.
Make sure that the asadmin command is available from the PATH variable. Alternately you can use the as-install/bin/asadmin command.
Start the Update Center with the following command:
as-install/bin/updatetool |
Choose the following option from Available Add-ons and click Install:
GlassFish V3 Jython Container |
Update center automatically completes the installation of the container and configures it for use with Enterprise Server.
Start the Enterprise Server:
asadmin start-domain -v
Test the configuration with the following process:
The django-jython project created database back-ends and management commands for Django and Jython application development. With this task you can install the django-jython packages and enable database support for Django.
Download the django-jython packages from the following location:
http://django-jython.googlecode.com/files/django-jython-1.0.0.tar.gz
Extract the tar file:
gunzip django-jython-1.0.0.tar.gz
tar -xvf django-jython-1.0.0.tar
Change to the extracted directory:
cd django-jython-1.0.0
Install the package:
jython setup.py install