OpenIMS CE Installation instructions

OpenIMS CE Installation instructions
OpenIMS CE
Version 4.2
Installation instructions
OpenSesame ICT BV
Table of contents
1
INTRODUCTION ..................................................................................................................................... 3
2
INSTALLATION INSTRUCTIONS .......................................................................................................... 4
3
OPENIMS SITECOLLECTION CONFIGURATION ................................................................................ 6
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 2 van 9
1
Introduction
In this document we briefly explain how to install and configure OpenIMS in a Linux environment.
OpenIMS Community Edition (OpenIMS CE) is one of the first Information Management Servers (IMS)
developed by OpenSesame ICT (www.osict.com). It is licensed under the GPL GNU v.3.0 Open Source
license.
No part of this publication may be reproduced in any form by print, photo print, microfilm or any other
means without written permission by OpenSesame ICT.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 3 van 9
2
Installation instructions
These installation instructions are for OpenIMS CE (Community Edition) only. Additional and different
requirements apply to OpenIMS Enterprise Edition.
REQUIRED SOFTWARE
• Apache 1.3, 2.0 or 2.2
• PHP 4 or 5
• zip, unzip, gzip, gunzip, diff utilities
CONFIGURATION REQUIREMENTS
• OpenIMS must be installed in the DocumentRoot. OpenIMS will not work when installed in a
subdirectory under the DocumentRoot.
• OpenIMS must have full write access to the DocumentRoot. Ownership (by the user that Apache runs
as) is recommended.
• OpenIMS must be allowed to use the command line utilities listed above and to use the shell. SELinux
or other software that would interfere with this, should be disabled (at least for Apache).
• mod_php is recommended. When not using mod_php, the PHP settings listed in the included .htaccess
file should be transferred to php.ini.
• The Apache directive "AllowOverride All" is recommended. When not using this directive, the settings
listing in the included .htaccess should be transferred to the relevant <Directory> section in the Apache
configuration file.
QUICK INSTALL INSTRUCTIONS
1. Unzip OpenIMS in the DocumentRoot. If you are not unzipping, but copying or moving files, make
certain that .htaccess is included.
2. Use "chmod" to transfer ownership to the Apache user. Example: chmod -R apache:apache
/srv/www/openims
3. Access the server with a web browser (using the correct domain name if VirtualHosts are being used).
4. You should be redirected to http://<<<hostname>>>/openims/ce/autoconf/ and receive an error page
instruction you to add your IP-adres to <<<DocumentRoot>>>/openims/ce/autoconf/.htaccess. Do this.
5. Refresh the page in your web browser. You should now be able to create a basic site and set a
password.
6. After creating the site, remove your IP-adress from <<<DocumentRoot>>>/openims/ce/
autoconf/.htaccess.
7. Visit the url http://<<<hostname>>>/adm to log in to OpenIMS.
8. Use Admin > Maintenance to check and/or repair your Myconfig.php configuration.
MYCONFIG CONFIGURATION SETTINGS
Myconfig.php should appear in the DocumentRoot after step 5 of the Quick Install Instructions. You should
change the settings in myconfig.php to match your Linux configuration.
*** Default settings created during the installation:
$myconfig["windows"] = "no";
// Dont change this
$myconfig["linux"] = "yes";
// Dont change this
$myconfig["tmp"] = "/tmp/";
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 4 van 9
// This should bea directory where Apache has write access
$myconfig["hasgzlib"] = "yes";
// Tells OpenIMS whether certain PHP functions are available.
// If the selftest (Admin > Maintenaince > Check configuration) results in
// a (fatal) error, change this setting to "no".
$myconfig["hasgzcompress"] = "yes";
// Tells OpenIMS whether certain PHP functions are available.
// If the selftest (Admin > Maintenaince > Check configuration) results in
// a (fatal) error, change this setting to "no".
$myconfig["gzipcommand"] = "/bin/gzip";
// Should contain the path to the gzip executable.
$myconfig["gunzipcommand"] = "/bin/gunzip";
// Should contain the path to the gunzip executable.
$myconfig["tarcommand"] = "/bin/tar";
// Should contain the path to the tar executable.
$myconfig["localsendmail"] = "yes";
// Tell OpenIMS to use the standard PHP mail() function. Don't change this,
// as there are no alternatives available in OpenIMS CE.
$myconfig["diff"] = "/usr/bin/diff";
// Should contain the path to the diff executable.
$myconfig["unzip"] = "/usr/bin/unzip";
// Should contain the path to the unzip executable.
$myconfig["zip"] = "/usr/bin/zip";
// Should contain the path to the zip executable.
*** Optional settings that you might want to add
$myconfig["nosendmail"] = "yes";
// Disable alle mail functionality.
$myconfig["defaultlanguage"] = "en";
$myconfig["defaultlanguage"] = "nl";
// Configure the default language (English or Dutch).
TROUBLESHOOTING TIPS
• If images and short url's (a short url would be http://<<<hostname>>>/adm instead of the full url
http://<<<hostname>>>/openims/openims.php?mode=admin) are not working, this usually means that
.htaccess is not present / has a syntax error / is not being read by apache; check your AllowOverridesettings is httpd.conf.
• To view OpenIMS errors (including many errors related to the configuration of php), go to
http://<<<hostname>>>/showerrors, enable the "Show Errors" option, and then reload (Ctrl+F5) the
page you were trying to view.
• If (with /showerrors) you get the php error "headers already sent", check that you do not have any
whitespace before <? or after ?> in myconfig.php or in your site configuration.
• Go the the OpenIMS-directory and do "php -f myconfig.php" on the command line, to verify that there
are no syntax errors in myconfig.php.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 5 van 9
3
OpenIMS Sitecollection configuration
If the instructions in chapter 2 are completed a sitecollection has to be created.
Step 1. Open the url: <domainnaam – IP adress> /openims/ce/autoconf to start the configuration.
Step 2.
Step 3.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 6 van 9
Step 4.
Step 5. An Administrator account will be created. ID : Admin.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 7 van 9
Step 6. Enter a suitable password.
Step 7. The administrator account is successfully created.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 8 van 9
Step 8. De environment (sitecollection) is ready. Pleas login to OpenIMS CE.
Step 9. You are now logged in.
OpenIMS CE Installation instructions
Copyright © 2002-2011 OpenSesame ICT. All Rights Reserved
page 9 van 9
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising