Bloomer User Notes Installing and Running a Bloomer Installation Jack Park Latest: Project Home:

A Federation of Bloomer Portals Global Federation Server* Wiki Drupal RTDelphi LFS Wiki Drupal RTDelphi LFS Colligence Cohere Wiki LFS Cohere LFS = Local Federation Server *Public Domain Digital Library—Topic Map

Terminology XML Config File – Located in /webapps/ROOT/WEB-INF/ – core-portal-props.xml Server Config File – Located as /etc/jetty.xml

Outline Installation – Federation Server – Wiki Administration – Federation Server – Wiki User Actions – Changing Password – Importing data Installing Cohere Building TopicSpaces

Federation Server Installation User Database – Must install and configure this – Required for MediaWiki as well Server – Local Federation Server Requires User Database Creates own RDF knowledgebase

Federation User Database Installation MySQL – Version 5+ – Configurations in the XML Config File Change values to suit Boot MySQL – create database ; – create user ; – grant all on.* to ‘ ’; " /> " />

Federation Server Installation Step One: Download the tarball and open it or acquired directly from Subversion. It forms its own directory structure. – Build TopicSpaces (see last slide) Step Two: Edit the XML Config File to suit Step Three: Make any necessary edits to Server Config File – May need port changed: defaults to 8080 Step Four: Create the database Step Five: Deal with SSL keystore and certificate* (next slide) Step Six: Boot the server with run.bat or run.sh Login (typically /) with the default admin name and password (from XML Config File) Create users * All communication that required authentication should go to :8443/

SSL Keystore and Certificate Two approaches: – Simple/Testing For testing tool in /etc with instructions – Complex/Production Choose a certificate supplier and follow their instructions – Modify /etc/jetty-ssl.xml according to the keystore and certificate created – NOTE: Simple certificate is not recommended for production servers.

Admin—Global Federation Each Local Federation Server has a XML Config File setting for the URL of the Global Federation Server Resource includes login information* " /> ”/> *Config files are not visible, but this is a developmental approach to persisting credentials for communicating over the backchannel. Global Server must have a registered User that can authenticate with userid and password

Wiki Installation A heuristic for installation – Install Apache server first – Install PHP which will then prompt to add to Apache – Install MediaWiki in /htdocs/ directory MediaWiki – Follow MediaWiki installation instructions Extensions – Follow instructions that are supplied with each extension Database – Follow MediaWiki instructions which are similar to those given for the Federation Server

Extensions IBISMediaWiki – In Bloomer’s online Subversion (to be made a downloadable tarball) Semantic MediaWiki Extension – Halo Extension – FCKeditor (rich text editor) – WikiTrust (watch for bugs) – Other extensions in Bloomer’s Subversion This list subject to revision and additional detail over time

Federation Server Administration Actions presently implemented – User Management Create users Change user roles Remove users

Administration Home Page Available only to users authenticated with an Admin role

User Manager Clicking on New User opens a form for creating a user Clicking on any user in the list takes you to a form to change roles

Creating a New User A User Name is necessary for search-by- name actions Give a user a temporary password: users can change it later Select a user role from the pull-down

User’s Home Page User clicks on name next to the Logout link to be taken to this view. Future versions will add more features to a user’s home page

Other User Federation Server Actions User can import IBIS XML files in the Compendium XML format* User can import from three web services sources: – – – *In early trials, we will leave this feature turned off, made available only to users with Admin credentials.

Webservices Importing Enter appropriate login identifier and password, one source at a time.

Installing Cohere—1 Generalized Approach: – Install in /htdocs/ alongside Mediawiki e.g. /htdocs/cohere Only content from Cohere distribution /cohere-website – Edit config-sample.php  config.php $CFG->databaseuser $CFG->databasepass $CFG->databasename (e.g. ‘cohere’) – Install the database (next slide) – Update some files to reflect the URL of the installation Refer to the file /cohere-website/urlConstants.php for instructions – Restart Apache – NOTE: at the present time, the Firefox Plugin is not available for use Cohere is functional without it for the time being. The plugin is being modified to be configurable for different installations

Installing Cohere—2 Create a MySQL database as before – Create a user based on settings in config.php – Create a database based on settings in config.php – Grant user rights: grant all on.* to identified by ‘password’; – Preload the database* use source db.sql source update.sql source default-data.sql *For convenience, copy the three sql files to /bin ; otherwise modify the “source” command lines to point to the files

Building TopicSpaces Requirements – Java 1.6 JDK – MySQL (per earlier database slides) – Apache Ant* Building – cd to TopicSpaces base directory where build.xml exists – Type ant Building is automatic A TopicSpaces.jar file is created in the web-inf/lib directory *