source: enpraxis.educommons/trunk/enpraxis/educommons/docs/INSTALL.html @ 578

Revision 578, 5.1 KB checked in by tom, 4 years ago (diff)

updated installation and changes docs
Line 
1<?xml version="1.0" encoding="utf-8" ?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
7<title>Installing eduCommons 3.2.1-final</title>
8<link rel="stylesheet" href="./default.css" type="text/css" />
9</head>
10<body>
11<div class="document" id="installing-educommons-3-2-1-final">
12<h1 class="title">Installing eduCommons 3.2.1-final</h1>
13
14<p>Download the eduCommons 3.2.1-final release, available at:</p>
15<pre class="literal-block">
16http://sourceforge.net/projects/educommons/files/educommons/eduCommons-3.2.1-final/educommons.buildout-3.2.1-final.tar.gz/download
17</pre>
18<p>Unarchive the package to a directory which will serve as your buildout directory. Change directories and run the bootstrap script:</p>
19<pre class="literal-block">
20cd eduCommons
21/usr/local/python2.4 bootstrap.py
22(in some envoronments the command will be /usr/local/bin/python2.4 bootstrap.py)
23</pre>
24<p>Then run the buildout script to download all the required packages and set up the eduCommons application:</p>
25<pre class="literal-block">
26bin/buildout
27</pre>
28<p>Or run the same buildout script above, plus the Selenium test runner (needed to run acceptance tests):</p>
29<pre class="literal-block">
30bin/buildout -c tests.cfg
31</pre>
32<p>Once you have the buildout ready you can launch it using the following:</p>
33<pre class="literal-block">
34bin/instance start
35</pre>
36<p>Or to launch in the foreground of your console:</p>
37<pre class="literal-block">
38bin/instance fg
39</pre>
40<p>You should now be able to open a browser and go to the ZMI with the following URL
41(assuming that you configured Zope to run on port 8080)</p>
42<pre class="literal-block">
43http://&lt;server name&gt;:8080/manage
44</pre>
45<p>You should then get a dialog prompt asking for your Zope admin username and password. The default username/password for the buildout is admin/test1234.</p>
46<div class="section" id="install-educommons-product-in-your-zope-instance">
47<h1>Install eduCommons Product in Your Zope Instance</h1>
48<p>Once you have logged into the ZMI via the management interface, you are now ready
49to create the site. Start by creating a plone site with the pull down menu in the
50top right corner. Give the plone site an ID and title. The ID will be used in the
51URL to access the site, so name it appropriately. The title will appear several
52places within the eduCommons install, and should be based on your group or institution.&lt;/p&gt;
53Under &quot;Extension Profiles&quot; you need to do a multi-select (hold down the CTRL or the
54Command key). Select the following so they are all highlighted:</p>
55<blockquote>
56<ol class="arabic simple">
57<li>PloneBookmarklets</li>
58<li>ContentLicensing</li>
59<li>IMSTransport</li>
60<li>OpenSearch</li>
61<li>OAI Intercom</li>
62<li>SearchAndReplace</li>
63<li>Zip File Transport</li>
64<li>Left Skin</li>
65<li>Static Site</li>
66</ol>
67</blockquote>
68<div class="system-message">
69<p class="system-message-title">System Message: WARNING/2 (<tt class="docutils">../INSTALL.txt</tt>, line 80)</p>
70Block quote ends without a blank line; unexpected unindent.</div>
71<ol class="arabic simple" start="10">
72<li>eduCommons</li>
73<li>wordpressexchange</li>
74<li>iw.fss (FileSystemStorage)</li>
75<li>Working Copy Support (Iterate)</li>
76<li>CacheSetup</li>
77<li>LinguaPlone</li>
78</ol>
79<p>Then click &quot;Add Plone Site.&quot;</p>
80<p>If you wish to localize content in other languages you will need to select your supported languages.</p>
81<p>In the ZMI:</p>
82<ol class="arabic simple">
83<li>Navigate to your eduCommons instance</li>
84<li>Navigate to portal_languages</li>
85<li>Select one or more Allowed languages (use the control or apple key to multi-select)</li>
86<li>Click Save</li>
87</ol>
88<p>Additional instructions for localizing content using LinguaPlone are available in LOCALIZATION.txt.
89Finally, you need to reorder the Layers in your eduCommons Skins Selections.
90In the ZMI:</p>
91<ol class="arabic simple">
92<li>Navigate to your eduCommons instance</li>
93<li>Navigate to portal_skins</li>
94<li>Click on the Properties tab</li>
95<li>Under the Skins Selections, in the Layers textbox for LeftSkin, cut the LinguaPlone entry and paste it one a new line below the eduCommons entry</li>
96<li>Click Save (be sure to click the Save button for the Skins selection section)</li>
97</ol>
98</div>
99<div class="section" id="configure-educommons">
100<h1>Configure eduCommons</h1>
101<p>Additional configuration information is provided in SETUP.txt or <a class="reference external" href="http://educommons.com/documentation/how-to/educommons-setup-instructions">online</a>. This will help you to further customize eduCommons.</p>
102</div>
103</div>
104<div class="footer">
105<hr class="footer" />
106<a class="reference external" href="INSTALL.txt">View document source</a>.
107Generated on: 2009-08-10 19:56 UTC.
108Generated by <a class="reference external" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
109
110</div>
111</body>
112</html>
Note: See TracBrowser for help on using the repository browser.