How to package FormFaces:

  1. Checkout a release copy of FormFaces from CVS. Rename the Platforms/Web directory to FormFaces; this will be the root directory of the .zip file.
  2. Load and compress the source code (see below). Save the compressed source as formfaces.js in the root FormFaces directory.
  3. Pick the right license for the package, either GPL or commercial. Rename this file to license.html and delete the other file.
  4. Create a file called FormFaces Alpha (YYYY-MM-DD).zip, and add the FormFaces directory to the archive. (Do not add the other platforms like .NET or Java). When users unzip the archive all the files should end up in a directory called FormFaces, with formfaces.js in that directory.

Packaged source ():
 Compressed source: ():

How to release FormFaces:

Releasing on SourceForge

  1. Package up FormFaces according to instructions above, for a GPL version. Rename the file to FormFaces-Alpha-YYYY-MM-DD.zip
  2. Go to the File Release System page on SourceForge and click on Add Release at the bottom.
  3. Name the release Alpha (YYYY-MM-DD).
  4. Add the notes from the change log to the text box that says "Paste The Change Log In". You'll need to check the "Preserve my pre-formatted text" checkbox and manually wordwrap the bullets.
  5. Click Submit/Refresh to save these changes.
  6. Upload the FormFaces .zip file you created in step 1 above according to the instructions in step 2. This file must be named as specified above with no spaces or special characters.
  7. Refresh the page and find the .zip file in the list. Select it, then push the "Add Files and/or Refresh View" button.
  8. Go to step 3; you should see the file here now. Choose "Platform-Independent" for the processor and ".zip" for the file type.
  9. Fin.

Releasing on FormFaces.com

  1. Package up FormFaces according to instructions above, for an Evaluation version, however name it formaces_YYYY_rel_1_0_alpha_MM_DD_YY.zip.
  2. If not already done, checkout the FormFacesWebsite module from cvs.progeny.net.
  3. Edit main.html, update "News FormFaces alpha release 8.01.05 is now available." under news to be in accordance with the this release.
  4. Edit downloads.html, specifically the "New in this release" and "Planned for..." sections.
  5. Edit doDownloads.html, adding the latest release to the select box and making it the default selection.

  6. Edit SendDownloads.java, adding code in for the latest release, replacing names as appropriate:

    if (request.getParameter("version").equals("FormFacesAlpha8_01_05")) {
  session.setAttribute("version", "formfaces_2005_rel_1_0_alpha_8_01_05.zip");
}
  7. Add the evaluation release to the downloads directory.
  8. Run the Ant build file located in the web-inf directory, fixing any errors that crop up. It will create a formfaces.war file.
  9. Connect to Mojo via Remote Desktop Connection.
  10. Open the Services window (Start → Settings → Control Panel → Administrative Tools → Services).
  11. Stop the Apache Service.
  12. Remove the formfaces folder from the webapps directory in Tomcat (C:\Program Files\Apache Group\Tomcat 4.1\webapps).
  13. Replace the formfaces.war file with the one created from the Ant build.

  14. Comment out these sections in server.xml for Tomcat, located in C:\Program Files\Apache Group\Tomcat 4.1\config. Save.

    <Context path="/formfaces" docBase="formfaces" debug="0" reloadable="true" crossContext="true">
  <Realm  className="org.apache.catalina.realm.JDBCRealm" debug="99"
    driverName="org.gjt.mm.mysql.Driver"
    connectionURL="jdbc:mysql://mojo:3306/formfaces?user=formfaces"
    connectionName="formfaces" connectionPassword="progenites"
    userTable="users" userNameCol="username" userCredCol="password"
    userRoleTable="user_roles" roleNameCol="role" />
</Context>

    And:

    <Host name="www.formfaces.com" debug="0" appBase="webapps" unpackWARs="true">
  <Logger className="org.apache.catalina.logger.FileLogger" directory="logs" prefix="formfaces" suffix=".log" timestamp="true"/>
  <Context path="" docBase="formfaces" debug="0" reloadable="true"/>
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="formfaces_accesslog." suffix=".txt" pattern="common" resolveHosts="false"/>
</Host>
  15. Start the Apache service.
  16. Once Apache has started up and a new formfaces folder has been created in C:\Program Files\Apache Group\Tomcat 4.1\webapps, then Stop the Apache Service.
  17. Uncomment the lines above in server.xml. Save.
  18. Start the Apache service.
  19. Disconnect from Mojo.