1 | <!-- ******************************************************** --> |
---|
2 | <!-- --> |
---|
3 | <!-- [History] --> |
---|
4 | <!-- 1st version created: Katsuya Amako, Dec-2006 --> |
---|
5 | <!-- --> |
---|
6 | <!-- ******************************************************** --> |
---|
7 | |
---|
8 | |
---|
9 | <!-- ********************* QandA Section ******************** --> |
---|
10 | <section id="qanda.Installation"> |
---|
11 | <title> |
---|
12 | Installation |
---|
13 | </title> |
---|
14 | |
---|
15 | <qandaset defaultlabel="qanda"> |
---|
16 | |
---|
17 | <!-- ******* QandA Entry ******** --> |
---|
18 | <qandaentry id="qanda.Installation.UpkTar"> |
---|
19 | |
---|
20 | <question><para> |
---|
21 | When I download the source from the web, and unpack the tar file, |
---|
22 | some files unpack into the top level directory. |
---|
23 | </para></question> |
---|
24 | |
---|
25 | <answer><para> |
---|
26 | The problem you describe usually is the result of using "UNIX" tar to |
---|
27 | unpack the gtar ("GNU-tar") file, or vice versa, or using zip on either |
---|
28 | the gtar or tar file. Please make certain that you download the correct |
---|
29 | file for your system, and that you use the correct unpacking tool. |
---|
30 | Note that for Linux you must download the gtar.gz file. |
---|
31 | </para></answer> |
---|
32 | |
---|
33 | </qandaentry> |
---|
34 | |
---|
35 | <!-- ******* QandA Entry ******** --> |
---|
36 | <qandaentry id="qanda.Installation.NoCLHEP"> |
---|
37 | |
---|
38 | <question><para> |
---|
39 | I cannot find CLHEP files or library and I have it installed in my system. |
---|
40 | </para></question> |
---|
41 | |
---|
42 | <answer><para> |
---|
43 | If the standard CLHEP installation procedure has been adopted, the variable |
---|
44 | <literal>CLHEP_BASE_DIR</literal> should point to the area where |
---|
45 | <literal>include/</literal> and <literal>lib/</literal> directories for |
---|
46 | CLHEP headers & library are installed in your system. In case the library |
---|
47 | file name is different than the one expected (<literal>libCLHEP.a</literal>), |
---|
48 | you should either create a symbolic link with the expected name, or define |
---|
49 | the variable <literal>CLHEP_LIB</literal> in your environment which |
---|
50 | explicitly sets the name of the CLHEP library. If a non-standard CLHEP |
---|
51 | installation has been adopted, define variables |
---|
52 | <literal>CLHEP_INCLUDE_DIR</literal>, <literal>CLHEP_LIB_DIR</literal> |
---|
53 | (and <literal>CLHEP_LIB</literal>) to refer explicitly to the place where |
---|
54 | headers, library (and library-name) respectively are placed in your system. |
---|
55 | On Windows systems, the full library file name (with extension) should be |
---|
56 | specified as <literal>CLHEP_LIB</literal>, while for UNIX-like systems, |
---|
57 | just the name is required (i.e. <literal>CLHEP</literal> for |
---|
58 | <literal>libCLHEP.a</literal>). |
---|
59 | </para></answer> |
---|
60 | |
---|
61 | </qandaentry> |
---|
62 | |
---|
63 | <!-- ******* QandA Entry ******** --> |
---|
64 | <qandaentry id="qanda.Installation.noCERNLib"> |
---|
65 | |
---|
66 | <question><para> |
---|
67 | While installing the Geant4 libraries I get the following message printed: |
---|
68 | |
---|
69 | <informalexample><programlisting> |
---|
70 | gmake[1]: cernlib: Command not found |
---|
71 | </programlisting></informalexample> |
---|
72 | |
---|
73 | Has Geant4 been installed properly ? What to do to solve this error ? |
---|
74 | </para></question> |
---|
75 | |
---|
76 | <answer><para> |
---|
77 | The message: |
---|
78 | <informalexample><programlisting> |
---|
79 | gmake[1]: cernlib: Command not found |
---|
80 | </programlisting></informalexample> |
---|
81 | |
---|
82 | shows that you don't have the 'cernlib' command installed in your system; |
---|
83 | 'cernlib' is a command from the CERN program library (cernlib) returning a |
---|
84 | list of libraries needed to link a cernlib application. This command is only |
---|
85 | used in the 'g3tog4' module, however, if you do not make use of the 'g3tog4' |
---|
86 | tool, it's harmless. The cernlib script (and the needed cernlib libraries) |
---|
87 | are available from: http://cern.ch/cernlib. |
---|
88 | </para></answer> |
---|
89 | |
---|
90 | </qandaentry> |
---|
91 | |
---|
92 | <!-- ******* QandA Entry ******** --> |
---|
93 | <qandaentry id="qanda.Installation.FileDepend"> |
---|
94 | |
---|
95 | <question><para> |
---|
96 | Trying building the Geant4 libraries I see several of these errors appearing |
---|
97 | and my installation fails: |
---|
98 | <informalexample><programlisting> |
---|
99 | .....G4Exception.d:1: *** missing separator. Stop. |
---|
100 | ...../G4DalitzDecayChannel.d:1: *** missing separator. Stop. |
---|
101 | : |
---|
102 | : |
---|
103 | </programlisting></informalexample> |
---|
104 | Has Geant4 been installed properly ? What to do to solve this error ? |
---|
105 | </para></question> |
---|
106 | |
---|
107 | <answer><para> |
---|
108 | It looks like some file dependencies (.d) are corrupted, possibly due |
---|
109 | to previous build attempts which failed for some reason. |
---|
110 | You need to remove each of them. A quick recipe for doing this is to: |
---|
111 | <itemizedlist spacing="compact"> |
---|
112 | <listitem><para> |
---|
113 | Configure the environment with the installation to be repaired |
---|
114 | </para></listitem> |
---|
115 | <listitem><para> |
---|
116 | Unset the G4WORKDIR environment variable (in case it is eventually set) |
---|
117 | </para></listitem> |
---|
118 | <listitem><para> |
---|
119 | Type: |
---|
120 | <informalexample><programlisting> |
---|
121 | gmake clean dependencies='' |
---|
122 | </programlisting></informalexample> |
---|
123 | |
---|
124 | from the affected module (i.e. for this case, from |
---|
125 | $G4INSTALL/source/global/management and $G4INSTALL/source/particles/management) |
---|
126 | and rebuild. Alternatively, you may use: |
---|
127 | <informalexample><programlisting> |
---|
128 | gmake clean dependencies='' |
---|
129 | </programlisting></informalexample> |
---|
130 | |
---|
131 | from $G4INSTALL/source and rebuild. |
---|
132 | </para></listitem> |
---|
133 | </itemizedlist> |
---|
134 | </para></answer> |
---|
135 | |
---|
136 | </qandaentry> |
---|
137 | |
---|
138 | |
---|
139 | </qandaset> |
---|
140 | </section> |
---|