There are three documents that will help you get up and developing quickly. They include:
A. Installing Callimachus ¶
Callimachus includes a setup script that is used to intialize a new and upgrade an existing Callimachus instance. Follow the procedure below to install the latest Callimachus distribution.
Check if a Java Development Kit (JDK not just a JRE) is installed and that the version is correct. Callimachus uses JDK 1.6 (1.6.0_20 or higher, but not 1.7)
From the command prompt issue the command: java -version and javac -version
Install a Java JDK if it is not yet installed.
Download the .zip file for the latest version of Callimachus from http://callimachusproject.org and unzip it into an empty target directory.
Copy the file etc/callimachus-defaults.conf to a new file called etc/callimachus.conf.
Run the Callimachus setup script from a console to initialize Callimachus.
For Mac Users:
For Linux Users:
For Windows Users:
Run the Callimachus start script to start the server.
For Mac/Linux Users:
For Windows Users:
By default the Callimachus server is accessed typing http://localhost:8080 into your browser unless you have changed the authority in etc/callimachus.conf.
Setup your initial user account and password by copying and pasting the URL provided at the end of the setup script into the browser. The server has now started and Callimachus can be used.
Congratulations, you've installed Callimachus succesfully! If you think something is not working correctly or some part of the installation process has gone wrong, please post to the discussion group.
B. Browser support ¶
This describes the browsers that are supported by Callimachus.
Calliamachus works best with the most recent versions of
- Google Chrome
Callimachus provides partial support for the following
|Internet Explorer 8||
|Internet Explorer 9||
Callimachus does not support
- Internet Explorer 6
- Internet Explorer 7
C. Adding users ¶
To add a new user, an existing user who is part of the "admin" group must
- Navigate the their primary group edit page.
- Invite a new user using the icon in the Members field.
- Complete a user invitation form for the person to add.
- Save the primary group.
- Add the user to other User Groups as needed by clicking on the Members icon and using the lookup search box in the dialogue.
The new user will recieve an email invitation with a registration link and instructions on how to log in.
D. Starting and stopping the Callimachus server ¶
This describes how to start and stop the Callimachus server.
|1||From the command prompt navigate to the Callimachus directory.||../3RoundStones/callimachus-1.0|
|2||Start the server by running the callimachus-start.sh script from the /bin directory.||bin/callimachus-start.sh|
|3||Stop the server by running the callimachus-stop.sh script.||bin/callimachus-stop.sh|
Note: Always stop the Callimachus server before starting it again.
E. Starting the Callimachus client ¶
To start the Callimachus client in your browser enter: http://localhost:8080/
Note: This assumes you are running the Callimachus server on the same machine you are accessing it in your browser. Replace localhost with the host name and if applicable, the port number of the server you are using.
F. Sample Callimachus applications ¶
Callimachus applications are packaged as CAR files, and can be installed by importing the contents of the sample application into a newly created folder.
Once a user account is created on a new installation
click on the home folder menu entry
in the resource menu, click on the new folder icon, and then
provide a folder name.
Once an empty folder is created open its edit tab and choose the import link in the sidebar. Provide the CAR file in the form and submit.
|This application ...||Demonstrates ...|
|HelloWorld||view template association with a class member resource|
|School Ward||controlled form selection using concepts in checkboxes and drop downs|
|Meeting Notes||container resources|
|Directory||create and edit forms with embedded resources|
G. Callimachus Support ¶
3 Round Stones offers commercial support and private virtual cloud hosting for enterprises running Callimachus.
Commuity support may be access through our mailing list.