2 <html lang="en-us" itemscope itemtype="http://schema.org/Article">
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">
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>
17 <link rel="start" href="http://defaria.com/blogs/Status/">
19 <link rel="prev" href="http://defaria.com/blogs/Status/2007/11/ucmwb-124-new-c.html" title="UCMWB 1.2.4 & 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">
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">
37 <div id="container-inner">
38 <header id="header" role="banner">
39 <div id="header-inner">
40 <div id="header-content">
42 <a href="http://defaria.com/blogs/Status/">
51 <nav role="navigation">
53 <li><a href="http://defaria.com/blogs/Status/">Home</a></li>
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>
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>
81 <div class="entry-content asset-content" itemprop="articleBody">
83 <li>Documented how to properly source cq_setup</li>
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>
95 <p>An effort has been made to tranliterate the GD/RAN tcsh/csh startup
96 environment -> 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>
100 <h3>Proposed change to ~/.bash_profile</h3>
102 <div class=code><pre>
103 if [ -f /opt/rational/clearquest/bin/clearquest ]; then
104 . /prj/muosran/config/cq_setup.sh
108 <p>The above should be added to the ~/.bash_profile which (from the bash(1) manpage):</p>
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>
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>
117 <p>For the record, also from the bash(1) manpage:</p>
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>
123 <h3>The /prj/muosran/config versions</h3>
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>
127 <h3>Platform independence</h3>
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/<arch>/bin/clearquest where <arch>
131 is one of sun5, rhat_x86 or later changed to linux_x86.</p>
133 <h3>What does cq_setup really do?</h3>
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/<arch>/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>
137 <h3>Dumping environment variable settings</h3>
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>
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>
145 CQ_HOME='/opt/rational/clearquest/';
149 ODBCINI='/opt/rational/clearquest//sun5/resources/cqodbc.ini';
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>
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>
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;
164 export EVAL_STATUS;</tt>
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>
171 <div class=code><pre>
172 if [ -f /opt/rational/clearquest/bin/clearquest ]; then
173 . /prj/muosran/config/cq_setup.sh
177 <nav class="page-navigation entry-navigation pagination content-nav">
178 <ul class="page-navigation-list">
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 & new comptree (IPC)">Previous entry</a></li>
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>
188 <aside id="zenback" class="zenback feedback">
189 Please paste Zenback script code here.
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">
201 <input type="text" name="search" value="" placeholder="Search...">
203 <input type="hidden" name="IncludeBlogs" value="8">
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">
213 <nav class="widget-archive-category widget">
214 <h3 class="widget-header">Categories</h3>
215 <div class="widget-content">
218 <ul class="widget-list">
221 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/ameriquest/">Ameriquest (99)</a>
229 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/audience/">Audience (3)</a>
237 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/broadcom/">Broadcom (76)</a>
245 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/gpdb/">GPDB (35)</a>
253 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/general-dynamics/">General Dynamics (61)</a>
261 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/general-electric/">General Electric (13)</a>
269 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/hewlett-packard/">Hewlett Packard (13)</a>
277 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/lynuxworks/">LynuxWorks (162)</a>
285 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/pqa/">PQA (35)</a>
293 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/salira/">Salira (79)</a>
301 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/tellabs/">Tellabs (2)</a>
309 <li class="widget-list-item"><a href="http://defaria.com/blogs/Status/texas-instruments/">Texas Instruments (31)</a>
321 <nav class="widget-archive-dropdown widget">
322 <h3 class="widget-header">Archives</h3>
323 <div class="widget-content">
325 <option>Select a Month...</option>
327 <option value="http://defaria.com/blogs/Status/2016/02/">February 2016</option>
331 <option value="http://defaria.com/blogs/Status/2014/09/">September 2014</option>
335 <option value="http://defaria.com/blogs/Status/2014/04/">April 2014</option>
339 <option value="http://defaria.com/blogs/Status/2014/03/">March 2014</option>
343 <option value="http://defaria.com/blogs/Status/2013/02/">February 2013</option>
347 <option value="http://defaria.com/blogs/Status/2012/09/">September 2012</option>
351 <option value="http://defaria.com/blogs/Status/2012/08/">August 2012</option>
355 <option value="http://defaria.com/blogs/Status/2012/05/">May 2012</option>
359 <option value="http://defaria.com/blogs/Status/2012/04/">April 2012</option>
363 <option value="http://defaria.com/blogs/Status/2012/02/">February 2012</option>
367 <option value="http://defaria.com/blogs/Status/2012/01/">January 2012</option>
371 <option value="http://defaria.com/blogs/Status/2011/10/">October 2011</option>
375 <option value="http://defaria.com/blogs/Status/2011/07/">July 2011</option>
379 <option value="http://defaria.com/blogs/Status/2010/09/">September 2010</option>
383 <option value="http://defaria.com/blogs/Status/2010/08/">August 2010</option>
387 <option value="http://defaria.com/blogs/Status/2010/04/">April 2010</option>
391 <option value="http://defaria.com/blogs/Status/2010/03/">March 2010</option>
395 <option value="http://defaria.com/blogs/Status/2010/02/">February 2010</option>
399 <option value="http://defaria.com/blogs/Status/2009/05/">May 2009</option>
403 <option value="http://defaria.com/blogs/Status/2009/04/">April 2009</option>
407 <option value="http://defaria.com/blogs/Status/2008/07/">July 2008</option>
411 <option value="http://defaria.com/blogs/Status/2008/05/">May 2008</option>
415 <option value="http://defaria.com/blogs/Status/2008/04/">April 2008</option>
419 <option value="http://defaria.com/blogs/Status/2008/03/">March 2008</option>
423 <option value="http://defaria.com/blogs/Status/2008/02/">February 2008</option>
427 <option value="http://defaria.com/blogs/Status/2008/01/">January 2008</option>
431 <option value="http://defaria.com/blogs/Status/2007/12/">December 2007</option>
435 <option value="http://defaria.com/blogs/Status/2007/11/">November 2007</option>
439 <option value="http://defaria.com/blogs/Status/2007/10/">October 2007</option>
443 <option value="http://defaria.com/blogs/Status/2007/09/">September 2007</option>
447 <option value="http://defaria.com/blogs/Status/2007/08/">August 2007</option>
451 <option value="http://defaria.com/blogs/Status/2007/07/">July 2007</option>
455 <option value="http://defaria.com/blogs/Status/2007/06/">June 2007</option>
459 <option value="http://defaria.com/blogs/Status/2007/05/">May 2007</option>
463 <option value="http://defaria.com/blogs/Status/2007/04/">April 2007</option>
467 <option value="http://defaria.com/blogs/Status/2007/03/">March 2007</option>
471 <option value="http://defaria.com/blogs/Status/2007/01/">January 2007</option>
475 <option value="http://defaria.com/blogs/Status/2006/12/">December 2006</option>
479 <option value="http://defaria.com/blogs/Status/2006/11/">November 2006</option>
483 <option value="http://defaria.com/blogs/Status/2006/10/">October 2006</option>
487 <option value="http://defaria.com/blogs/Status/2006/09/">September 2006</option>
491 <option value="http://defaria.com/blogs/Status/2006/07/">July 2006</option>
495 <option value="http://defaria.com/blogs/Status/2006/06/">June 2006</option>
499 <option value="http://defaria.com/blogs/Status/2006/05/">May 2006</option>
503 <option value="http://defaria.com/blogs/Status/2006/04/">April 2006</option>
507 <option value="http://defaria.com/blogs/Status/2006/03/">March 2006</option>
511 <option value="http://defaria.com/blogs/Status/2006/02/">February 2006</option>
515 <option value="http://defaria.com/blogs/Status/2006/01/">January 2006</option>
519 <option value="http://defaria.com/blogs/Status/2005/12/">December 2005</option>
523 <option value="http://defaria.com/blogs/Status/2005/11/">November 2005</option>
527 <option value="http://defaria.com/blogs/Status/2005/10/">October 2005</option>
531 <option value="http://defaria.com/blogs/Status/2005/09/">September 2005</option>
535 <option value="http://defaria.com/blogs/Status/2005/08/">August 2005</option>
539 <option value="http://defaria.com/blogs/Status/2005/07/">July 2005</option>
543 <option value="http://defaria.com/blogs/Status/2005/06/">June 2005</option>
547 <option value="http://defaria.com/blogs/Status/2005/05/">May 2005</option>
551 <option value="http://defaria.com/blogs/Status/2005/04/">April 2005</option>
555 <option value="http://defaria.com/blogs/Status/2005/03/">March 2005</option>
559 <option value="http://defaria.com/blogs/Status/2005/02/">February 2005</option>
563 <option value="http://defaria.com/blogs/Status/2005/01/">January 2005</option>
567 <option value="http://defaria.com/blogs/Status/2004/12/">December 2004</option>
571 <option value="http://defaria.com/blogs/Status/2004/09/">September 2004</option>
575 <option value="http://defaria.com/blogs/Status/2004/08/">August 2004</option>
579 <option value="http://defaria.com/blogs/Status/2004/07/">July 2004</option>
583 <option value="http://defaria.com/blogs/Status/2004/06/">June 2004</option>
587 <option value="http://defaria.com/blogs/Status/2004/05/">May 2004</option>
591 <option value="http://defaria.com/blogs/Status/2004/04/">April 2004</option>
595 <option value="http://defaria.com/blogs/Status/2004/03/">March 2004</option>
599 <option value="http://defaria.com/blogs/Status/2004/02/">February 2004</option>
603 <option value="http://defaria.com/blogs/Status/2004/01/">January 2004</option>
607 <option value="http://defaria.com/blogs/Status/2003/12/">December 2003</option>
611 <option value="http://defaria.com/blogs/Status/2003/11/">November 2003</option>
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>
629 <footer id="footer" role="contentinfo">
630 <div id="footer-inner">
631 <div id="footer-content">
632 <nav role="navigation">
634 <li><a href="http://defaria.com/blogs/Status/">Home</a></li>
640 <p class="license">© Copyright 2016.</p>
641 <p class="poweredby">Powered by <a href="http://www.movabletype.org/">Movable Type</a></p>
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>