How to install the AdminTool

A how-to about the installation of Dandelion, an administrative tool for the Cinnamon CMS server

Create an environment variable DANDELION_HOME_DIR, which points to the directory where you wish to keep the configuration files for the AdminTool.
This variable must be available upon the start of the web application through the servlet container. On Windows, it should suffice to add this as a system wide variable. On Linux, you may have to add it to the script which starts the servlet container (for example Tomcat) or set it directly in your web application server.

Create a file dandelion-config.groovy in DANDELION_HOME_DIR with one entry for each repository in the dbconnections section:

// id : unique ID for this environment
// dbname : alias for this environment
// prefix: internal prefix for this environment
// jdbc:${env.jdbcType}://${env.host}:${port}/${env.dbname}

dbconnections {
	cmn_dev { 
		id = 1
		prefix = 'methusalem_cmn_dev'
		// driverClassName = 'net.sourceforge.jtds.jdbc.Driver'
 		// jdbcType = "jtds:sqlserver"
               cinnamonServerUrl = 'http://127.0.0.1:8080/cinnamon/cinnamon'
               jdbcType = 'postgresql'
               driverClassName = 'org.postgresql.Driver'

		host = '172.16.55.4'	
		port = 1433
		dbname = 'cmn_dev'
		username = 'cinnamon'
		password = 'cinnamon'		
                encryptPasswords = 'true
	}
}

indexers = [
            'server.index.indexer.DefaultIndexer',
            'server.index.indexer.BooleanXPathIndexer',
            'server.index.indexer.DateXPathIndexer',
            'server.index.indexer.IntegerXPathIndexer',
            'server.index.indexer.DefaultIndexer',
            'server.index.indexer.DecimalXPathIndexer',
            'server.index.indexer.TimeXPathIndexer',
            'server.index.indexer.ReverseStringIndexer',
            'server.index.indexer.ReverseCompleteStringIndexer',
            'server.index.indexer.ParentFolderPathIndexer',
            'server.index.indexer.DateTimeIndexer'
]

vaProviders = [
            'server.index.valueAssistance.DefaultProvider'
]

Note: the config file has to be a valid Groovy script. A missing } etc will cause Dandelion to stop.

Create a file dandelion.properties in the same place as dandelion-config.groovy. This properties file determines which of the links on the front page are shown and which are hidden. If you are sure that your administrators do not need to edit the server's objectTypes, you can hide this feature from them. (We do not consider this a security measure but rather a convenience feature. If you want a sophisticated system of permission handling for administrators, we are looking forward to your contributions).
```
# set link.foo to "show" to enable it in the gui.
link.backup=hide
link.relationType=show
link.format=show
link.objectType=show
```
Copy dandelion.war to the webapps directory of your servlet container / application server. Depending on whether your system can deploy a war file at runtime or not, a restart of the web server may be required.
You need a valid administrative account with the name "admin" for the cinnamon repository you wish to manage. By convention, this is the owner of system objects that Dandelion has to create behind the scenes.
You should be able to get to the AdminTool's web page via http://localhost:8080/dandelion (substitute localhost and the web server's port with your system's configuration).

Document Actions

Print this

Sections

Personal tools

How to install the AdminTool

Document Actions