Skip to content
Newer
Older
100644 205 lines (175 sloc) 8.21 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
84c4757 Added simple mock Java integration service for LCA and ant target to …
Michael Meisinger authored
5 April 2010 - August 2010
ab3d9bb base service and process, service startup
mmeisinger authored
6
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
7 This project provides a service framwork with auxilliary functions for running
8 architecturally complete versions of all the services of the OOI release 1
9 system with their full architectural dependencies.
10 In "short" a data distribution network based on pub-sub messaging with underlying
ad37c05 PEP8 compliance
Michael Meisinger authored
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
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
15 bootstrapping the system, for managing logging and configuration etc. This
16 is an early implementation of the OOI Python Capability Container.
b2b045b README updated with dependencies
Michael Meisinger authored
17
ad37c05 PEP8 compliance
Michael Meisinger authored
18 For more information, please see:
b2b045b README updated with dependencies
Michael Meisinger authored
19 http://www.oceanobservatories.org/spaces/display/CIDev/LCAARCH+Development+Project
ab3d9bb base service and process, service startup
mmeisinger authored
20
b2b045b README updated with dependencies
Michael Meisinger authored
21 LCAarch is compatible with Python 2.5 and higher, but not Python 3.x
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
22 This project has several dependencies on libraries and packages, 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
84c4757 Added simple mock Java integration service for LCA and ant target to …
Michael Meisinger authored
44 Alternatively (better) from UNIX shell executing a script:
d9eb8b7 package init, ts test
Michael Meisinger authored
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
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
76 :: easy_install twisted
ab3d9bb base service and process, service startup
mmeisinger authored
77
78 txAMQP
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
79 :: easy_install txamqp
b2b045b README updated with dependencies
Michael Meisinger authored
80
ab3d9bb base service and process, service startup
mmeisinger authored
81 carrot (use txamqp branch)
ad37c05 PEP8 compliance
Michael Meisinger authored
82 --------------------------
ab3d9bb base service and process, service startup
mmeisinger authored
83 ::
84 git clone git://amoeba.ucsd.edu/carrot.git
85 (cd carrot; git checkout -b txamqp origin/txamqp)
86 (cd carrot; python setup.py install)
7d23793 Added ant build file; supports clean and start of CC
Michael Meisinger authored
87
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
88 Magnet (NEED Magent 0.3.4 on master branch)
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
89 ------------------------------------------------------------------
ab3d9bb base service and process, service startup
mmeisinger authored
90 Get the latest version of the repository, if you haven't already.
91 ::
92 git clone git://amoeba.ucsd.edu/magnet.git # no ooi credential
93 # OR
94 git clone git@amoeba.ucsd.edu:magnet.git # need ooi credential
95 (cd magnet; python setup.py install)
b78736b changed readme; make sure to update and install latest magnet
Michael Meisinger authored
96
ea45e76 removed rm_pyc.sh in favor of ant target; updated README with depende…
Michael Meisinger authored
97 Other Dependencies
98 ----------------------------
99 ::
100 easy_install msgpack-python
101 easy_install pydap
102 easy_install pydap.handlers.netcdf
103 easy_install pydap.responses.netcdf
104 easy_install numpy
105 easy_install httplib2
106 easy_install -U --find-links http://ooici.net/packages pycassa
107 easy_install simplejson
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
108
109
110 ---------------------------------------------------------------------------
111 Change log:
112 ===========
113
911af58 Fixed BaseProcess: states, message dispatching, error handling
Michael Meisinger authored
114 2010-08-06:
115 - BaseProcess.spawn() now calls init() automatically. No need to call init()
116 on a process anymore manually. For testing only. Note: The correct way to
117 spawn a process is through a parent process with spawn_child()
118 - Modified and fixed the BaseProcess states, when receiving messages
119 - MAJOR update to BaseProcess message dispatching and subsequent error handling.
120 On error, reply_err messages are sent back, if reply-to header set.
121
7d23793 Added ant build file; supports clean and start of CC
Michael Meisinger authored
122 2010-08-03:
123 - Added ant build.xml file to LCAarch root dir. Start with ant.
124 Supports ant clean, which removes all *.pyc from ion path.
125
b93d956 Fixing trial errors and adding comments
David Stuebe authored
126 2010-07-23:
127 - Refactored the Registry Services to inherit from a common base class. This
128 will allow easier implementation of the many registries in the OOICI. The
129 Resource Registry and Service Registry now have basic registration of resource
130 descriptions and services.
131 - The Ion message is now encoded usig the MsgPack library to allow for binary
132 transport of message content. The JSON library was mangleing string content.
133 This is a temporary fix for a wider problem with the encoding structure which
134 needs to be addressed in construction.
135
dfe8bf2 fixed problems with logging change; added log level configuration bas…
Michael Meisinger authored
136 2010-06-07:
137 - Redefined logging import to set as module level logger. Each module has now
138 a different logger that can be configured separately. Don't configure
139 manually though.
140 - Added possibility to modify logging levels by module/package, with support
141 for package hierarchy. See res/logging/loglevels.cfg for standard entries.
142 Do not modify. Add file res/logging/loglevelslocal.cfg for local override.
08d0190 fixed some errors related to logging changes
Michael Meisinger authored
143 Default logging level for all ion code: WARNING
f92eeba Added process shutdown support to BaseProcess; refactored BaseProcess…
Michael Meisinger authored
144 2010-06-02:
145 - BaseProcess self members renamed to conform to PEP8
146 - Added process shutdown to BaseProcess
982030b Refactoring in BaseProcess to support an onspawn hook
Michael Meisinger authored
147 - Added container UNIX shell argument -a processes=<path to filename> used
148 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
149 2010-05-25:
150 - Made Cassandra backend parameterizable with keyspace/colfamily and added
151 SuperColumn support.
f2ff6a5 Refactored IStore interface and modified backends, object store, coi …
Michael Meisinger authored
152 - Modified the IStore interface to support a create_store factory method. This
153 method can yield and return a deferred. Modified and fixed IStore impls.
3f881c9 Changed IStore delete to remove; parameterizable cassandra backend
Michael Meisinger authored
154 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
155 2010-05-22:
156 - Added timeout to BaseProcess.rpc_send. Use with kwarg timeout=<secs>
157 - CC-Agent detects missing known containers and removes them from the list
158 - Enhanced CC-Agent operations and CC shell helpers
159 - Added sequence numbers for messages
160 - Added glue functions BaseProcess.reply_ok and reply_err and changes some
161 RPC style service operations.
342829f Local configuration override in ionlocal.config. Unit tests get broke…
Michael Meisinger authored
162 2010-05-20:
163 - The system now looks for a local config file ionlocal.config and if exists,
164 overrides entries in ion.config.
165 - 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
166 config override exists, a different broker (e.g. localhost) can be given.
167 - Added BaseProcessClient and changed BaseServiceClient and all clients and
168 all test cases (again).
3827a32 shell helper functions
Michael Meisinger authored
169 - 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
170 2010-05-16:
171 - Removed support for BaseProcess.send_message and reply_message. Always use
172 send, reply and rpc_send now.
173 - Any BaseProcess instance can now spawn_child() other processes.
174 - Removed RpcClient class, because every process can do rpc_send()
175 - Service processes now also listen to their service name's queue. The service
176 name is determined from the service declaration. Two processes will listen
177 to the same queue and take messages round robin from the queue.
178 - Startup arguments evaluated, for instance to start with system name set:
179 twistd -n magnet -a sysname=mysys
180 twistd -n magnet -a "{'sysname':'mysys'}"
181 - Added capability container agent process. Start with:
182 twistd -n magnet res/scripts/newcc.py
183 Agents announce themselves to others in the same system and can spawn procs.
184 - Name scope 'local' for messaging names means now really local to one container.
185 Use scope 'system' for names unique for each bootstrapped system. Do not use
186 global names, because they will clash.
187 - Less verbose trace output for process init messages and changes to other
188 trace output as well.
bc50a38 Changed BaseServiceClient __init__ args and all client impls; takes n…
Michael Meisinger authored
189 - Changed BaseServiceClient and tests. Initializer arguments different.
cad868a Updated README to correct magnet dependency: now master
Michael Meisinger authored
190 - Using master branch of magnet now
7a9f54a python 2.5 compatibility: changed .format to % and json import
Michael Meisinger authored
191 2010-05-10:
192 - Based on entries in config files, service process modules are sought and
193 loaded in order to collect the service process declarations. This enables
194 a registration of services with versions and dependencies on startup
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
195 2010-05-06:
196 - Refactored the BaseProcess class.
197 - 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
198 the need for an RpcClient. Works even with other messages coming in at the
199 same time (using the conv-id)
c43dc6c Readme appended with last changes, OTP functions in base_process
Michael Meisinger authored
200 - Added aliases: self.send, self.reply (use these now)
201 - Process instance can be spawned via self.spawn()
202 - Provided an easier to use BaseServiceClient, which uses a default service
203 name lookup. Accepts BaseProcess instance as argument to use for sending/
204 receiving service calls.
Something went wrong with that request. Please try again.