| 1 |
iscape version 1.0 |
|---|
| 2 |
------------------ |
|---|
| 3 |
|
|---|
| 4 |
For information about what iscape is and how it works, see |
|---|
| 5 |
http://iscape.simon-cozens.org/ - I'm assuming that since you've got to |
|---|
| 6 |
the point of reading this, you've already got some idea of why you want |
|---|
| 7 |
to be looking at iscape. |
|---|
| 8 |
|
|---|
| 9 |
INSTALLING |
|---|
| 10 |
---------- |
|---|
| 11 |
|
|---|
| 12 |
First you will need an Ubuntu Dapper Drake server install. You shouldn't |
|---|
| 13 |
need any additional packages, as iscape will install all the required |
|---|
| 14 |
packages for you. |
|---|
| 15 |
|
|---|
| 16 |
Then you'll need a copy of the iscape setup scripts. Either download a |
|---|
| 17 |
tarball from http://iscape.simon-cozens.org/ or check out from SVN: |
|---|
| 18 |
|
|---|
| 19 |
svn co http://svn.simon-cozens.org/iscape/trunk/iscape/ |
|---|
| 20 |
|
|---|
| 21 |
Finally, run install-iscape as root, and answer the questions. All being |
|---|
| 22 |
well, after about half an hour and answering a number of prompts, |
|---|
| 23 |
you will see the text "Setup complete!" on the console. |
|---|
| 24 |
|
|---|
| 25 |
If there were any errors, you may be able to fix them by running the |
|---|
| 26 |
script again - the script is designed to be "re-entrant" and allow you |
|---|
| 27 |
to do this. |
|---|
| 28 |
|
|---|
| 29 |
INITIAL USE |
|---|
| 30 |
----------- |
|---|
| 31 |
|
|---|
| 32 |
Before you can use your iscape account you must install the |
|---|
| 33 |
Administrator's client certificate in your browser. We recommend using |
|---|
| 34 |
Firefox (in fact we mandate it internally!) and you might want to |
|---|
| 35 |
consider creating a new profile for the Administrator certificate. See |
|---|
| 36 |
http://www.mozilla.org/support/firefox/profile#new for how to do this. |
|---|
| 37 |
|
|---|
| 38 |
The certificate can be found in ~Administrator/Administrator.p12 - |
|---|
| 39 |
connect either using Samba or SSH to get this file onto your local |
|---|
| 40 |
machine, and install it into your browser. The certificate is protected |
|---|
| 41 |
by a password found in ~Administrator/Administrator.pass.txt. |
|---|
| 42 |
|
|---|
| 43 |
From there, you can connect to your server via HTTPS and access its |
|---|
| 44 |
documentation there. You will need to log in via basic auth as |
|---|
| 45 |
"Administrator" with the password you supplied to the script. (Not the |
|---|
| 46 |
certificate password.) |
|---|
| 47 |
|
|---|
| 48 |
POST INSTALL SETUP |
|---|
| 49 |
------------------ |
|---|
| 50 |
|
|---|
| 51 |
Unfortunately one or two components still require manual setup. To |
|---|
| 52 |
complete the setup of the address book software (CiviCRM) you need to |
|---|
| 53 |
first log into Drupal (https://iscape.example.com/drupal/). Then select |
|---|
| 54 |
Administer, Modules, and turn on the "civicrm" and "ldapauth" modules. |
|---|
| 55 |
|
|---|
| 56 |
Next, enter CiviCRM, "Administer CiviCRM", and select "Global Settings" |
|---|
| 57 |
from the "Setup" pane. Select "Resource URLs". You might find that you |
|---|
| 58 |
can get there directly via this URL, substituting iscape.example.com for |
|---|
| 59 |
your site name: |
|---|
| 60 |
https://iscape.example.com/drupal/index.php?q=civicrm/admin/setting/url&reset=1 |
|---|
| 61 |
|
|---|
| 62 |
Change the "CiviCRM Resource URL" to |
|---|
| 63 |
https://iscape.example.com/drupal/modules/local/civicrm/ |
|---|
| 64 |
again making the obvious substitution. |
|---|
| 65 |
|
|---|
| 66 |
We will endeavour to streamline this process further in the future. |
|---|
| 67 |
|
|---|
| 68 |
LICENCE |
|---|
| 69 |
------- |
|---|
| 70 |
|
|---|
| 71 |
iscape is provided under the terms of version 2 of the GPL, or the Perl |
|---|
| 72 |
Artistic License at your choice. |
|---|
