tinstallation.html - vaccinewars - be a doctor and try to vaccinate the world
(HTM) git clone git://src.adamsgaard.dk/vaccinewars
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
tinstallation.html (6378B)
---
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
4 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
5
6 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
7
8 <head>
9 <title>Obtaining and installing dopewars</title>
10 <meta charset="utf-8"/>
11 </head>
12
13 <body>
14 <h1>Obtaining and installing dopewars</h1>
15
16 <p>The dopewars source code and precompiled binaries (in RPM format) are
17 available from the main dopewars web page,
18 at <a href="https://dopewars.sourceforge.io/">
19 https://dopewars.sourceforge.io/</a>. Just follow the link from
20 there to the download section. "rpm" is the RedHat Package Manager, a program
21 for simplifying installation and upgrade of programs, and is part of the
22 RedHat Linux distribution. If you are using a different distribution, it
23 may be still be included, however. If you do not want to use "rpm", or the
24 installation fails, then you can obtain the source code tarball and recompile
25 the code from scratch.</p>
26
27 <p><b>Prerequisites:</b> dopewars relies on the GLib library for all builds;
28 this library is used for parsing the configuration files, network and string
29 handling, and many other purposes. On a Windows system, this is the only
30 prequisite; the standard Windows libraries are used for everything else. On a
31 Unix/Linux system, you will also need the screen library curses (or the
32 equivalent, such as ncurses or cur_colr) for the text-mode client, and the
33 <a href="http://www.gtk.org/">GTK+</a> libraries for the graphical client.</p>
34
35 <ul>
36 <li><a href="#win32">Windows installation</a></li>
37 <li><a href="#rpmbinary">RPM binary installation</a></li>
38 <li><a href="#rpmsource">RPM source installation</a></li>
39 <li><a href="#tarball">Tarball installation</a></li>
40 </ul>
41
42 <h2><a id="win32">Windows installation</a></h2>
43 <p>The easiest way to install the Windows version is to download the Windows
44 installer program from the
45 <a href="https://dopewars.sourceforge.io/download.html">download page</a>, and
46 run it (either instruct your web browser to "run from the current location",
47 or save it to somewhere obvious like the Desktop and then double-click on its
48 icon later). This should install all relevant files, and set up Start Menu
49 icons, etc. If, however, you wish to build the program from the source code,
50 see the <a href="#tarball">tarball installation</a> section below, and also
51 see the <a href="windows.html">Windows page</a>.</p>
52
53 <h2><a id="rpmbinary">RPM binary installation</a></h2>
54 <p>The binary RPMs are built for Intel systems running RedHat or Fedora Linux.
55 On other systems, these binary RPMs may refuse to install, or may run but then
56 crash with mysterious segmentation faults due to library conflicts.</p>
57
58 <ol>
59 <li>Download the
60 <a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.6.1-1.el7.x86_64.rpm">
61 x86_64 (64-bit Intel for RedHat Enterprise 7)</a> RPM with your web browser.</li>
62
63 <li>Become root on your Unix box (if you cannot become root, then you will
64 probably not be able to use RPM installation, depending on how "rpm" is set
65 up).</li>
66
67 <li>Change to the directory containing the dopewars rpm, and install it with
68 the command<br />
69 <tt><b>rpm -Uvh dopewars-1.6.1-1.el7.x86_64.rpm</b></tt><br /> This will replace any
70 already-installed earlier version.</li>
71 </ol>
72
73 <h2><a id="rpmsource">RPM source installation</a></h2>
74 <p>This route is open to you if your system has "rpm", but the binary RPMs do
75 not work on your system, or your machine is not an Intel (an Alpha or PowerMac,
76 for example). It involves obtaining the RPM of the source code, and then
77 building the binaries from it on your system.</p>
78
79 <ol>
80 <li>Download the
81 <a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.6.1-1.el7.src.rpm">
82 source code RPM</a>.</li>
83
84 <li>Become root and change to the directory containing the new rpm.</li>
85
86 <li>Build a binary rpm with the command<br />
87 <tt><b>rpmbuild --rebuild dopewars-1.6.1-1.el7.src.rpm</b></tt></li>
88
89 <li>Change to the directory which the binary rpm has been written to (check
90 the output of the above - usually /usr/src/redhat/RPMS/<i>xxx</i>, where
91 <i>xxx</i> is your machine type - for example, "i386" on Intel machines,
92 "alpha" on Alphas, "x86_64" on AMD64 or EM64T machines)</li>
93
94 <li>Install the binary rpm with the command<br />
95 <tt><b>rpm -Uvh dopewars-1.6.1-1.el7.<i>xxx</i>.rpm</b></tt></li>
96 </ol>
97
98 <h2><a id="tarball">Tarball installation</a></h2>
99 <p>If you don't have, or don't want to use, RPM, you can obtain the source code
100 in gzipped, tarred ("tarball") format and recompile and install it yourself.
101 This is also usually a necessity if you cannot become root (the superuser) on
102 your Unix box, or if you wish to build the Windows version from source code.</p>
103
104 <p>Before beginning, you should ensure that you have all the necessary
105 prequisites (see above). To compile on a Windows system, you will need
106 the MinGW compiler and libraries; see the
107 <a href="https://github.com/benmwebb/dopewars/tree/develop/win32">Windows-specific
108 build page</a> for more information.
109 </p>
110
111 <ol>
112 <li>Download the
113 <a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.6.1.tar.gz">
114 source code tarball</a>.</li>
115
116 <li>Change to the directory containing the tarball and extract the contents
117 with the command <br />
118 <tt><b>tar -xvzf dopewars-1.6.1.tar.gz</b></tt><br />
119 (or similar).</li>
120
121 <li>Change into the dopewars-1.6.1 directory, and read all the important
122 documentation in there ;) Most notably, the INSTALL file gives more details
123 on setup and installation.</li>
124
125 <li>Build the binary with the commands<br />
126 <tt><b>./configure</b><br />
127 <b>make</b></tt></li>
128
129 <li>Become root and install the dopewars files with<br />
130 <tt><b>make install</b></tt><br />
131 <p>The configure script will test your system and set up dopewars so that it
132 should compile cleanly. The configure script supports a number of
133 configurable options; for more details, read the INSTALL file in the
134 dopewars-1.6.1 directory.</p>
135
136 <p>If you cannot become root, run the configure script specifying directories
137 for which you have write access for the dopewars files, with a command
138 such as<br />
139 <tt><b>./configure --prefix=/home/user/dopewars</b></tt></p></li>
140 </ol>
141
142 <hr />
143 <ul>
144 <li><a href="index.html">Main index</a></li>
145 </ul>
146 <p>
147 Last update: <b>06-12-2020</b><br />
148 Valid <a href="http://validator.w3.org/check/referer">XHTML 1.1</a>
149 </p>
150 </body>
151 </html>