1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--****************************************************************************
* *
* Viewmol *
* *
* N O D E 3 . H T M L *
* *
* Copyright (c) Joerg-R. Hill, December 2000 *
* *
********************************************************************************
*-->
<!--Converted with LaTeX2HTML 99.2beta8 (1.46)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Installation</TITLE>
<META NAME="description" CONTENT="Installation">
<META NAME="keywords" CONTENT="viewmol">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="LaTeX2HTML v99.2beta8">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="viewmol.css">
</HEAD>
<BODY LANG="EN" BGCOLOR="#FFFFFF">
<H1>
<BR>
Installation
</H1>
<A NAME="installation">
V<SMALL>IEWMOL</SMALL> 2.3 was developed on a Pentium notebook running Linux using Brian
Paul's OpenGL compatible library Mesa. It also compiles with OpenGL<SUP>TM</SUP>
without any problems. V<SMALL>IEWMOL</SMALL> has been ported to Silicon Graphics
computers, IBM RS/6000, DEC Alpha, Suns, and Hewlett Packard 9000/735. Since Mesa
runs on any machine which has X windows it should be possible to run
V<SMALL>IEWMOL</SMALL> on any machine which supports X windows. However, for best
performance a native OpenGL implementation is recommended. V<SMALL>IEWMOL</SMALL> does
not run on Windows PC or MacOS Macs. For use on PCs or PowerMacs Linux is
required and highly recommended.
<P>
The following operating systems are presently supported:
<UL>
<LI>PC: Linux 2.2.x (tested only with Mesa)
</LI>
<LI>SGI: IRIX 6.3
</LI>
<LI>DEC Alpha: OSF1 V4.0 (tested only with Mesa; courtesy of Pablo Vitoria Garcia, qibvigap@lg.ehu.es)
</LI>
</UL>
On these operating systems the program was tested. Others may also work, but
this is not certified.
Previous versions of V<SMALL>IEWMOL</SMALL> have also been tested on the following systems:
<UL>
<LI>IBM: AIX 4.1
</LI>
<LI>HP: HP-UX 9.5 (tested only with Mesa),
</LI>
<LI>Sun: SunOS (courtesy of Keith Refson, Keith.Refson@earth.ox.ac.uk)
</LI>
<LI>PC: FreeBSD (courtesy of Pedro A. M. Vazquez, vazquez@iqm.unicamp.br)
</LI>
</UL>
but since the author himself does not have access to any of these systems
testing of newer versions was not possible. It can, however, be assumed
that V<SMALL>IEWMOL</SMALL> will at least compile on these systems.
<P>
V<SMALL>IEWMOL</SMALL> 2.3 is provided precompiled for a number of architectures.
Precompiled binaries are packaged separately from source, documentation,
and examples:
<UL>
<LI>x86 Linux, dynamically linked with Motif in
<code>viewmol-2.3.bin.Linux.tgz</code> (requires glibc2 distribution like
RedHat >=5.0 or Debian >=2.0)
</LI>
<LI>SGI IRIX 6.3 in <code>viewmol-2.3.bin.IRIX.tgz</code>
</LI>
<LI>IBM RS6000 AIX 4.1 in <code>viewmol-2.3.bin.AIX.tgz</code>
</LI>
<LI>DEC Alpha OSF1 in <code>viewmol-2.3.bin.OSF1.tgz</code>
</LI>
</UL>
V<SMALL>IEWMOL</SMALL> can be downloaded from:
<UL>
<LI>SourceForge
<BR><A NAME="tex2html5"
HREF="http://viewmol.sourceforge.net/"><TT>http://viewmol.sourceforge.net/</TT></A>
</LI>
<LI>Computational Chemistry List archive (USA)
<BR><A NAME="tex2html6"
HREF="http://www.ccl.net/cca/software/SOURCES/C/viewmol/index.shtml"><TT>http://www.ccl.net/cca/software/SOURCES/C/viewmol/index.shtml</TT></A>
</LI>
</UL>
The source code and the precompiled binaries for Linux will also be
available from Metalab (formerly Sunsite, USA) or your friendly neighborhood mirror
<BR><A NAME="tex2html7"
HREF="file://metalab.unc.edu/pub/Linux/apps/graphics/visualization"><TT>file://metalab.unc.edu/pub/Linux/apps/graphics/visualization</TT></A>
<P>
Before installing V<SMALL>IEWMOL</SMALL> you need to make sure that the following
libraries are available:
<UL>
<LI>OpenGL or Mesa (libGL.so, libGLU.so or libMesaGL.so, libMesaGLU.so)
<BR>
This is probably only relevant for installations on Linux. Most Linux
distributions now include Mesa.
</LI>
<LI>Motif or Lesstif (libXm.so)
<BR>
This is probably only relevant for installations on Linux. Motif can be found
at <A NAME="tex2html8"
HREF="http://www.motifzone.org/download/"><TT>http://www.motifzone.org/download/</TT></A>.
Lesstif can be found at
<BR><A NAME="tex2html9"
HREF="http://www.lesstif.org/"><TT>http://www.lesstif.org/</TT></A>.
</LI>
<LI>Python >=1.5.2
<BR>
Linux distributions usually include Python. For other system you need to obtain
Python from <A NAME="tex2html10"
HREF="http://www.python.org/"><TT>http://www.python.org/</TT></A>
</LI>
<LI>TIFF library (libtiff.so)
<BR>
Linux distributions include this library. On Silicon Graphics this
library is installed if the <code>ifl_eoe</code> and <code>ifl_dev</code> packages
have been installed. For other systems you need to obtain and compile
this library (e. g. from sgi.com under
<A NAME="tex2html11"
HREF="ftp://sgi.com/graphics/tiff/"><TT>graphics/tiff/tiff-v3.4-tar.gz</TT></A>)
</LI>
</UL>
<P>
Installation of the program is simple. V<SMALL>IEWMOL</SMALL> comes as gzipped tar
file, <code>viewmol-2.3.src.tgz</code>. Unzip and untar it using
<code>gunzip</code>
<BR><code>viewmol-2.3.src.tgz</code> and
<code>tar -xvf viewmol-2.3.src.tar</code>. You get three subdirectories,
<code>source</code>, <code>man</code>, and <code>examples</code>, five resource
files (English, German, Russian, French, Spanish), <code>Xdefaults.*</code>, and
the configuration file <code>viewmolrc</code>. Copy all files you got into an
arbitrary directory. If you want to install precompiled binaries, download
the appropriate file for your operating system and unpack it from the same
directory you unpacked the source code. This will create a subdirectory in
the source directory which holds the binaries (the name of this directory
starts with the name of your operating system as you get it from <code>uname -s</code>
and may contain a CPU specific ending). If you run the supported operating
systems you have to set the environment variable <code>$VIEWMOLPATH</code> to point
to the directory where you unpacked V<SMALL>IEWMOL</SMALL> (the compiled-in default for
<code>VIEWMOLPATH</code> is <code>/usr/local/lib/viewmol</code>) and the installation is
complete. Otherwise you have to recompile the program (cf. p. <A HREF="node4.html#compilation"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A>).
The program uses dynamical memory allocation so that every size of a molecule
can be handled which fits the hardware limits of your workstation.
<P>
The installation directory also contains a file <code>viewmolrc</code>. You might
have a look into this file and adapt it to your needs. The format is described
at page <A HREF="node29.html#datafile"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A>. In general the defaults should work fine.
<P>
V<SMALL>IEWMOL</SMALL> uses by default English as language, but it has been written so
that other languages can easily be used<A NAME="tex2html3"
HREF="footnode.html#foot1329"><SUP>1</SUP></A>. The distribution contains files
<BR><code>Xdefaults.<language></code> which contain all the program messages, menus,
dialog boxes etc. in other languages (currently English, German, Russian, French,
and Spanish). If you want to use a different language for a system wide installation,
copy the corresponding <code>Xdefaults.<language></code> file to your applications
default directory (usually <code>/usr/lib/X11/app-defaults</code>) and rename it to
<code>Viewmol</code>. If you want to use a different language only for some users,
instruct them to configure the language through V<SMALL>IEWMOL</SMALL>'s
<code>Configuration</code> menu. V<SMALL>IEWMOL</SMALL> will run without any of the
<code>Xdefaults.<language></code> files installed. So if you are happy with English
and want to change only a few settings you don't need to install any of the
<code>Xdefaults.<language></code> files.
<P>
V<SMALL>IEWMOL</SMALL> needs a few external programs for some of its functions. Once
you have installed V<SMALL>IEWMOL</SMALL> and set <code>VIEWMOLPATH</code>, you can start
V<SMALL>IEWMOL</SMALL>, press <code>Cancel</code> in the file selection box which will appear,
and press the right mouse button in the blue V<SMALL>IEWMOL</SMALL> window. A popup
menu will appear where the last but one option is <code>Configuration ...</code>.
Choosing this option displays a dialog where you can set path names to four
external programs. These are (including their defaults)<A NAME="tex2html4"
HREF="footnode.html#foot1330"><SUP>2</SUP></A>:
<A NAME="moloch">
<PRE>
Location of Web browser: netscape %s
Location of Moloch: moloch
Location of Rayshade: rayshade
Location of display program for RLE files: xv %s
</PRE>
If these program are installed and can be found in your path V<SMALL>IEWMOL</SMALL>
will automatically display the correct path names in the dialog. The <code>%s</code>
is a placeholder for the file name and is required for programs which use
command line arguments. Once you have set these path names, choose <code>Save</code>
from the buttons in the dialog and these settings will be stored permanently
in <code>$HOME/.Xdefaults</code>.
<P>
<BR><HR>
<ADDRESS>
<A HREF="mailto:joehill@users.sourceforge.net"><I>Jrg-Rdiger Hill</I></A><BR>Sun Dec 10 17:38:35 MET 2000
</ADDRESS>
</BODY>
</HTML>
|
