Skip to content
Newer
Older
100644 191 lines (161 sloc) 7.14 KB
ab3d9bb base service and process, service startup
mmeisinger authored
1 ==================================================
b2b045b README updated with dependencies
Michael Meisinger authored
2 LCAarch - OOI Release 1 LCA architecture prototype
ab3d9bb base service and process, service startup
mmeisinger authored
3 ==================================================
db03ff6 Bootstrap class and core service structure
mmeisinger authored
4
b2b045b README updated with dependencies
Michael Meisinger authored
5 April 2010 - May 2010
ab3d9bb base service and process, service startup
mmeisinger authored
6
b2b045b README updated with dependencies
Michael Meisinger authored
7 This project provides a service framwork and auxilliary functions for running
8 architecturally complete, but functionally limited versions of all the
9 services of the OOI release 1 system with their full architectural dependencies.
ad37c05 PEP8 compliance
Michael Meisinger authored
10 In "shore" a data distribution network based on pub-sub messaging with underlying
11 infrastructure services (security, persistence) and provisioning.
b2b045b README updated with dependencies
Michael Meisinger authored
12
13 The "core" part of LCAarch provides base classes and a framework for spawnable,
14 message communicating processes, for services with defined names, for
15 bootstrapping the system, for managing logging and configuration etc.
16
ad37c05 PEP8 compliance
Michael Meisinger authored
17 For more information, please see:
b2b045b README updated with dependencies
Michael Meisinger authored
18 http://www.oceanobservatories.org/spaces/display/CIDev/LCAARCH+Development+Project
ab3d9bb base service and process, service startup
mmeisinger authored
19
b2b045b README updated with dependencies
Michael Meisinger authored
20 LCAarch is compatible with Python 2.5 and higher, but not Python 3.x
ad37c05 PEP8 compliance
Michael Meisinger authored
21 This project has as dependencies Magnet, Carrot, txAMQP, Twisted and pycassa,
22 (see below)
db03ff6 Bootstrap class and core service structure
mmeisinger authored
23
b2b045b README updated with dependencies
Michael Meisinger authored
24 Get LCAarch with
ab3d9bb base service and process, service startup
mmeisinger authored
25 ::
26 git clone git@amoeba.ucsd.edu:lcaarch.git
4715758 removed test from boostrap, changed datastore for new msg format
mmeisinger authored
27
ab3d9bb base service and process, service startup
mmeisinger authored
28 Usage
29 =====
4715758 removed test from boostrap, changed datastore for new msg format
mmeisinger authored
30
d9eb8b7 package init, ts test
Michael Meisinger authored
31 (all subsequent steps assume start from lcaarch/ dir)
32
b2b045b README updated with dependencies
Michael Meisinger authored
33 Start empty CC ("Magnet" Python Capability Container) shell with:
ab3d9bb base service and process, service startup
mmeisinger authored
34 ::
d9eb8b7 package init, ts test
Michael Meisinger authored
35 twistd -n magnet -h amoeba.ucsd.edu
3a84fde Bootstrap improvements, procutils, datastore test
mmeisinger authored
36
e710e44 CC agent with announcement on identification request; can spawn a pro…
Michael Meisinger authored
37 (to end a magnet container shell, press Ctrl-D Ctrl-C)
38
3a84fde Bootstrap improvements, procutils, datastore test
mmeisinger authored
39 Start system by executing within the CC shell:
ab3d9bb base service and process, service startup
mmeisinger authored
40 ><>
41 from ion.core import bootstrap
42 bootstrap.start()
43
d9eb8b7 package init, ts test
Michael Meisinger authored
44 Alternatively from shell executing a script:
45 ::
46 twistd -n magnet -h amoeba.ucsd.edu res/scripts/bootstrap.py
e710e44 CC agent with announcement on identification request; can spawn a pro…
Michael Meisinger authored
47 twistd -n magnet -h amoeba.ucsd.edu res/scripts/newcc.py
d9eb8b7 package init, ts test
Michael Meisinger authored
48
b78736b changed readme; make sure to update and install latest magnet
Michael Meisinger authored
49 Run trial test cases (recursively)
d9eb8b7 package init, ts test
Michael Meisinger authored
50 ::
e710e44 CC agent with announcement on identification request; can spawn a pro…
Michael Meisinger authored
51 trial ion
b78736b changed readme; make sure to update and install latest magnet
Michael Meisinger authored
52 trial ion.core
53 trial ion.services.coi.test.test_resource_registry
d9eb8b7 package init, ts test
Michael Meisinger authored
54
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
55 A good learning example is the HelloService
56 ::
57 trial ion.play.test.test_hello
58
59 Or in the CC shell:
60 ><>
61 from ion.play import hello_service
62 spawn(hello_service)
63 send(1, {'op':'hello','content':'Hello you there!'})
64
65 from ion.play.hello_service import HelloServiceClient
342829f Local configuration override in ionlocal.config. Unit tests get broke…
Michael Meisinger authored
66 hc = HelloServiceClient()
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
67 hc.hello()
68
ab3d9bb base service and process, service startup
mmeisinger authored
69
70 Install the dependencies: Magnet (see Magnet's Readme)
71 ======================================================
72 Recommendation:
73 Create a virtualenv for installing Magnet and its dependencies.
74
b2b045b README updated with dependencies
Michael Meisinger authored
75 Twisted Framework
76 -----------------
ab3d9bb base service and process, service startup
mmeisinger authored
77 ::
78 easy_install twisted
79
80 txAMQP
81 ------
82 ::
83 easy_install txamqp
84
ad37c05 PEP8 compliance
Michael Meisinger authored
85 Pycassa
86 -------
87 ::
88 easy_install -U --find-links http://ooici.net/packages pycassa
89
b2b045b README updated with dependencies
Michael Meisinger authored
90 SimpleJSON (only when running Python2.5)
91 ----------------------------------------
92 ::
93 easy_install simplejson
94
ab3d9bb base service and process, service startup
mmeisinger authored
95 carrot (use txamqp branch)
ad37c05 PEP8 compliance
Michael Meisinger authored
96 --------------------------
ab3d9bb base service and process, service startup
mmeisinger authored
97 ::
98 git clone git://amoeba.ucsd.edu/carrot.git
99 (cd carrot; git checkout -b txamqp origin/txamqp)
100 (cd carrot; python setup.py install)
101
ad37c05 PEP8 compliance
Michael Meisinger authored
102 Install the Magnet package [NEED Magent 0.3.4 on master branch]
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
103 ------------------------------------------------------------------
ab3d9bb base service and process, service startup
mmeisinger authored
104 Get the latest version of the repository, if you haven't already.
105 ::
106 git clone git://amoeba.ucsd.edu/magnet.git # no ooi credential
107 # OR
108 git clone git@amoeba.ucsd.edu:magnet.git # need ooi credential
109 (cd magnet; python setup.py install)
b78736b changed readme; make sure to update and install latest magnet
Michael Meisinger authored
110
111
112 Note:
113 =====
114 This project dependes closely on magnet. Whenever you do a "git pull" on
115 this project, there is a chance that you need to update and install magnet
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
116 again (see above). Please review the branch logs for any hints.
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
117
118
119 ---------------------------------------------------------------------------
120 Change log:
121 ===========
122
dfe8bf2 fixed problems with logging change; added log level configuration bas…
Michael Meisinger authored
123 2010-06-07:
124 - Redefined logging import to set as module level logger. Each module has now
125 a different logger that can be configured separately. Don't configure
126 manually though.
127 - Added possibility to modify logging levels by module/package, with support
128 for package hierarchy. See res/logging/loglevels.cfg for standard entries.
129 Do not modify. Add file res/logging/loglevelslocal.cfg for local override.
f92eeba Added process shutdown support to BaseProcess; refactored BaseProcess…
Michael Meisinger authored
130 2010-06-02:
131 - BaseProcess self members renamed to conform to PEP8
132 - Added process shutdown to BaseProcess
982030b Refactoring in BaseProcess to support an onspawn hook
Michael Meisinger authored
133 - Added container UNIX shell argument -a processes=<path to filename> used
134 by newcc.py script, with a list of processes to startup in standard format
3f881c9 Changed IStore delete to remove; parameterizable cassandra backend
Michael Meisinger authored
135 2010-05-25:
136 - Made Cassandra backend parameterizable with keyspace/colfamily and added
137 SuperColumn support.
f2ff6a5 Refactored IStore interface and modified backends, object store, coi …
Michael Meisinger authored
138 - Modified the IStore interface to support a create_store factory method. This
139 method can yield and return a deferred. Modified and fixed IStore impls.
3f881c9 Changed IStore delete to remove; parameterizable cassandra backend
Michael Meisinger authored
140 Changed delete to remove to be more compliant with standard collections.
241d1d0 BaseProcess.reply_ok and reply_err added and service operations chang…
Michael Meisinger authored
141 2010-05-22:
142 - Added timeout to BaseProcess.rpc_send. Use with kwarg timeout=<secs>
143 - CC-Agent detects missing known containers and removes them from the list
144 - Enhanced CC-Agent operations and CC shell helpers
145 - Added sequence numbers for messages
146 - Added glue functions BaseProcess.reply_ok and reply_err and changes some
147 RPC style service operations.
342829f Local configuration override in ionlocal.config. Unit tests get broke…
Michael Meisinger authored
148 2010-05-20:
149 - The system now looks for a local config file ionlocal.config and if exists,
150 overrides entries in ion.config.
151 - Test cases use the config file to determine the broker host to use. If local
70573b4 added BaseProcessClient and changed all BaseServiceClient subclasses …
Michael Meisinger authored
152 config override exists, a different broker (e.g. localhost) can be given.
153 - Added BaseProcessClient and changed BaseServiceClient and all clients and
154 all test cases (again).
3827a32 shell helper functions
Michael Meisinger authored
155 - Added container shell helpers under 'cc', such as cc.spawn('hello')
e710e44 CC agent with announcement on identification request; can spawn a pro…
Michael Meisinger authored
156 2010-05-16:
157 - Removed support for BaseProcess.send_message and reply_message. Always use
158 send, reply and rpc_send now.
159 - Any BaseProcess instance can now spawn_child() other processes.
160 - Removed RpcClient class, because every process can do rpc_send()
161 - Service processes now also listen to their service name's queue. The service
162 name is determined from the service declaration. Two processes will listen
163 to the same queue and take messages round robin from the queue.
164 - Startup arguments evaluated, for instance to start with system name set:
165 twistd -n magnet -a sysname=mysys
166 twistd -n magnet -a "{'sysname':'mysys'}"
167 - Added capability container agent process. Start with:
168 twistd -n magnet res/scripts/newcc.py
169 Agents announce themselves to others in the same system and can spawn procs.
170 - Name scope 'local' for messaging names means now really local to one container.
171 Use scope 'system' for names unique for each bootstrapped system. Do not use
172 global names, because they will clash.
173 - Less verbose trace output for process init messages and changes to other
174 trace output as well.
bc50a38 Changed BaseServiceClient __init__ args and all client impls; takes n…
Michael Meisinger authored
175 - Changed BaseServiceClient and tests. Initializer arguments different.
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
176 - Using master branch of magnet now
7a9f54a python 2.5 compatibility: changed .format to % and json import
Michael Meisinger authored
177 2010-05-10:
178 - Based on entries in config files, service process modules are sought and
179 loaded in order to collect the service process declarations. This enables
180 a registration of services with versions and dependencies on startup
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
181 2010-05-06:
182 - Refactored the BaseProcess class.
183 - You can now do RPC directly from the process, via self.rpc_send without
5ea10a7 made IonTestCase and all tests PEP8 compliant
Michael Meisinger authored
184 the need for an RpcClient. Works even with other messages coming in at the
185 same time (using the conv-id)
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
186 - Added aliases: self.send, self.reply (use these now)
187 - Process instance can be spawned via self.spawn()
188 - Provided an easier to use BaseServiceClient, which uses a default service
189 name lookup. Accepts BaseProcess instance as argument to use for sending/
190 receiving service calls.
Something went wrong with that request. Please try again.