Initial add of defaria.com
[clearscm.git] / defaria.com / blogs / Status / 2007 / 12 / post-5.html
1 <!DOCTYPE html>
2 <html lang="en-us" itemscope itemtype="http://schema.org/Article">
3   <head>
4     <meta charset="utf-8">
5     <meta name="description" content=" Documented how to properly source cq_setup...">
6     <meta name="generator" content="Movable Type 5.2.3">
7     <title> - Status</title>
8     <link rel="alternate" type="application/atom+xml" title="Recent Entries" href="http://defaria.com/blogs/Status/atom.xml">
9     <link rel="canonical" href="http://defaria.com/blogs/Status/2007/12/post-5.html">
10     <meta name="viewport" content="width=device-width,initial-scale=1">
11     <link rel="stylesheet" href="http://defaria.com/blogs/Status/styles.css">
12     <!--[if lt IE 9]>
13     <link rel="stylesheet" href="http://defaria.com/blogs/Status/styles_ie.css">
14     <script src="/mt/mt-static/support/theme_static/rainier/js/html5shiv.js"></script>
15     <![endif]-->
16     
17     <link rel="start" href="http://defaria.com/blogs/Status/">
18
19     <link rel="prev" href="http://defaria.com/blogs/Status/2007/11/ucmwb-124-new-c.html" title="UCMWB 1.2.4 &amp; new comptree (IPC)">
20     <link rel="next" href="http://defaria.com/blogs/Status/2008/01/eastpm.html" title="East.pm">
21     <!-- Open Graph Protocol -->
22     <meta property="og:type" content="article">
23     <meta property="og:locale" content="en-us">
24     <meta property="og:title" content="">
25     <meta property="og:url" content="http://defaria.com/blogs/Status/2007/12/post-5.html">
26     <meta property="og:description" content=" Documented how to properly source cq_setup...">
27     <meta property="og:site_name" content="Status">
28     <meta property="og:image" content="/mt/mt-static/support/theme_static/rainier/img/siteicon-sample.png">
29     <!-- Metadata -->
30     <meta itemprop="description" content=" Documented how to properly source cq_setup...">
31     <link itemprop="url" href="http://defaria.com/blogs/Status/2007/12/post-5.html">
32     <link itemprop="image" href="/mt/mt-static/support/theme_static/rainier/img/siteicon-sample.png">
33     
34   </head>
35   <body>
36     <div id="container">
37       <div id="container-inner">
38         <header id="header" role="banner">
39           <div id="header-inner">
40             <div id="header-content">
41               <h1>
42                 <a href="http://defaria.com/blogs/Status/">
43
44                   Status
45
46                 </a>
47               </h1>
48               
49             </div>
50
51             <nav role="navigation">
52           <ul>
53             <li><a href="http://defaria.com/blogs/Status/">Home</a></li>
54
55
56           </ul>
57         </nav>
58
59           </div>
60         </header>
61         <div id="content">
62           <div id="content-inner">
63             <ul class="breadcrumb breadcrumb-list">
64               <li class="breadcrumb-list-item"><a href="http://defaria.com/blogs/Status/">Home</a></li>
65               <li class="breadcrumb-list-item"></li>
66             </ul>
67             <div id="individual-main" class="main" role="main">
68               <article id="entry-1940" class="entry entry-asset asset hentry">
69                 <div class="asset-header">
70                   <h2 itemprop="name" class="asset-name entry-title"></h2>
71                   <footer class="asset-meta">
72                     <ul class="asset-meta-list">
73                       <li class="asset-meta-list-item">Posted on <time datetime="2007-12-06T16:52:05-08:00" itemprop="datePublished">December  6, 2007</time></li>
74                       <li class="asset-meta-list-item">by <span class="author entry-author vcard"></span></li>
75
76   
77
78                    </ul>
79                 </footer>
80                 </div>
81                 <div class="entry-content asset-content" itemprop="articleBody">
82                   <ul>
83   <li>Documented how to properly source cq_setup</li>
84 </ul>
85                   <h3>cq_setup</h3>
86
87 <p>In order for Clearquest to work properly the user must source cq_setup.
88 Rational provides both cq_setup.csh for C style shells and cq_setup.sh
89 for Borne style shells. GD only primarly supports tcsh/csh shells and
90 provides a start up environment for those shells. However, Linux
91 systems then to use bash by default.</p>
92
93 <h3>bashrc</h3>
94
95 <p>An effort has been made to tranliterate the GD/RAN tcsh/csh startup
96 environment -&gt; a bash startup environment (this can be found under
97 /prj/muosran/config/bashrc).  Further complicating matters is that SWIT
98 and Pat Phelps group have their own, highly customized environment.</p>
99
100 <h3>Proposed change to ~/.bash_profile</h3>
101
102 <div class=code><pre>
103 if [ -f /opt/rational/clearquest/bin/clearquest ]; then
104   . /prj/muosran/config/cq_setup.sh
105   fi
106 </pre></div>
107
108 <p>The above should be added to the ~/.bash_profile which (from the bash(1) manpage):</p>
109
110 <blockquote>
111   <p>When bash is invoked as an interactive login shell, or as a non-interactive shell with the --login option, it first reads and executes commands from the file /etc/profile, if that file  exists.  After  reading that file, it looks for ~/.bash_profile, ~/.bash_login, and ~/.profile,  in that order, and reads and executes commands from the first one that exists and is readable. The --noprofile option may be used when the shell is started to inhibit this behavior.</p>
112 </blockquote>
113
114 <p>Since we are only really concerned with executing cq_setup for the purposes or running clearquest, the GUI client, we should only be
115 concerned with interactive login shells.</p>
116
117 <p>For the record, also from the bash(1) manpage:</p>
118
119 <blockquote>
120   <p>When an interactive shell that is not  a login shell is started, bash reads and executes commands from ~/.bashrc, if that file exists. This may be inhibited by using the --norc option. The --rcfile file option will force bash to read and execute commands from file instead of ~/.bashrc.</p>
121 </blockquote>
122
123 <h3>The /prj/muosran/config versions</h3>
124
125 <p>As I said Rational supports it's own versions of cq_setup.[csh|sh] stored in /opt/rational/clearquest. Why the private copies under /prj/muosran/config you ask? The main (i.e. only real) difference is that the Rational copies annoyingly echo out "You can now run 'clearquest' to start Rational ClearQuest'.</p>
126
127 <h3>Platform independence</h3>
128
129 <p>In order to maintain platform independance the cq_setup.[csh|sh] script
130 resides in /opt/rational/clearquest/bin/clearquest. The Rational installation procedure symlinks this to /opt/rational/clearquest/&lt;arch&gt;/bin/clearquest where &lt;arch&gt;
131 is one of sun5, rhat_x86 or later changed to linux_x86.</p>
132
133 <h3>What does cq_setup really do?</h3>
134
135 <p>So what does this cq_setup really do? Glad you asked. Essentially it runs a shell script called clearquest. This shell script does many things related to setting up the proper environment for Clearquest execution then exec's clearquest_main. In fact, many scripts under /opt/rational/clearquest/&lt;arch&gt;/bin are merely symlinks to this clearquest script. Based on the name of the script invoked (i.e. $0) the script will do different things but all essentially set up the environment and exec clearcase_main.</p>
136
137 <h3>Dumping environment variable settings</h3>
138
139 <p>It also supports parameters. In particular it supports the special -dumpsh and -dumpcsh parameters. When called with these parameters it essentially dumps out the required shell syntax (sh or csh) for setting environment variables. Here's an example run:</p>
140
141 <div class=code><pre>
142 # /opt/rational/clearquest/bin/clearquest -dumpsh
143 PATH='/opt/rational/clearquest//bin:/home/p6258c/bin/sun:.:/home/p6258c/bin:/home/p6258c/adm/bin:/home/p6258c/adm/cc:/home/p6258c/adm/cq:/home/p6258c/adm/cvsbin:/usr/local/bin:/usr/local/oracle/product/9.2/bin:/prj/muosran/bin:/prj/software/framemaker/bin:/prj/Studio11/SUNWspro/bin:/opt/rational/clearquest/bin:/prj/muosran/bin:/opt/rational/clearcase/bin:/opt/rational/clearcase/etc:/prj/Imagix4D/bin:/usr/local/python-1.5.2/bin:/prj/MathWorksR14sp3/bin:/usr/local/swig/bin:/prj/synplify81/fpga_81/bin:/usr/local/slickedit11/bin:/usr/local/python-1.5.2/bin:/cleartrig/ent/SNSD/muos/ccadm_tools/vobs/ranccadm/scripts/clearcase:/cleartrig/ent/SNSD/muos/ccadm_tools/vobs/ranccadm/scripts/clearquest:/home/p6258c/adm/bin:/bin:/usr/local/bin:/usr/bin:/usr/dt/bin:/usr/openwin/bin:/usr/sbin:/usr/ccs/bin:/usr/ucb';<br>
144 export PATH;
145 CQ_HOME='/opt/rational/clearquest/';
146 export CQ_HOME;
147 CQ_ARCH='sun5';
148 export CQ_ARCH;
149 ODBCINI='/opt/rational/clearquest//sun5/resources/cqodbc.ini';
150 export ODBCINI;
151 LM_LICENSE_FILE='flex2:flex2:1850@flex2:15280@ranadm2:19353@ranadm2:19355@ranadm2:2468@ranadm2:1717@flex2:1711@bartlett:1711@flex3:27000@ranadm2:28000@ranadm2:5270@flex2';<br>
152 export LM_LICENSE_FILE;
153 RSU_TEMPLATE2_INI='/opt/rational/clearquest//sun5/resources/templates2.ini';<br>
154 export RSU_TEMPLATE2_INI;
155 MANPATH='/opt/rational/clearquest//doc/En_US/man:/usr/man:/usr/share/man:/usr/dt/man:/usr/openwin/share/man:/usr/local/man:/usr/local/share/man';<br>
156 export MANPATH;
157 CQ_HELP_BROWSER='netscape';
158 export CQ_HELP_BROWSER;
159 CQ_PERLLIB='/opt/rational/clearquest//../common/lib/perl5/5.6.1/sun4-solaris-multi:/opt/rational/clearquest//../common/lib/perl5/5.6.1:/opt/rational/clearquest//../common/lib/perl5/site_perl/5.6.1/sun4-solaris-multi:/opt/rational/clearquest//../common/lib/perl5/site_perl/5.6.1:/opt/rational/clearquest//../common/lib/perl5/site_perl';<br>
160 export CQ_PERLLIB;
161 LD_LIBRARY_PATH='/usr/lib:/usr/ucblib:/usr/local/lib:/usr/local/oracle/product/9.2/lib:/usr/local/python-1.5.2/lib:/opt/rational/clearcase/shlib:/opt/rational/clearquest//sun5/shlib:/opt/rational/clearquest//sun5/odbc/lib';<br>
162 export LD_LIBRARY_PATH;
163 EVAL_STATUS=0;<br>
164 export EVAL_STATUS;</tt>
165 </pre></div>
166
167 <h3>Eval</h3>
168
169 <p>As such this execution is meant to passed to eval(1) so that these environment variable setting statement are evaluated and the environment is modified. Finally one should source (csh or "." in sh) this to effect the current shell. Hence we boil all this down to:</p>
170
171 <div class=code><pre>
172 if [ -f /opt/rational/clearquest/bin/clearquest ]; then
173   . /prj/muosran/config/cq_setup.sh
174 fi
175 </pre></div>
176                 </div>
177                 <nav class="page-navigation entry-navigation pagination content-nav">
178                   <ul class="page-navigation-list">
179
180                     <li class="page-navigation-list-item page-navigation-prev"><a rel="prev" href="http://defaria.com/blogs/Status/2007/11/ucmwb-124-new-c.html" title="UCMWB 1.2.4 &amp; new comptree (IPC)">Previous entry</a></li>
181
182
183                     <li class="page-navigation-list-item page-navigation-next"><a rel="next" href="http://defaria.com/blogs/Status/2008/01/eastpm.html" title="East.pm">Next entry</a></li>
184
185                   </ul>
186                 </nav>
187                 <!--
188 <aside id="zenback" class="zenback feedback">
189   Please paste Zenback script code here.
190 </aside>
191 -->
192                 
193                 
194               </article>
195             </div>
196             <aside class="widgets related" role="complementary">
197               <nav class="widget-search widget">
198   <div class="widget-content">
199     <form method="get" id="search" action="http://defaria.com/mt/mt-search.cgi">
200       <div>
201         <input type="text" name="search" value="" placeholder="Search...">
202
203         <input type="hidden" name="IncludeBlogs" value="8">
204
205         <input type="hidden" name="limit" value="20">
206         <button type="submit" name="button">
207           <img alt="Search" src="/mt/mt-static/support/theme_static/rainier/img/search-icon.png">
208         </button>
209       </div>
210     </form>
211   </div>
212 </nav>
213 <nav class="widget-archive-category widget">
214   <h3 class="widget-header">Categories</h3>
215   <div class="widget-content">
216     
217       
218     <ul class="widget-list">
219       
220       
221       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/ameriquest/">Ameriquest (99)</a>
222       
223       
224       </li>
225       
226     
227       
228       
229       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/audience/">Audience (3)</a>
230       
231       
232       </li>
233       
234     
235       
236       
237       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/broadcom/">Broadcom (76)</a>
238       
239       
240       </li>
241       
242     
243       
244       
245       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/gpdb/">GPDB (35)</a>
246       
247       
248       </li>
249       
250     
251       
252       
253       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/general-dynamics/">General Dynamics (61)</a>
254       
255       
256       </li>
257       
258     
259       
260       
261       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/general-electric/">General Electric (13)</a>
262       
263       
264       </li>
265       
266     
267       
268       
269       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/hewlett-packard/">Hewlett Packard (13)</a>
270       
271       
272       </li>
273       
274     
275       
276       
277       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/lynuxworks/">LynuxWorks (162)</a>
278       
279       
280       </li>
281       
282     
283       
284       
285       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/pqa/">PQA (35)</a>
286       
287       
288       </li>
289       
290     
291       
292       
293       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/salira/">Salira (79)</a>
294       
295       
296       </li>
297       
298     
299       
300       
301       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/tellabs/">Tellabs (2)</a>
302       
303       
304       </li>
305       
306     
307       
308       
309       <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/texas-instruments/">Texas Instruments (31)</a>
310       
311       
312       </li>
313       
314     </ul>
315       
316     
317   </div>
318 </nav>
319   
320
321 <nav class="widget-archive-dropdown widget">
322   <h3 class="widget-header">Archives</h3>
323   <div class="widget-content">
324     <select>
325       <option>Select a Month...</option>
326     
327       <option value="http://defaria.com/blogs/Status/2016/02/">February 2016</option>
328     
329   
330     
331       <option value="http://defaria.com/blogs/Status/2014/09/">September 2014</option>
332     
333   
334     
335       <option value="http://defaria.com/blogs/Status/2014/04/">April 2014</option>
336     
337   
338     
339       <option value="http://defaria.com/blogs/Status/2014/03/">March 2014</option>
340     
341   
342     
343       <option value="http://defaria.com/blogs/Status/2013/02/">February 2013</option>
344     
345   
346     
347       <option value="http://defaria.com/blogs/Status/2012/09/">September 2012</option>
348     
349   
350     
351       <option value="http://defaria.com/blogs/Status/2012/08/">August 2012</option>
352     
353   
354     
355       <option value="http://defaria.com/blogs/Status/2012/05/">May 2012</option>
356     
357   
358     
359       <option value="http://defaria.com/blogs/Status/2012/04/">April 2012</option>
360     
361   
362     
363       <option value="http://defaria.com/blogs/Status/2012/02/">February 2012</option>
364     
365   
366     
367       <option value="http://defaria.com/blogs/Status/2012/01/">January 2012</option>
368     
369   
370     
371       <option value="http://defaria.com/blogs/Status/2011/10/">October 2011</option>
372     
373   
374     
375       <option value="http://defaria.com/blogs/Status/2011/07/">July 2011</option>
376     
377   
378     
379       <option value="http://defaria.com/blogs/Status/2010/09/">September 2010</option>
380     
381   
382     
383       <option value="http://defaria.com/blogs/Status/2010/08/">August 2010</option>
384     
385   
386     
387       <option value="http://defaria.com/blogs/Status/2010/04/">April 2010</option>
388     
389   
390     
391       <option value="http://defaria.com/blogs/Status/2010/03/">March 2010</option>
392     
393   
394     
395       <option value="http://defaria.com/blogs/Status/2010/02/">February 2010</option>
396     
397   
398     
399       <option value="http://defaria.com/blogs/Status/2009/05/">May 2009</option>
400     
401   
402     
403       <option value="http://defaria.com/blogs/Status/2009/04/">April 2009</option>
404     
405   
406     
407       <option value="http://defaria.com/blogs/Status/2008/07/">July 2008</option>
408     
409   
410     
411       <option value="http://defaria.com/blogs/Status/2008/05/">May 2008</option>
412     
413   
414     
415       <option value="http://defaria.com/blogs/Status/2008/04/">April 2008</option>
416     
417   
418     
419       <option value="http://defaria.com/blogs/Status/2008/03/">March 2008</option>
420     
421   
422     
423       <option value="http://defaria.com/blogs/Status/2008/02/">February 2008</option>
424     
425   
426     
427       <option value="http://defaria.com/blogs/Status/2008/01/">January 2008</option>
428     
429   
430     
431       <option value="http://defaria.com/blogs/Status/2007/12/">December 2007</option>
432     
433   
434     
435       <option value="http://defaria.com/blogs/Status/2007/11/">November 2007</option>
436     
437   
438     
439       <option value="http://defaria.com/blogs/Status/2007/10/">October 2007</option>
440     
441   
442     
443       <option value="http://defaria.com/blogs/Status/2007/09/">September 2007</option>
444     
445   
446     
447       <option value="http://defaria.com/blogs/Status/2007/08/">August 2007</option>
448     
449   
450     
451       <option value="http://defaria.com/blogs/Status/2007/07/">July 2007</option>
452     
453   
454     
455       <option value="http://defaria.com/blogs/Status/2007/06/">June 2007</option>
456     
457   
458     
459       <option value="http://defaria.com/blogs/Status/2007/05/">May 2007</option>
460     
461   
462     
463       <option value="http://defaria.com/blogs/Status/2007/04/">April 2007</option>
464     
465   
466     
467       <option value="http://defaria.com/blogs/Status/2007/03/">March 2007</option>
468     
469   
470     
471       <option value="http://defaria.com/blogs/Status/2007/01/">January 2007</option>
472     
473   
474     
475       <option value="http://defaria.com/blogs/Status/2006/12/">December 2006</option>
476     
477   
478     
479       <option value="http://defaria.com/blogs/Status/2006/11/">November 2006</option>
480     
481   
482     
483       <option value="http://defaria.com/blogs/Status/2006/10/">October 2006</option>
484     
485   
486     
487       <option value="http://defaria.com/blogs/Status/2006/09/">September 2006</option>
488     
489   
490     
491       <option value="http://defaria.com/blogs/Status/2006/07/">July 2006</option>
492     
493   
494     
495       <option value="http://defaria.com/blogs/Status/2006/06/">June 2006</option>
496     
497   
498     
499       <option value="http://defaria.com/blogs/Status/2006/05/">May 2006</option>
500     
501   
502     
503       <option value="http://defaria.com/blogs/Status/2006/04/">April 2006</option>
504     
505   
506     
507       <option value="http://defaria.com/blogs/Status/2006/03/">March 2006</option>
508     
509   
510     
511       <option value="http://defaria.com/blogs/Status/2006/02/">February 2006</option>
512     
513   
514     
515       <option value="http://defaria.com/blogs/Status/2006/01/">January 2006</option>
516     
517   
518     
519       <option value="http://defaria.com/blogs/Status/2005/12/">December 2005</option>
520     
521   
522     
523       <option value="http://defaria.com/blogs/Status/2005/11/">November 2005</option>
524     
525   
526     
527       <option value="http://defaria.com/blogs/Status/2005/10/">October 2005</option>
528     
529   
530     
531       <option value="http://defaria.com/blogs/Status/2005/09/">September 2005</option>
532     
533   
534     
535       <option value="http://defaria.com/blogs/Status/2005/08/">August 2005</option>
536     
537   
538     
539       <option value="http://defaria.com/blogs/Status/2005/07/">July 2005</option>
540     
541   
542     
543       <option value="http://defaria.com/blogs/Status/2005/06/">June 2005</option>
544     
545   
546     
547       <option value="http://defaria.com/blogs/Status/2005/05/">May 2005</option>
548     
549   
550     
551       <option value="http://defaria.com/blogs/Status/2005/04/">April 2005</option>
552     
553   
554     
555       <option value="http://defaria.com/blogs/Status/2005/03/">March 2005</option>
556     
557   
558     
559       <option value="http://defaria.com/blogs/Status/2005/02/">February 2005</option>
560     
561   
562     
563       <option value="http://defaria.com/blogs/Status/2005/01/">January 2005</option>
564     
565   
566     
567       <option value="http://defaria.com/blogs/Status/2004/12/">December 2004</option>
568     
569   
570     
571       <option value="http://defaria.com/blogs/Status/2004/09/">September 2004</option>
572     
573   
574     
575       <option value="http://defaria.com/blogs/Status/2004/08/">August 2004</option>
576     
577   
578     
579       <option value="http://defaria.com/blogs/Status/2004/07/">July 2004</option>
580     
581   
582     
583       <option value="http://defaria.com/blogs/Status/2004/06/">June 2004</option>
584     
585   
586     
587       <option value="http://defaria.com/blogs/Status/2004/05/">May 2004</option>
588     
589   
590     
591       <option value="http://defaria.com/blogs/Status/2004/04/">April 2004</option>
592     
593   
594     
595       <option value="http://defaria.com/blogs/Status/2004/03/">March 2004</option>
596     
597   
598     
599       <option value="http://defaria.com/blogs/Status/2004/02/">February 2004</option>
600     
601   
602     
603       <option value="http://defaria.com/blogs/Status/2004/01/">January 2004</option>
604     
605   
606     
607       <option value="http://defaria.com/blogs/Status/2003/12/">December 2003</option>
608     
609   
610     
611       <option value="http://defaria.com/blogs/Status/2003/11/">November 2003</option>
612     
613     </select>
614   </div>
615 </nav>
616     
617   
618
619 <div class="widget-syndication widget section">
620   <div class="widget-content">
621     <p><img src="http://defaria.com/mt/mt-static/images/status_icons/feed.gif" alt="Subscribe to feed" width="9" height="9" /> <a href="http://defaria.com/blogs/Status/atom.xml">Subscribe to this blog's feed</a></p>
622
623   </div>
624 </div>
625
626             </aside>
627           </div>
628         </div>
629         <footer id="footer" role="contentinfo">
630           <div id="footer-inner">
631             <div id="footer-content">
632   <nav role="navigation">
633           <ul>
634             <li><a href="http://defaria.com/blogs/Status/">Home</a></li>
635
636
637           </ul>
638         </nav>
639
640   <p class="license">&copy; Copyright 2016.</p>
641   <p class="poweredby">Powered by <a href="http://www.movabletype.org/">Movable Type</a></p>
642 </div>
643           </div>
644         </footer>
645       </div>
646     </div>
647     <script src="http://defaria.com/mt/mt-static/jquery/jquery.min.js"></script>
648     <script src="http://defaria.com/blogs/Status/mt-theme-scale2.js"></script>
649   </body>
650 </html>