Re: [Instrumentelem-user] documentation
Brought to you by:
francesco-lelli
Menu
▾
▴
Re: [Instrumentelem-user] documentation
|
From: Francesco L. <fra...@lu...> - 2009-06-16 14:13:16
|
Hi Teemu,
I build this page trying to answer to your questions:
http://instrumentelem.sourceforge.net/wiki/index.php/Architecture
Hope that it can give a general introduction about "how to access the Web
APIs"
Obviously, any suggestion is more than welcome.
In the next days I will try to answer to the question at this link:
http://instrumentelem.sourceforge.net/wiki/index.php/Service_Concepts
Btw you should probably have all the answers by reading the article and
follows the suggested links for more information
Let me know,
Francesco
On 6/14/09 4:41 PM, "Francesco Lelli" <fra...@lu...> wrote:
> Hi Teemu,
> I will send you the code tomorrow when I will be near my external HD :-).
>
> The instrument that are displayed at the demo web site are simple probe that
> get basic information regarding the machine where they are running and they
> export them using the WSDL interface of all the IE.
>
> At this link you can have more information:
> http://sadgw.lnl.infn.it:2002/MapsMonitor/docs/P2PInstrumentElement.htm#Impl
> emented_Scenario_for_P2P
>
> Talk soon,
> Francesco
>
>
>
> On 6/12/09 1:27 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>
>> Hello Francesco and McKenzie,
>>
>> Sure, I would be interested in having a look at the code.
>>
>> Can you elaborate what is the "the IE end point that I give to you" that
>> you refer to? And is there some simple functional specification on what
>> functionality/services it provides?
>>
>> Teemu
>>
>>> Hi Teemu,
>>> I finally find some spare time to dedicate to our OS project.
>>> Thx for initiating the conversation, I will keep you updated on that.
>>>
>>> I also add McKenzie in this conversation because in the past weeks she was
>>> helping a lot trying to fix our documentation.
>>>
>>> Talking about the P2P source code and other Instrument I did not yet
>>> upload
>>> them in SF because they need a clean-up otherwise you may find some
>>> difficulties in understanding it, btw if you need it now just let me know,
>>> I
>>> will be quite happy to send you a copy of the code.
>>>
>>> The HelloWordIE is a working example that is almost empty and it is a sort
>>> of template for implementing a new instruments. As I said before, more
>>> complicated instruments are coming. Btw, the IE end point that I give to
>>> you
>>> already implements more complex instruments
>>>
>>> Talk to you soon,
>>> Francesco
>>>
>>>
>>>
>>>
>>> On 5/24/09 11:18 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>>>
>>>> Hello Francesco,
>>>>
>>>> I set up a wiki page, as a basis for a guide, where you could maybe
>>>> answer the questions I put up. It is at
>>>> http://instrumentelem.sourceforge.net/wiki/index.php/Service_Concepts
>>>> . Feel free to move it to somewhere better and to change the terms I
>>>> use. I talk about services but maybe you can find a better terminology
>>>> etc. Hopefully you could write it in the style of a guide and not as a
>>>> set of answer to my questions. Also, I probably missed plenty of
>>>> topics, as I am still new to it, so please feel free to add anything
>>>> you find relevant and comes to mind. The javadoc is a good place for
>>>> documentation too, so maybe update that a bit with relevant info if
>>>> possible? Right now it is a bit sparse for someone like me who is new
>>>> to it all. You probably know it inside out as you seem to have
>>>> implemented the code, so for you i am sure it is clear :). Reminds me
>>>> of the nice article in May issue of CACM on API design and user
>>>> involvement (guess I am the user).
>>>>
>>>> Apparently the FAQ is still coming, so I guess it could use all kinds
>>>> of things. Maybe you can explain the basic concepts of instruments and
>>>> the IE project in general. Anyway, here are a few things I found
>>>> myself wondering.
>>>> -Where can I find the source code for the P2P example?
>>>> -Are there any (other) advanced instrument examples available ?
>>>>
>>>> Related to this, the HelloWorldIE example says it prints out received
>>>> events. It doesnt seem to implement anything really though. How is this?
>>>>
>>>> I will likely come back later with more questions and things to
>>>> explain as I try to use it. I will then ask again..:)
>>>>
>>>> Cheers,
>>>> Teemu
>>>>
>>>> On 23.5.2009, at 19.42, Francesco Lelli wrote:
>>>>
>>>>> Hi Teemu,
>>>>> you can have a look on the javadoc
>>>>> http://instrumentelem.sourceforge.net/doc/ie/index.html
>>>>>
>>>>> In particular to the class IInstrumentElement
>>>>>
http://instrumentelem.sourceforge.net/doc/ie/org/ie/IInstrumentElement.htm>>>>>
l
>>>>>
>>>>> Probably it is not enough but is a starting point,
>>>>>> From there I encourage you to prepare few "nice question" that I
>>>>>> will be
>>>>> happy to add to the FAQ section. If you want you can also draft an
>>>>> outline
>>>>> for a guide in our wiki and I will be happy to try to cover the
>>>>> various
>>>>> sections. What do you think about?
>>>>>
>>>>> Talk soon,
>>>>> Francesco
>>>>>
>>>>>
>>>>> On 5/22/09 9:39 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>>>>>
>>>>>> Hello Francesco,
>>>>>>
>>>>>> I already had a look at all the docs I found, including the one at
>>>>>>
http://instrumentelem.sourceforge.net/wiki/index.php/How_to_use_the_Web_S>>>>>>
e
>>>>>> rv
>>>>>> ic
>>>>>> e_API_with_Axis_1.4.
>>>>>> This does not document sessions, top instrument managers or similar
>>>>>> concepts. Is that documented anywhere else or can you add it?
>>>>>>
>>>>>> Teemu
>>>>>>
>>>>>>> Hi Teemu,
>>>>>>> you are asking the right questions :-)
>>>>>>>
>>>>>>> regarding point 1:
>>>>>>> the end point is the following:
>>>>>>> http://<yourMachineName>:<yourTomcatPort>/<yourAppName>/services/
>>>>>>> IEService
>>>>>>>
>>>>>>> I also update some information at this link
>>>>>>> http://instrumentelem.sourceforge.net/wiki/index.php/Installation_Guide
>>>>>>>
>>>>>>> So, talking about the Instruments of the demo valid end points are:
>>>>>>>
>>>>>>> http://sadgw.lnl.infn.it:2002/QoSInstrumentElement/services/
>>>>>>> IEService
>>>>>>>
>>>>>>> http://sadgw.lnl.infn.it:2002/InstrumentElementKeeper/services/IEService
>>>>>>>
>>>>>>> http://gladgw.lnl.infn.it:2002/SeedsFinder/services/IEService
>>>>>>>
>>>>>>>
>>>>>>> In general, if you click on the markers of the demo you will see a
>>>>>>> link
>>>>>>> named "end point" that point you the right location.
>>>>>>>
>>>>>>>
>>>>>>> In addition, if you run an instrument locally by clicking on the
>>>>>>> "join"
>>>>>>> button, you can have a valid end point local to your machine at
>>>>>>> this link:
>>>>>>> http://localhost:3003/axis/
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> Regarding point 2:
>>>>>>> This is a step by step guide on how to access the service:
>>>>>>>
>>>
http://instrumentelem.sourceforge.net/wiki/index.php/How_to_use_the_Web_Ser>>>>
>
>>>>>
>>> v
>>>>>>> ice_API_with_Axis_1.4
>>>>>>>
>>>>>>>
>>>>>>> If you have any problem just drop me a line,
>>>>>>> Francesco
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On 5/18/09 10:55 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>>>>>>>
>>>>>>>> Hello all,
>>>>>>>>
>>>>>>>> I am trying to get familiar with using the project. I found the
>>>>>>>> docs on
>>>>>>>> the wiki and the javadocs, but can't seem to find everything I
>>>>>>>> need. I
>>>>>>>> tried to invoke some of the instruments linked in the demo. Here
>>>>>>>> are
>>>>>>>> some
>>>>>>>> things I am wondering for starters..
>>>>>>>>
>>>>>>>> 1. What are the different elements of an endpoint address?
>>>>>>>> I can copy paste the url from the demo but it was unclear to me
>>>>>>>> which
>>>>>>>> parts were needed, and if there are any options.
>>>>>>>>
>>>>>>>> 2. Apparently I need to start with opening a session, then get a
>>>>>>>> list of
>>>>>>>> all top instrument managers. I figured this mostly with trial and
>>>>>>>> error
>>>>>>>> and from the TestFunctionalityCreation.java class.
>>>>>>>> Where can I find the information on the required process such as
>>>>>>>> why do
>>>>>>>> I
>>>>>>>> need a session, what does it represent, what are top instrument
>>>>>>>> managers
>>>>>>>> and which one should I pick? From TestFunctionalityCreation.java it
>>>>>>>> seems
>>>>>>>> once I manage to figure this out and do it, I then need to get an
>>>>>>>> instance. What instance is this and why do I need it?
>>>>>>>> Don't really know how to proceed from here and so on, so I would
>>>>>>>> like to
>>>>>>>> know where I can find this information and other similar
>>>>>>>> information I
>>>>>>>> need to use it all?
>>>>>>>>
>>>>>>>> Thanks,
>>>>>>>> Teemu
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
----------------------------------------------------------------------->>>>>>>>
-
>>>>>>>> --
>>>>>>>> --
>>>>>>>> --
>>>>>>>> Crystal Reports - New Free Runtime and 30 Day Trial
>>>>>>>> Check out the new simplified licensing option that enables
>>>>>>>> unlimited royalty-free distribution of the report engine
>>>>>>>> for externally facing server and web deployment.
>>>>>>>> http://p.sf.net/sfu/businessobjects
>>>>>>>> _______________________________________________
>>>>>>>> Instrumentelem-user mailing list
>>>>>>>> Ins...@li...
>>>>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>
>>>
---------------------------------------------------------------------------->>>
-
>>>>>
>>>>
>>>>>>
>>>>> -
>>>>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>>>>> is a gathering of tech-side developers & brand creativity
>>>>>>> professionals.
>>>>>>> Meet
>>>>>>> the minds behind Google Creative Lab, Visual Complexity,
>>>>>>> Processing, &
>>>>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>>>>> Barbarian
>>>>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>>>>> _______________________________________________
>>>>>>> Instrumentelem-user mailing list
>>>>>>> Ins...@li...
>>>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>>>>
>>>>>>
>>>>>>
>>>>>> -Teemu
>>>>>>
>>>>>>
>>>>>>
------------------------------------------------------------------------->>>>>>
-
>>>>>> --
>>>>>> --
>>>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>>>> is a gathering of tech-side developers & brand creativity
>>>>>> professionals. Meet
>>>>>> the minds behind Google Creative Lab, Visual Complexity,
>>>>>> Processing, &
>>>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>>>> Barbarian
>>>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>>>> _______________________________________________
>>>>>> Instrumentelem-user mailing list
>>>>>> Ins...@li...
>>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>>
>>>>>
>>>>>
>>>>>
>>>
---------------------------------------------------------------------------->>>
-
>>>>>
>>> -
>>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>>> is a gathering of tech-side developers & brand creativity
>>>>> professionals. Meet
>>>>> the minds behind Google Creative Lab, Visual Complexity, Processing, &
>>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>>> Barbarian
>>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>>> _______________________________________________
>>>>> Instrumentelem-user mailing list
>>>>> Ins...@li...
>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>
>>>>
>>>>
--------------------------------------------------------------------------->>>>
-
>>>> --
>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>> is a gathering of tech-side developers & brand creativity professionals.
>>>> Meet
>>>> the minds behind Google Creative Lab, Visual Complexity, Processing, &
>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>> Barbarian
>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>> _______________________________________________
>>>> Instrumentelem-user mailing list
>>>> Ins...@li...
>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>
>>>
>>>
>>>
>
----------------------------------------------------------------------------->>
>
> -
>>> Crystal Reports - New Free Runtime and 30 Day Trial
>>> Check out the new simplified licensing option that enables unlimited
>>> royalty-free distribution of the report engine for externally facing
>>> server and web deployment.
>>> http://p.sf.net/sfu/businessobjects
>>> _______________________________________________
>>> Instrumentelem-user mailing list
>>> Ins...@li...
>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>
>>
>>
>> -Teemu
>>
>>
>>
----------------------------------------------------------------------------->>
-
>> Crystal Reports - New Free Runtime and 30 Day Trial
>> Check out the new simplified licensing option that enables unlimited
>> royalty-free distribution of the report engine for externally facing
>> server and web deployment.
>> http://p.sf.net/sfu/businessobjects
>> _______________________________________________
>> Instrumentelem-user mailing list
>> Ins...@li...
>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>
>
>
> ------------------------------------------------------------------------------
> Crystal Reports - New Free Runtime and 30 Day Trial
> Check out the new simplified licensing option that enables unlimited
> royalty-free distribution of the report engine for externally facing
> server and web deployment.
> http://p.sf.net/sfu/businessobjects
> _______________________________________________
> Instrumentelem-user mailing list
> Ins...@li...
> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
|
