Installation » History » Version 24

Marcus Pearce, 2013-04-13 02:44 AM

1 7 Jeremy Gow
h1. Installing IDyOM
2 1 Marcus Pearce
3 1 Marcus Pearce
h2. Prerequisites
4 1 Marcus Pearce
5 2 Marcus Pearce
* "Steel Bank Common Lisp [SBCL]":http://www.sbcl.org/platform-table.html
6 7 Jeremy Gow
* "Quicklisp":http://www.quicklisp.org/beta/ is a library manager for Common Lisp.  Just download "<code>quicklisp.lisp</code>":http://beta.quicklisp.org/quicklisp.lisp
7 7 Jeremy Gow
* An SQL database.  I would recommend  "SQLite":http://www.sqlite.org/ 
8 1 Marcus Pearce
9 7 Jeremy Gow
Many people find "Emacs":http://www.gnu.org/software/emacs/ with "Slime":http://common-lisp.net/project/slime/ useful for Common Lisp development.  Package management systems can simplify the installation of these prerequisites, e.g. "Fink":http://www.finkproject.org/ or "Macports":http://www.macports.org/ for OS X.
10 2 Marcus Pearce
11 7 Jeremy Gow
See the "CLSQL Manual":http://clsql.b9.com/manual/ for information on other database systems you can use and how to access them from Common Lisp.  If you prefer not to use Quicklisp, you will need to install the following Lisp libraries: "UFFI":http://uffi.bi.com, "CLSQL":http://clsql.b9.com, "CL-PPCRE":http://www.weitz.de/cl-ppcre/, "PS-Graph":http://www.cliki.net/psgraph, "Midi":http://www.cliki.net/midi
12 1 Marcus Pearce
13 7 Jeremy Gow
h2. Install Quicklisp
14 1 Marcus Pearce
15 22 Jeremy Gow
First download  "<code>quicklisp.lisp</code>":http://beta.quicklisp.org/quicklisp.lisp to a directory <code>DIR_A</code>.  You can then install Quicklisp to another directory of your choice <code>DIR_B</code>:
16 1 Marcus Pearce
17 1 Marcus Pearce
<pre>
18 22 Jeremy Gow
(load "/DIR_A/quicklisp.lisp")
19 22 Jeremy Gow
(quicklisp-quickstart:install :path "/DIR_B/quicklisp/")
20 1 Marcus Pearce
(ql:add-to-init-file)
21 1 Marcus Pearce
</pre>
22 22 Jeremy Gow
23 22 Jeremy Gow
Use the full pathnames for both directories.
24 22 Jeremy Gow
25 1 Marcus Pearce
26 7 Jeremy Gow
h2. Download IDyOM
27 1 Marcus Pearce
28 9 Jeremy Gow
Download the following Lisp libraries, and unzip them into <code>DIR/quicklisp/local-projects/</code>
29 19 Jeremy Gow
* "idyom":https://code.soundsoftware.ac.uk/hg/idyom/archive/stable.zip
30 1 Marcus Pearce
* "AMuSE":https://code.soundsoftware.ac.uk/hg/amuse/archive/tip.zip
31 1 Marcus Pearce
* "amuse-viewpoints":https://code.soundsoftware.ac.uk/hg/amuse-viewpoints/archive/tip.zip
32 19 Jeremy Gow
* "MIPS":https://code.soundsoftware.ac.uk/hg/mips/archive/tip.zip
33 1 Marcus Pearce
* "mtp-admin":https://code.soundsoftware.ac.uk/hg/mtp-admin/archive/tip.zip
34 1 Marcus Pearce
* "ppm-star":https://code.soundsoftware.ac.uk/hg/ppm-star/archive/tip.zip
35 1 Marcus Pearce
36 9 Jeremy Gow
The <code>local-projects</code> directory should now contain six subdirectories, one for each library.
37 9 Jeremy Gow
38 12 Jeremy Gow
h2. Set <code>*idyom-root*</code>
39 1 Marcus Pearce
40 21 Jeremy Gow
IDyOM requires the global variable <code>*idyom-root*</code> be set to a suitable working directory, where it can cache results etc.  Additionally, you need to create three directories below <code>*idyom-root*</code> for IDyOM to use: <code>*idyom-root*/data/cache/</code>, <code>data/models/</code> and <code>data/resampling/</code>.
41 1 Marcus Pearce
42 21 Jeremy Gow
One way to ensure <code>*idyom-root*</code> always points to the correct directory is to include the following in your <code>.sbclrc</code> file, located in your home directory, and then restart SBCL:
43 21 Jeremy Gow
44 12 Jeremy Gow
<pre>
45 23 Marcus Pearce
(defvar *idyom-root* "PATH/TO/WORKING/DIR/")
46 1 Marcus Pearce
</pre>
47 10 Jeremy Gow
48 16 Jeremy Gow
49 1 Marcus Pearce
h2. Install IDyOM
50 7 Jeremy Gow
51 9 Jeremy Gow
You can now use Quicklisp to install IDyOM:
52 5 Marcus Pearce
<pre>
53 7 Jeremy Gow
(ql:quickload "idyom")
54 5 Marcus Pearce
</pre>
55 9 Jeremy Gow
This will also install the third-party Lisp libraries IDyOM depends on.  The first time it loads, you may get an error which brings up the debugger.  Press 2 [ACCEPT] and the installation should complete.
56 1 Marcus Pearce
57 7 Jeremy Gow
h2. Create a database
58 1 Marcus Pearce
59 7 Jeremy Gow
IDyOM is now installed, but you will need a database in order to use it.  To create an SQLite database in directory <code>DIR</code>:
60 5 Marcus Pearce
61 1 Marcus Pearce
<pre>
62 1 Marcus Pearce
(clsql:connect '("DIR/example.db") :if-exists :old :database-type :sqlite3)
63 8 Jeremy Gow
</pre>
64 8 Jeremy Gow
Alternatively, to connect to an existing local MySQL database:
65 8 Jeremy Gow
<pre>
66 8 Jeremy Gow
(clsql:connect '("localhost" "example-database" "username" "password") :if-exists :old :database-type :mysql)
67 8 Jeremy Gow
</pre>
68 8 Jeremy Gow
See the "CLSQL documentation":http://clsql.b9.com/manual/ for more on "connect":http://clsql.b9.com/manual/connect.html and "supported databases":http://clsql.b9.com/manual/prerequisites.html#idp8251808.
69 8 Jeremy Gow
70 8 Jeremy Gow
Finally, for a new database: 
71 8 Jeremy Gow
<pre>
72 7 Jeremy Gow
(mtp-admin:initialise-database)
73 7 Jeremy Gow
</pre>
74 1 Marcus Pearce
75 1 Marcus Pearce
You may now proceed to the [[tutorial]].
76 8 Jeremy Gow
77 8 Jeremy Gow
h3. Problems loading foreign libraries
78 8 Jeremy Gow
79 8 Jeremy Gow
Depending on how your system is configured, <code>clsql:connect</code> may give a "Couldn't load foreign libraries" error.  In this case, you
80 8 Jeremy Gow
need to "tell CLSQL where it can find these libraries":http://clsql.b9.com/manual/appendix.html#foreignlibs, e.g.
81 8 Jeremy Gow
<pre>
82 8 Jeremy Gow
(clsql:push-library-path "/usr/local/mysql/lib/")
83 8 Jeremy Gow
</pre>
84 9 Jeremy Gow
The exact path will depend on your system.  Note that, for some database installations these libraries may not have been installed, and you should consult the database documentation.
85 10 Jeremy Gow
86 1 Marcus Pearce
h2. Create a startup script [optional]
87 1 Marcus Pearce
88 11 Jeremy Gow
Every time you start IDyOM, you will need to connect to the database.  You may find it easier to combine all the startup commands in a single script, e.g.
89 11 Jeremy Gow
90 11 Jeremy Gow
<pre>
91 11 Jeremy Gow
(ql:quickload "idyom")
92 11 Jeremy Gow
(clsql:push-library-path "/usr/local/mysql/lib/")
93 15 Jeremy Gow
(defun connect-example ()
94 1 Marcus Pearce
  (clsql:connect '("DIR/example.db") :if-exists :old :database-type :sqlite3))
95 18 Jeremy Gow
(connect-example)
96 11 Jeremy Gow
</pre>