Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Drop the {VB.VERSION} .war file in the Tomcat webapps folder
  • All the VocBench configuration parameters are setup using the property file “config.properties”. It is located under WEB-INF/classes folder of the uncompressed vocBench.war file
  • VB allows updating your configuration file at the time of first load after installation.
  • Here follows a series of properties which need to be setup only once. In general, these properties should have been already prepared by the developer before packaging the VB war file. In any case, we list them here for completeness:

    • CFG. VERSION: This value matches the value under the "version" field of the "ontology_info" table in the administration DB.                      
      Scope: if we specify 2.0 in the property file, VB will show only those ontology in the vocbench which have 2.0 value.
      Default: This property should be 2.0 by default.
    • CFG. DISPLAYVERSION: Specifies which version you want to display in the VocBench UI.         
      Default: This property should be 2.0 by default.

    • CFG. MODE: specifies the deployment mode for the
  • VOCBENCH           
    • VOCBENCH          
      VALUES: can have these three values:
      • DEV: for Development
      • PRO: for production
      • SANDBOX: for sandbox

    • # DATABASE PROPERTIES
      • CFG.DB.CONNECTIONURL = jdbc:mysql://localhost:3306/<administrator_database_name>?requireSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8
      • CFG.DB.USERNAME = your MySQL username for the account devoted to VB
      • CFG.DB.PASSWORD = your MySQL password for the account devoted to VB

Replace administrator_database_name with appropriate VocBench administrator database name, user& password values with the database username and password respectively. Also, the dbConnectionUrl may require further changes if you adopted a specific setup (you know how to handle them in case).

    • # MAIL PROPERTIES
      • CFG.MAIL.HOST =smtp.gmail.com (smtp adress or IP number)
      • CFG.MAIL.PORT =465 (smtp port)
      • CFG.MAIL.USER =agrovoc@gmail.com (user for login )
      • CFG.MAIL.PASSWORD =xxxxx (user password)
      • CFG.MAIL.FROM =aims@fao.org (from email address)
      • CFG.MAIL.FROM_ALIAS =VocBench Admin
      • CFG.MAIL.ADMIN =agrovoc@gmail.com (admin email address for approval)
      • CFG.MODELCLASS: set value as below to use Semantic Turkey:          
        org.fao.aoscs.model.semanticturkey.STManager
      • CFG.MANDATORY.DEFINITION.NAMESPACES = Add namespaces which requires mandatory definition's source and link (For multiple namespaces use semicolon ";" as a separator)
      • CFG.CODETYPE: set CODETYPE to “http://aims.fao.org/aos/agrovoc/AgrovocCode” if you want to set Agrovoc Code. Set it to empty if you are not installing VocBench for managing Agrovoc
      • CFG.CUSTOMDATATYPE: Add custom data types can be added via this parameter. To add multiple data types use semicolon ";" as a separator. For Agrovoc, add http://aims.fao.org/aos/agrovoc/AgrovocCode

Configuring a specific instance

...