Installing Jython and Django

Jython and Django installation on GlassFish Server comprises several substeps:

• To Install Jython as Standalone

• To Install Jython from Update Tool

• To Install Django

• To Install the Jython Container for Oracle GlassFish Server

• To Install Jython Support Libraries for Django

Jython can be installed in either of the following ways:

• As a standalone product

• From GlassFish Server Update Tool

The following sections explain these tasks in more detail.

To Install Jython as Standalone

You can download Jython and install it as a standalone product. If Jython is installed as standalone, you need to perform additional configuration steps so GlassFish Server can use the Jython installation.

1. Download Jython from the following location:

   http://downloads.sourceforge.net/project/jython/jython/2.5.1/jython_installer-2.5.1.jar

2. Run the installer as follows:

   java -jar jython_installer-2.5.1.jar

3. 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

4. Configure GlassFish Server to use the Jython installation with the following command:

   asadmin deploy --property jython.home=jython-install-location

To Install Jython from Update Tool

The GlassFish Server Update Tool provides a Jython package. This package installs a Jython instance that enables creation of Jython applications for GlassFish Server. If you installed Jython from Update Tool, there is no need for further configuration of the jython.home property.

1. Start Update Tool with the following command:

   as-install/bin/updatetool

2. 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 GlassFish Server.

3. 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

To Install Django

1. Download Django from the following location:

   http://media.djangoproject.com/releases/1.1.1/Django-1.1.1.tar.gz.

2. Extract the tar file:

   gunzip Django-1.1.1.tar.gz tar -xvf Django-1.1.1.tar

3. Change to the extracted directory:

   cd Django-1.1.1

4. Install Django with the following command:

   jython setup.py install

To Install the Jython Container for Oracle GlassFish Server

The GlassFish Server Update Tool provides a Jython container package. The following procedure explains how to install the Jython Container module and Grizzly adapter JAR files in the as-install/glassfish/modules directory, and enable deployment of Jython/Django applications on GlassFish Server.

1. Start Update Tool with the following command:

   as-install/bin/updatetool

2. Choose the following option from Available Add-ons and click Install:

   GlassFish V3 Jython Container

   Update Tool automatically completes the installation of the container and configures it for use with GlassFish Server.

3. Start the GlassFish Server:

   as-install/bin/asadmin start-domain -v

4. Test the configuration:

   1. Change to the Django samples directory:

      cd Django-1.1.1/samples

   2. Deploy the example applications on the server:

      as-install/bin/asadmin deploy .

   3. Access the deployed example applications from a web browser:

      http://localhost:8080/examples

To Install Jython Support Libraries for Django

The django-jython project created database backends 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.

1. Download the django-jython packages from the following location:

   http://django-jython.googlecode.com/files/django-jython-1.0.0.tar.gz

2. Extract the tar file:

   gunzip django-jython-1.0.0.tar.gz tar -xvf django-jython-1.0.0.tar

3. Change to the extracted directory:

   cd django-jython-1.0.0

4. Install the package:

   jython setup.py install