| 1 |
williamc |
1.1 |
<! Style Sheet Header>
|
| 2 |
|
|
<html>
|
| 3 |
|
|
<head>
|
| 4 |
|
|
<title>install.html</title>
|
| 5 |
williamc |
1.16 |
<body bgcolor=beige>
|
| 6 |
williamc |
1.1 |
<! End Style Sheet Header -----------Insert Text Here --------------------->
|
| 7 |
|
|
<center><h1>Installing SCRAM</h1>
|
| 8 |
williamc |
1.16 |
<font color=red>S</font>oftware <font color=red>C</font>onfiguration,
|
| 9 |
|
|
<font color=red>R</font>elease <font color=red>A</font>nd
|
| 10 |
|
|
<font color=red>M</font>anagement
|
| 11 |
williamc |
1.1 |
</center>
|
| 12 |
|
|
<hr>
|
| 13 |
|
|
<h2>Requirements</h2>
|
| 14 |
|
|
<em>Essential</em>
|
| 15 |
|
|
<ul>
|
| 16 |
sashby |
1.25 |
<li><a href=http://language.perl.com/>Perl</a> version 5.004 or higher.
|
| 17 |
williamc |
1.16 |
(<a href=perlhelp.html>Perl help</a>).
|
| 18 |
williamc |
1.1 |
<li><a href=http://prep.ai.mit.edu/>gnu</a> make (gmake)
|
| 19 |
|
|
<li><a href=http://www.loria.fr/~molli/cvs-index.html>cvs</a>
|
| 20 |
|
|
</ul>
|
| 21 |
|
|
<hr>
|
| 22 |
|
|
<H2>SCRAM Installation CheckList - Using CVS</H2>
|
| 23 |
|
|
<FORM>
|
| 24 |
|
|
<OL>
|
| 25 |
williamc |
1.9 |
<li>Click on the boxes next to the numbers as you proceed to ensure you don't
|
| 26 |
|
|
miss any steps.
|
| 27 |
|
|
<li><input type="checkbox">
|
| 28 |
sashby |
1.21 |
Create a directory SCRAM in which you wish to keep your scram installation
|
| 29 |
williamc |
1.9 |
<br>e.g.<br>
|
| 30 |
|
|
<em>mkdir SCRAM</em>
|
| 31 |
|
|
<p>
|
| 32 |
|
|
<li><input type="checkbox">Go into the directory you have just made <br>
|
| 33 |
|
|
e.g.<br><em>cd SCRAM</em>
|
| 34 |
|
|
<p>
|
| 35 |
williamc |
1.1 |
<li><input type="checkbox">
|
| 36 |
|
|
Set the Environment variable CVSROOT variable to <em>
|
| 37 |
|
|
<p>
|
| 38 |
williamc |
1.9 |
<center>
|
| 39 |
williamc |
1.4 |
:pserver:anonymous@cmscvs.cern.ch:/cvs_server/repositories/SCRAM
|
| 40 |
williamc |
1.9 |
</center>
|
| 41 |
williamc |
1.1 |
</em>
|
| 42 |
williamc |
1.9 |
<br>
|
| 43 |
williamc |
1.1 |
e.g.<br>
|
| 44 |
|
|
<DL>
|
| 45 |
sashby |
1.25 |
<DT>csh, tcsh:
|
| 46 |
williamc |
1.8 |
<DD><em>setenv CVSROOT :pserver:anonymous@cmscvs.cern.ch:/cvs_server/repositories/SCRAM</em>
|
| 47 |
williamc |
1.1 |
</DL>
|
| 48 |
|
|
<DL>
|
| 49 |
sashby |
1.25 |
<DT>Bourne Shell, zsh, ksh:
|
| 50 |
williamc |
1.8 |
<DD><em>set CVSROOT=:pserver:anonymous@cmscvs.cern.ch:/cvs_server/repositories/SCRAM; export CVSROOT</em>
|
| 51 |
williamc |
1.1 |
</DL>
|
| 52 |
|
|
</DD>
|
| 53 |
|
|
<li><input type="checkbox">
|
| 54 |
williamc |
1.9 |
Type <em>cvs login</em><br>
|
| 55 |
williamc |
1.1 |
At the prompt enter the password <b>98passwd</b>
|
| 56 |
williamc |
1.9 |
<p>
|
| 57 |
williamc |
1.1 |
<li><input type="checkbox">
|
| 58 |
williamc |
1.10 |
Check out the version of scram you require with the following command.
|
| 59 |
williamc |
1.9 |
<p>
|
| 60 |
|
|
<em>cvs co -d <b>version</b> -r <b>version</b> SCRAM</em>
|
| 61 |
|
|
<p>
|
| 62 |
sashby |
1.25 |
Where version is one of versions listed as available on the main
|
| 63 |
|
|
<a href=http://cmsdoc.cern.ch/cgi-cmc/scrampage>scram page</a>.
|
| 64 |
williamc |
1.9 |
Make sure you replace <b>version</b> twice in the above command!
|
| 65 |
sashby |
1.25 |
|
| 66 |
williamc |
1.16 |
<br> Note: Once a version of scram has been installed, installation of any
|
| 67 |
|
|
other version becomes trivial with the <b>scram version <em>Version</em></b>
|
| 68 |
|
|
command
|
| 69 |
williamc |
1.9 |
<p>
|
| 70 |
williamc |
1.1 |
<li><input type="checkbox">
|
| 71 |
williamc |
1.9 |
Goto the Installation directory of the version you have just checked out<p>
|
| 72 |
|
|
e.g<br><em>cd <b>version</b>/Installation</em>
|
| 73 |
|
|
<p>
|
| 74 |
williamc |
1.1 |
<li><input type="checkbox">
|
| 75 |
williamc |
1.9 |
Run the installation script (install_scram).<br>
|
| 76 |
|
|
e.g.<br>
|
| 77 |
|
|
<em>./install_scram</em><p>
|
| 78 |
|
|
This will create a file wrapper script called "scram" in your top level
|
| 79 |
williamc |
1.16 |
directory. <br>
|
| 80 |
sashby |
1.25 |
The Perl executable will be found from your path, automatically. If you want to specify
|
| 81 |
|
|
the location, you can use the -perl option (from V0_15_0): <br>
|
| 82 |
williamc |
1.16 |
e.g <br>
|
| 83 |
sashby |
1.25 |
<em>./install_scram -perl /usr/bin/perl</em>
|
| 84 |
williamc |
1.9 |
<p>
|
| 85 |
|
|
<em>Experienced Users Note:
|
| 86 |
sashby |
1.25 |
The install script will make the current version the default.</em>
|
| 87 |
sashby |
1.26 |
<a name="EXT"></a>
|
| 88 |
|
|
<H3>Further information on SCRAM installation at remote sites</H3>
|
| 89 |
|
|
|
| 90 |
|
|
At external sites, where the SITENAME is not CERN, the installation script has been modified to
|
| 91 |
|
|
allow the site managers to set default values. The script asks for a value for SITENAME:
|
| 92 |
|
|
<pre>
|
| 93 |
|
|
** Please enter the name of your SITE (e.g. CERN[default], FNAL) **
|
| 94 |
|
|
sitename?:
|
| 95 |
|
|
</pre>
|
| 96 |
|
|
and for a default location for the CMS tools file:
|
| 97 |
|
|
<pre>
|
| 98 |
|
|
** Please enter the default location of the cmstools file **
|
| 99 |
|
|
cmstools-CERN.conf location?: ~/siteconf
|
| 100 |
|
|
</pre>
|
| 101 |
|
|
This location should be a directory name (e.g. <em>~/siteconf</em>), under which a
|
| 102 |
|
|
valid file can be found (note that the filename of this file <em>must</em> be cmstools-SITENAME.conf).
|
| 103 |
|
|
<p>
|
| 104 |
|
|
During a setup or project command, this directory will be used in place of
|
| 105 |
|
|
<em>[project_name]/config/site/</em>.
|
| 106 |
|
|
<p>
|
| 107 |
|
|
If the <b>-f</b> argument is given to either the project or setup commands, the file specified will be used
|
| 108 |
|
|
and any other file location (including the default location described above) will be overridden.<br>
|
| 109 |
|
|
For example, if the filename was given as <em>~/myfile.conf</em>, then a file with this name in the
|
| 110 |
|
|
home directory will be used if it exists.
|
| 111 |
|
|
<p>
|
| 112 |
|
|
<b>
|
| 113 |
|
|
Note that any filename given as a cmstools file name must end in ".conf".
|
| 114 |
|
|
</b><p>
|
| 115 |
|
|
The main part of the filename can be anything at all.
|
| 116 |
williamc |
1.2 |
<p>
|
| 117 |
|
|
<li><input type="checkbox">
|
| 118 |
williamc |
1.9 |
change back to your top level directory<br>
|
| 119 |
|
|
e.g.<br><em>cd ../..</em>
|
| 120 |
|
|
<p>
|
| 121 |
|
|
You will see the new file in this directory. Ensure that your system can
|
| 122 |
|
|
see it too by either:
|
| 123 |
|
|
<ul>
|
| 124 |
|
|
<li>Creating a link from an area in your path to the scram file in this
|
| 125 |
|
|
directory
|
| 126 |
|
|
<li>Extending your PATH environment variable to include your top level directory
|
| 127 |
|
|
<li>Creating an alias to point to the scram file in this directory
|
| 128 |
|
|
</ul>
|
| 129 |
|
|
<br>
|
| 130 |
williamc |
1.1 |
<li><input type="checkbox">
|
| 131 |
|
|
If you wish to use SCRAM directly through web page links you will
|
| 132 |
|
|
now need to configure your browser to use scram.
|
| 133 |
|
|
<ul>
|
| 134 |
|
|
<li><a href=netscape_install.html>Configuring Netscape to use SCRAM</a>
|
| 135 |
|
|
</ul>
|
| 136 |
|
|
</OL>
|
| 137 |
sashby |
1.26 |
|
| 138 |
|
|
<p>
|
| 139 |
williamc |
1.1 |
</FORM>
|
| 140 |
|
|
<! Style Sheet Footer ---------------Do not change anything after this line-->
|
| 141 |
|
|
<hr>
|
| 142 |
|
|
<table border=1 width=100%>
|
| 143 |
|
|
<td align=left>
|
| 144 |
sashby |
1.21 |
<a href=mailto:Shaun.Ashby@cern.ch
|
| 145 |
|
|
>Shaun Ashby</a>
|
| 146 |
williamc |
1.1 |
</td>
|
| 147 |
|
|
<td align=center>
|
| 148 |
sashby |
1.21 |
<SCRIPT LANGUAGE="JAVASCRIPT">
|
| 149 |
|
|
document.write("Last Updated "+ document.lastModified );
|
| 150 |
|
|
</SCRIPT>
|
| 151 |
williamc |
1.1 |
</td>
|
| 152 |
|
|
<td align=right>Show <a href=/cgi-cmc/pagestat>Stats</a>
|
| 153 |
|
|
</td>
|
| 154 |
|
|
</table>
|
| 155 |
|
|
</body> </html>
|
| 156 |
|
|
<! End Style Sheet Footer>
|
