forked from AndrewSmart/opencyc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
103 lines (66 loc) · 3 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
=====================================================
Installation instructions for OpenCyc release 4.0
=====================================================
Welcome!
OpenCyc 4.0 is available for Linux and Windows.
Since OpenCyc 4.0 is implemented in Java 1.6.
OpenCyc requires 3G RAM under 64bit and about 1G of disk space.
Running OpenCyc under 32bit is no longer supported.
OpenCyc for Windows has been tested on
= Windows Server 2008
= Windows 7 Personal, Professional and Ultimate
OpenCyc for Linux has been tested on
= SuSE 10.3 and OpenSuSE 11
= Ubuntu 12.04 Precise
= Debian 6.04
This OpenCyc release has not been tested on Mac OS-X or on Solaris.
However, other versions of Cyc are currently deployed on these
architectures and as little work as adjusting the startup scripts may
be all that is needed.
OpenCyc 4.0 has been tested with the following Java implementations
(*) OpenJDK 1.6 IcedTea6 1.11.1
(*) OpenJDK 1.7 IcedTea7 2.1.1
(*) Oracle/Sun JDK 1.6 u32
(*) Oracle/Sun JDK 1.7 u4
(*) IBM Java 1.6 u10
(*) IBM Java 1.7 u3
To view the full OpenCyc documentation: http://www.opencyc.org
== Installation ==
1. You need to get the source code from GitHub, from a command such as
the following:
git clone [email protected]:AndrewSmart/opencyc.git
The author follows the git branching model mentioned here:
http://nvie.com/posts/a-successful-git-branching-model/
The repository doesn't contain any compiled .jar files; those are
retrieved/compiled later by Ant/Maven.
2. Invoke the script to run OpenCyc. This script requires Ant to be
installed on your system.
For Linux:
cd opencyc-4.0/scripts
./run-cyc.sh
For Windows:
Navigate to the directory opencyc-4.0\scripts
double-click the file run-cyc.bat
When the script is ran, it calls Ant in order to verify the official
binaries (compiled .jar files) are installed, if they are not it will
retrieve them from sourceforge.net.
When OpenCyc is started, it loads the KB into memory; depending on the
amount of RAM on your system and the speed of your disk, this can take
between one and two minutes.
Once OpenCyc is running, you will see
CYC(1):
which is the SubL command prompt. Don't close the window containing
this prompt because it will kill the image.
3. (optional)
You can enter SubL expressions such as (+ 1 2) or (genls #$Person)
or (all-genls #$Person) at the command line to verify Cyc's operation.
4. At this point the cyc http server is running and you can access
Cyc directly via the local web browser.
http://localhost:3602/cgi-bin/cg?cb-start
To access from a remote machine, change 'localhost' to the IP name of the
machine running Cyc, e.g.
http://hamlet.mydomain.com:3602/cgi-bin/cg?cb-start
You can browse Cyc via the Guest account or perform updates by
logging on as CycAdministrator (the default).
5. You can cleanly shut down the OpenCyc server by entering (halt-cyc-image)
at the SubL command prompt, CYC(N):