Home My Page Projects Code Snippets Project Openings SML/NJ
Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Diff of /sml/trunk/INSTALL
ViewVC logotype

Diff of /sml/trunk/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1362, Wed Sep 10 20:36:11 2003 UTC revision 1385, Fri Sep 19 20:55:21 2003 UTC
# Line 36  Line 36 
36     - Run the installer, it will automatically fetch all other necessary     - Run the installer, it will automatically fetch all other necessary
37       tarballs:       tarballs:
38    
       $ config/new-install.sh  
   
      or, if this should fail for any reason(*),  
   
39        $ config/install.sh        $ config/install.sh
40    
41       If the installer complains about not being able to fetch those       If the installer complains about not being able to fetch those
# Line 52  Line 48 
48     -------------------------------------------------     -------------------------------------------------
49    
50     - Use some other means of downloading the necessary tarballs.  Store     - Use some other means of downloading the necessary tarballs.  Store
51       them in directory $d.  Then run the installer (config/new-install.sh       them in directory $d.  Then run the installer (config/install.sh).
      or config/install.sh).  
52    
53       Here is a table that shows which packages you will need to download       Here is a table that shows which packages you will need to download
54       depending on what you select in config/targets.  Take the union of       depending on what you select in config/targets.  Take the union of
# Line 123  Line 118 
118        directory), you can customize the set of libraries that are        directory), you can customize the set of libraries that are
119        pre-loaded (either directly or via CM's "autoload" mechanism).        pre-loaded (either directly or via CM's "autoload" mechanism).
120    
121        For this, edit config/preloads before running config/new-install.sh        For this, edit config/preloads before running config/install.sh.
       (or config/install.sh).  
122    
123     2.3.  Using a different ftp server (for a step-1.-like installation)     2.3.  Using a different ftp server (for a step-1.-like installation)
124     --------------------------------------------------------------------     --------------------------------------------------------------------
# Line 133  Line 127 
127        then you can speed up installation by pointing the automatic URL        then you can speed up installation by pointing the automatic URL
128        fetch mechanism there.  The URL of the repository is stored in        fetch mechanism there.  The URL of the repository is stored in
129        config/srcarchiveurl.  Edit this file before running        config/srcarchiveurl.  Edit this file before running
130        config/new-install.sh (or config/install.sh).        config/install.sh.
131    
132     2.4.  Using locally stored tarballs     2.4.  Using locally stored tarballs
133     -----------------------------------     -----------------------------------
# Line 196  Line 190 
190     2.8 Forcing the installer to use a particular URL getter program     2.8 Forcing the installer to use a particular URL getter program
191     ----------------------------------------------------------------     ----------------------------------------------------------------
192    
193     By default, config/new-install.sh (and config/install.sh) will     By default, config/install.sh will attempt to use wget, curl, and
194     attempt to use wget, curl, and lynx (in that order).  If you     lynx (in that order).  If you already know which of these programs
195     already know which of these programs you want     you want the installer to use, then set the environment variable
196     the installer to use, then set the environment variable URLGETTER     URLGETTER to "wget", "curl", or "lynx", respectively.
    to "wget", "curl", or "lynx", respectively.  
197    
198     You can also set URLGETTER to any other command "foo" as long as     You can also set URLGETTER to any other command "foo" as long as
199     it can be invoked as     it can be invoked as
# Line 210  Line 203 
203     where <source> is the URL you want to fetch and <destination> is     where <source> is the URL you want to fetch and <destination> is
204     the file name where the result will be stored.     the file name where the result will be stored.
205    
206       2.9 Where are those "CM" directories?
207       -------------------------------------
208    
209       CM metadata (source skeletons, compiled files, stable libraries, GUIDs,
210       ...) are now stored under a directory called ".cm".  We changed this
211       from the original "CM" because of name clashes on case-insensitive
212       file systems.  However, SML/NJ itself can work with any (reasonable)
213       choice of name for the metadata directory -- but for consistency the
214       choice has to be made at installation time.
215    
216       To choose a different name for metadata directories, run
217       config/install.sh in the presence of an environment variable
218       CM_DIR_ARC.  For example, if you want to have all these directories
219       be named "FOOBAR", then run the installer (assuming a Bourne-ish
220       shell) as
221    
222          $ CM_DIR_ARC=FOOBAR config/install.sh
223    
224  3. Troubleshooting:  3. Troubleshooting:
225  -------------------  -------------------
226    
# Line 232  Line 243 
243        "xget".  You could then make a shell script that wraps xget, e.g.        "xget".  You could then make a shell script that wraps xget, e.g.
244        using a shell script "myxget" consisting of the single line:        using a shell script "myxget" consisting of the single line:
245    
246            exec xget -nv -O $2 $1           $ exec xget -nv -O $2 $1
247    
248        Once you have myxget, simply run:        Once you have myxget, simply run:
249    
250            URLGETTER=myxget config/install.sh           $ URLGETTER=myxget config/install.sh
251    
252  ----------------------------------------------------------------------------  ----------------------------------------------------------------------------
 (*) config/new-install.sh is a newer version of our installer with  
     major parts written in SML rather than as a shell script.  
     Since it is fairly new it may still have some problems -- in which  
     case you can fall back to the old config/install.sh.  

Legend:
Removed from v.1362  
changed lines
  Added in v.1385

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0