This guide describes the installation of the demo distribution of the MyCoRe sample application software DocPortal. The goal is to demonstrate how the software works. After the installation you get a complete running system to work off line on your own computer. The installation should be very easy for non-IT-specialists. For installing a production server system we recommend to read the DocPortal documentation and the MyCoRe documentation (included in the distribution or you visit http://www.mycore.de/). You can install this demo distribution under Linux (tested under SuSE 9.3) or Microsoft Windows (tested under Windows XP).
The software uses three system ports for the communication. Port 8291 for the web application, port 8298 for the
HSQLDB access and port 8299 for the file upload. To test the editor system you must use the login of a user
(see table). To administrate the system use the user
To install and run the demonstration you need only a current JDK (Java Developer Kit form Sun) installation version 1.5.0 or higher. This software you can download from the SUN Java web pages:
To install it follow the instruction and/or run the downloaded
*.exe file. Follow the installation
instructions dialogue. After the successful installation, set the system environment variable
with the system configuration tool.
Start - Settings -> Control Panel
System -> Advanced -> Environment Variables
New (system variable)
in German: Systemsteuerung --> System --> Erweitert --> Umgebungsvariable --> Neue System Variable
Add the entry:
C:\Programme\Java\jdk1.5.0_05\jre (or the path of the Java installation)
and press OK.
The default installation under Linux is planned for the user
mcradmin with the home directory
/home/mcradmin. Add this user to your system with the
/bin/bash UNIX shell. Install the
JDK package from your Linux distribution. You should install the XPDF- and OpenOffice-packages for text extracting
Set the environment (if not automatic) for the user
The installation is the same for all Operation systems. It depends that you have been installed the Java Kit
1.5.x or higher. Download the distribution
docportal-installable-yyyyMMdd.jar form our
or take the distribution media like CD.
yyyyMMdd is the date of the distribution.
Start the installation with double click to the
*.jar file or with
java -Xmx1024m -Xms1024m -jar
At first select the language for the installation dialogue. It is not the language default for the application!
Now you get a welcome window. Click next.
The ReadMe text show you some short information about this installation.
As next step you must agree the licence of the software. All own software of this project is under the GNU Public License.
With the next window you can select the installation path. This will be write to your installed data.
If you have select the packages and click next the installation will be start. It show you the following window.
The installation is finished now. Don't push the 'Generate an automatic installation script' button. See the next chapter for running the system.
After a successfully installation you can run the system. This steps you must do each time to run the software on
your own computer. In the
bin directory you can find command scripts for your operating system.
This can be
*.sh for UNIX,
*.cmd for Windows. Do the following steps:
bin/hsqldbstart.xxxand let it run
bin/jettystart.xxxand let it run
For Windows user Shortcuts are installed. You can start the HSQLDB-Server and Jetty over the shortcut menu.
For testing the installation DocPortal provide some sample data blocks. Available are the following packages form the MyCoRe download page:
|defaultsamples-installable-yyyyMMdd.jar||Some little data samples like images, text and so on|
|audiosamples-installable-yyyyMMdd.jar||Audio samples as content|
|videosamples-installable-yyyyMMdd.jar||Video samples as content (large)|
|theses-installable-yyyyMMdd.jar||Some theses about MyCoRe as content|
|kochbuch-yyyyMMdd.jar||Teddies Kochbuch von U. Reber as content|
You can contact the developers of the project under the email address email@example.com. Before you do this would you first consult the complete documentation to find solutions of your problem!
Have a lot of fun!