Milestone Schedule

Date Phase
2013-03-15 v23 Released
2013-09-18
 v24 Released

Building the Survey Tool (cldr-apps) under ant

Note: those new to Survey Tool development are recommended to use the much simpler Eclipse setup. 
  1. Build the CLDR Tools using the command line (or using eclipse) to produce cldr.jar
  2. Download and install Tomcat somewhere. Verify that you can view pages from this server (such as at http://127.0.0.1:8080 ).
  3. Configure Manager access for a user
  4. Check out http://unicode.org/repos/cldr/trunk/common somewhere.  We will refer to this as "CLDR_COMMON", later.
  5. Check out http://unicode.org/repos/cldr/trunk/tools/cldr-apps 
    1. Copy build-sample.properties to build.properties
    2. Uncomment/edit all of the MANDATORY and potentially other lines in build.properties as follows:
      1. set CATALINA_HOME to the root directory of your Tomcat installation
      2. set password ( and potentially username if it is not 'admin' ) to match the "Manager access" user, above.
      3. set CLDR_TOOLS to the directory where the CLDR Tools are build (or at least to a directory containing cldr.jar)
      4. Set other lines according to the build.properties column of this table,
        and copy those jars to Tomcat's /lib directory.
  6. To test compilation, run:   ant web  
    (If there are any failures, check build.properties)
  7. "ant war"  will build cldr-apps.war.
  8. Run (the first time):  ant deploy
    If all goes well, it will install onto the server,  as http://yourserver:8080/cldr-apps

  9. Test out the above URL (substituting your server's name or 127.0.0.1 and the port number)- 
  10. If all goes well, you should see the page titled 'CLDR Web Applications'.
  11. Click on 'CLDR Survey Tool'
  12. You will get a message that states that CLDR_COMMON is not a directory. But at the top of the page, it says:
    • Welcome to SurveyTool@mobot. Please edit /home/srl/src/apache-tomcat-6.0.26/cldr/cldr.properties to change CLDR_HEADER (to change this message), or comment it out entirely. 
  13. This means that "/home/srl/src/apache-tomcat-6.0.26/cldr" is your 'cldr-apps' work area.
  14. Edit the cldr.properties text file. There are many "fun" things that can be set here (which should be described on another sub-page), but you should at least do the following:
    • change   CLDR_COMMON  to the path to your CLDR data checkout, above.  
    • comment out (with #)      CLDR_MESSAGE 
    • take note  of  CLDR_VAP  - this will be your "admin@" (that is, master) password.
  15. Restart the server (or the servlet) and visit the cldr-apps URL again.   
    • The SurveyTool should start up normally.
    • You can now login as the user     admin@   
       using the auto-generated password mentioned in CLDR_VAP in the cldr.properties file.
Comments