Bug 3945

Summary:	Quoter-Tutorial CIAO/tutorials/Quoter/Simple does not work
Product:	CIAO	Reporter:	Hendrik Pommrenke <pommrenke.h>
Component:	Examples	Assignee:	DOC Center Support List (internal) <tao-support>
Status:	NEW ---
Severity:	normal	CC:	msmit, pommrenke.h, wotte
Priority:	P3
Version:	0.8.2
Hardware:	All
OS:	Windows XP
Bug Depends on:	3972
Bug Blocks:

Description Hendrik Pommrenke 2011-01-14 09:07:13 CST

There are many mistakes in the instructions in README.html on how to assemble and run it, e.g.
- under "Assemble" the path "Display/descriptors" is mentioned, but should probably be "Simple/descriptors"
- "Modified_Deployment.xsd" not in "Display/descriptors", while XMI.xsd is
- Under "Running the program", script for running node daemons is called "runNodeDaemon.pl", but it's correct name is "runNodeDaemons.pl"
- execution manager path is "$DANCE_ROOT\bin\dance_execution_manager", not "$CIAO_ROOT/DAnCE/ExecutionManager/Execution_Manager"
- plan launcher path is "$DANCE_ROOT\bin\dance_plan_launcher", not "$CIAO_ROOT/DAnCE/Plan_Launcher/plan_launcher"
- plan launcher has no "-p" option, probably "-x" has to be used instead

Despite correcting these issues I couldn't run the tutorial correctly because the execution manager didn't generate the IOR for the plan launcher, or put it to some mysterious place in the file system.

Would be great if some expert could walk through the complete tutorial CIAO/tutorials/Quoter/Simple/README.html and correct it. This would make life a lot easier for CIAO adopters and newbies.

Comment 1 Hendrik Pommrenke 2011-01-14 11:31:50 CST

I think the correct instructions to run the tutorial code have to be as follows:

(everything run from within the .\descriptors folder):

- 1st console: perl runNodeDaemons.pl <enter>
- 2nd console: dance_execution_manager -eior --node-map NodeMap.dat <enter>
   (a file called "ior" is generated)
- 3rd console: dance_plan_launcher -xPlan.cdp -k file:\\ior <enter>

The ior file is generated by the execution manager when you omit the blank after the -e option (This seems to be necessary for some options, while others allow blanks). 
But then the plan launcher fails with a TRANSIENT exception saying 'No usable profile in IOR.'. Below you see the full output (using ACE_LOG_LEVEL=10):

(1672|1460) [LM_TRACE] -  18:18:24.397000 - PlanLauncher - initializing ORB
(1672|1460) [LM_TRACE] -  18:18:24.429000 - PL options : "      E:\dev\3rd-party\ACE_wrappers_5_8_2\TAO\CIAO\DAnCE\bin\dance_plan_launcher
        -xPlan.cdp
        -k
        file://ior
(1672|1460) [LM_DEBUG] -  18:18:24.429000 - Plan_Launcher::parse_args - Using XML plan: Plan.cdp
(1672|1460) [LM_DEBUG] -  18:18:24.429000 - Plan_Launcher::parse_args - Using ExecutionManager IOR: file://ior
(1672|1460) [LM_DEBUG] -  18:18:24.429000 - Plan_Launcher - Parsing deployment plan
(1672|1460) [LM_TRACE] -  18:18:24.429000 - XML_File_Intf::read_process_plan - Constructing DOM
(1672|1460) [LM_TRACE] -  18:18:24.491000 - XML_File_Intf::read_process_plan - DOMElement pointer: 30962480
(1672|1460) [LM_TRACE] -  18:18:24.491000 - XML_File_Intf::read_process_plan - Parsing XML file with XSC
(1672|1460) [LM_TRACE] -  18:18:24.507000 - XML_File_Intf::read_process_plan - Processing using config handlers
(1672|1460) [LM_ERROR] -  18:18:26.554000 - Plan_Launcher_Base_Impl::prepare_plan - Caught StartError exception while invoking preparePlan: 6D382DAE-9024-4C4D-B91B-A0F9176AFACF, 2 errors executing oper
ation:
        Distributor - CORBA exception starting preparePlan : system exception, ID 'IDL:omg.org/CORBA/TRANSIENT:1.0'
OMG minor code (2), described as 'No usable profile in IOR.', completed = NO

        Broker - CORBA exception starting preparePlan : system exception, ID 'IDL:omg.org/CORBA/TRANSIENT:1.0'
OMG minor code (2), described as 'No usable profile in IOR.', completed = NO


(1672|1460) [LM_ERROR] -  18:18:26.554000 - Plan_Launcher::launch_plan - Deployment failed, exception: Caught StartError exception while invoking preparePlan: 6D382DAE-9024-4C4D-B91B-A0F9176AFACF, 2 er
rors executing operation:
        Distributor - CORBA exception starting preparePlan : system exception, ID 'IDL:omg.org/CORBA/TRANSIENT:1.0'
OMG minor code (2), described as 'No usable profile in IOR.', completed = NO

        Broker - CORBA exception starting preparePlan : system exception, ID 'IDL:omg.org/CORBA/TRANSIENT:1.0'
OMG minor code (2), described as 'No usable profile in IOR.', completed = NO

Comment 2 Will Otte 2011-01-14 11:44:37 CST

My guess is the run_NodeDaemons.pl script is wrong.  could you please try with the run_test.pl script that should be in that directory?

Comment 3 Hendrik Pommrenke 2011-01-14 11:53:23 CST

Yes, the run_test.pl works (except one error msg that the CIAO stock ain't there, but I guess that's part of the test scenario). So it's not only README.html that needs to be fixed, but also the "run_NodeDaemons.pl" script. 
I think it's really important that this tutorial works, as it's probably the first contact with CIAO for most users, and can be quite demotivating if nothing works as it should.

Comment 4 Johnny Willemsen 2011-01-18 12:50:09 CST

Tue Jan 18 18:25:03 UTC 2011  Johnny Willemsen  <jwillemsen@remedy.nl>

        * docs/Porting_Hints.txt:
        * docs/releasenotes/switch.html:
        * examples/BasicSP/README.html:
        * examples/BasicSP/RepoMan_Usage.html:
        * examples/Display/README.html:
        * examples/Display/descriptors/basicNodeDaemon.pl:
        * examples/Display/descriptors/run_NodeDaemons.pl:
        * examples/Hello/descriptors/run_NodeDaemons.pl:
        * examples/Hello/step-by-step.html:
        * tests/Bug_2130_Regression/descriptors/run_test.pl:
        * tutorials/Quoter/Simple/04.html:
        * tutorials/Quoter/Simple/README.html:
          Updated executable names and locations

Comment 5 Marcel Smit 2011-06-17 09:25:16 CDT

Once bug #3972 is completed, we can refer to this (or these) documentation pages.