Difference between revisions of "Trying Out Maya"

Revision as of 18:52, 10 May 2007

Overview

The following instructions highlight how to try out Maya. At this time, Maya does not have a formal "release" available however we understand that certain developers may wish to setup Maya to begin experimenting how it could work in their environment. The follow steps are designed to use a local Derby database and include example plugins that have a local update site run to expose the Maya features and plugins as needed. In addition, a set of JUnit tests are used to populate the database including configuring default profiles and scanning standard update sites. Once you experiment with this configuration, you can deviate from these steps including registering additional update sites and potentially switching to use other database technologies.

The Environment

You will use the following components in trying out Maya.

• Eclipse
  • To build and run the database, update site, and Maya server
• Maya Server
  • To expose the web services needed for Maya to operate
  • To host the local update site for testing (in this example)
• Derby DB
  • To store the meta information for Maya to perform provisioning
• Maya Javastrap
  • A Java implementation of Maya's bootstrap to initiate provisioning
• Maya Launcher
  • Run by the bootstrap and allows selection of profile to be executed

Trying Out Maya

1. Install the Derby Core and UI plug-ins to your runtime plug-ins directory
   • Download derby_core_plugin and derby_ui_plugin (not the derby binary bundles)
   • Place the files in your eclipse/plugins directory
2. Install the Sun JRE 1.6 (if not already installed)
   • Note: Needed for testing of Maya when automatic VM distribution is enabled (currently default)
3. Start Eclipse, download from Eclipse.org if needed
   • Note: We've tested with 3.3M6 and M7, you must use a version that includes the new Jetty service
4. Import Maya's Getting Started team project set (maya-with-derby.psf)
   • Use Import > Team > Team Project Set and browse to the PSF file
   • You will get build errors until you complete later steps
5. Add Hibernate Jars to org.eclipse.maya.server.example.hibernate project
   • Place Hibernate files in the org.eclipse.maya.server.example.hibernate/lib folder.
   • Copy Jars from the downloaded hibernate zip's top-level directory:
     • hibernate3.jar
   • Copy Jars from the downloaded hibernate zip's lib directory:
     • antlr-2.7.6.jar
     • asm.jar
     • asm-attrs.jar
     • c3p0-0.9.1.jar
     • cglib-2.1.3.jar
     • commons-collections-2.1.1.jar
     • dom4j-1.6.1.jar
     • jta.jar
   • Once Jars in place, all build errors should go away
6. Start the Derby network server
   • Right click in the org.eclipse.maya.server.example.db project and choose Apache Derby > Start Derby Network Server
7. Create zip file of the Sun 1.6.0 JRE and place in JRE folder
   • On Windows navigate to the directory where there is folders like bin & lib and some other files and create a zip file just containing those files
   • Place that in the JRE folder for your os in the org.eclipse.maya.server.example.db plug-ins (Note: the file must be named jre_1.6.0.zip)
8. Build Update Site for the Maya software
   • Open the site.xml located in the update_site folder of the org.eclipse.maya.server.example.db project click Build All
9. Start the Maya Web Server
   • Run the server using the launch config Maya Server (Win)
10. Prepare the Maya Database including initial population
    • Run using the Initialize Maya Database launch config
    • Part of preparation includes running update site sync which can take 10-60 minutes depending on network connection
11. Run the Maya Launcher via Bootstrap
    • Launch the Java Bootstrap launch config from the Run... menu
    • When prompted for a user name and password, specify user / pass or admin / admin

What to Try Next

• Distributed Testing
  • Even though you are testing with Maya running on a local Derby DB, this setup will allow you to test from a remote system. Since the meta information cached in the Derby DB includes the base URL to update sites, the Maya plugins and features will be referenced based on the hostname of the test server. In environments where WINS is configured, you should be able to modify the Java Bootstrap to have the hostname of the server specified under VM arguments as -Dmaya.host=hostname. If you do not have WINS configured, you will need to specify -Dmaya.host=a.b.c.d where a.b.c.d is the server's IP address. Please note that while you can set the Maya hostname for testing, typically the native bootstrap you would deploy would be installed and configured ready for a given server. Note: If the server's IP address or name changes, you may need to re-run Initialize Maya Database which will dump the tables and re-create from scratch.

Database Maintenance

Once you've created the Maya database, you may want to periodically run the Rescan Update Sites launch configuration. This will have Maya go out and verify that all of the features exposed on the registered update sites are stored within Maya's meta cache. In addition, for this Derby-based usage of Maya, the database itself will have information including the machine's hostname to be used as the web site for the Maya plugins exposed by the update site. In a full installation these files would be hosted on a stable server, though in this setup, since the hostname of the machine could change, you may need to re-initialize the database if certain configuration changes occur.