git.iko.soy/urbit.org
on master help sign in
instructions for Arch, AWS work
42dfc0aBernardoDeLaPlaz
docs/using/install.md+94−28
compare with master
unifiedsplit
@@ -85,7 +85,7 @@ urbit
85
85
86```
86```
87# Bash
87# Bash
88−
88+
89sudo port selfupdate
89sudo port selfupdate
90sudo port install autoconf automake cmake gmp libsigsegv meson openssl
90sudo port install autoconf automake cmake gmp libsigsegv meson openssl
91git clone https://github.com/urbit/urbit
91git clone https://github.com/urbit/urbit
@@ -111,19 +111,50 @@ git clone https://github.com/urbit/urbit
111cd urbit
111cd urbit
112./scripts/bootstrap
112./scripts/bootstrap
113./scripts/build
113./scripts/build
114−sudo env "PATH=$PATH" ninja -C ./build/ meson-install
114+sudo env "PATH=$PATH" ninja -C ./build/ install
115urbit
115urbit
116```
116```
117
117
118+N.B. if the step `./scripts/build` fails when attempting to
119+build libh2o, it could be caused by a bug in version 0.46 of meson (the bug
120+is not present in 0.45 and is fixed in 0.47).
121+
122+If the command `meson -v` returns a version starting with 0.46, try these steps:
123+
124+
125+```
126+brew uninstall meson
127+pip install meson=0.47.0
128+rm -rf build
129+build/scripts
130+```
131+
132+If that is successful, resume the above instructions after the `build` step.
133+
134+
135+
118##### Ubuntu or Debian
136##### Ubuntu or Debian
119
137
120```
138```
121# Bash
139# Bash
122
140
123sudo apt-get update
141sudo apt-get update
124−sudo apt-get install autoconf automake cmake exuberant-ctags g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev libtool make ninja-build openssl pkg-config python python3 python3-pip ragel re2c zlib1g-dev
142+sudo apt-get install autoconf automake cmake exuberant-ctags g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev libtool make openssl pkg-config python python3 python3-pip ragel re2c zlib1g-dev
125sudo -H pip3 install --upgrade pip
143sudo -H pip3 install --upgrade pip
126−sudo -H pip3 install meson
144+sudo -H pip3 install meson==0.29
145+
146+# we need ninja 1.5.1
147+# 'apt-get install ninja-build' gives us 0.1.3
148+# 'apt-get install ninja-build' gives us 1.3.4
149+#
150+git clone git://github.com/ninja-build/ninja.git
151+pushd ninja
152+ git checkout release
153+ ./configure.py --bootstrap
154+ sudo cp ./ninja /usr/local/bin
155+popd
156+
157+
127git clone https://github.com/urbit/urbit
158git clone https://github.com/urbit/urbit
128cd urbit
159cd urbit
129./scripts/bootstrap
160./scripts/bootstrap
@@ -132,22 +163,14 @@ sudo ninja -C ./build/ install
132urbit
163urbit
133```
164```
134
165
135−N.B. if the step `./scripts/build` fails when attempting to
136−build libh2o, it could be caused by a bug in version 0.46 of meson (the bug
137−is not present in 0.45 and is fixed in 0.47).
138−
139−If the command `meson -v` returns a version starting with 0.46, try these steps:
140−
141−```
142−brew uninstall meson
143−pip install meson=0.47.0
144−rm -rf build
145−build/scripts
146−```
147−
148−If that is successful, resume the above instructions after the `build` step.
149
166
150
167
168+(tested on Google Cloud Platform
169+ * Ubuntu Trusty Linux (14.04 LTS)
170+ * Ubuntu Xenial Linux (16.04 LTS)
171+ * Debian 8 (Jessie)
172+ * Debian 9 (Stretch)
173+on 6 July 2018)
151
174
152##### Fedora / Redhat
175##### Fedora / Redhat
153
176
@@ -173,7 +196,7 @@ popd
173curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
196curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
174sudo /usr/local/bin/python3 get-pip.py
197sudo /usr/local/bin/python3 get-pip.py
175# downgrade meson to avoid dependencies that redhat can't meet
198# downgrade meson to avoid dependencies that redhat can't meet
176−sudo /usr/local/bin/pip3 install meson==0.29
199+sudo -H /usr/local/bin/pip3 install meson==0.29
177
200
178
201
179git clone git://github.com/ninja-build/ninja.git && cd ninja
202git clone git://github.com/ninja-build/ninja.git && cd ninja
@@ -185,12 +208,15 @@ git clone https://github.com/urbit/urbit
185cd urbit
208cd urbit
186./scripts/bootstrap
209./scripts/bootstrap
187./scripts/build
210./scripts/build
188−sudo /usr/local/bin/ninja -C ./build/ meson-install
211+sudo /usr/local/bin/ninja -C ./build/ install
189urbit
212urbit
190
213
191```
214```
192
215
193−(tested on Google Cloud Platform Red Hat Enterprise Linux 6.1 and 7.1 on 5 July 2018)
216+(tested on Google Cloud Platform
217+ * Red Hat Enterprise Linux 6.1
218+ * Red Hat Enterprise Linux 7.1
219+on 5 July 2018)
194
220
195
221
196##### FreeBSD
222##### FreeBSD
@@ -213,17 +239,20 @@ sudo ninja -C ./build/ meson-install
213urbit
239urbit
214```
240```
215
241
216−(tested on Google Cloud Platform FreeBSD 10.4 and 11.2 on 4 July 2018)
242+(tested on Google Cloud Platform
243+ * FreeBSD 10.4
244+ * FreeBSD 11.2
245+on 4 July 2018)
217
246
218##### Arch
247##### Arch
219
248
220```
249```
221# Bash
250# Bash
222
251
223−pacman -Syu
252+sudo pacman -Syu
224−pacman -S autoconf automake cmake curl gcc git gmp libsigsegv libtool ncurses ninja openssl python ragel re2c
253+sudo pacman -S autoconf automake cmake curl gcc git gmp libsigsegv libtool ncurses ninja openssl python ragel re2c
225−sudo -H pip3 install --upgrade pip
254+curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
226−sudo -H pip3 install meson
255+sudo python3 get-pip.py
227git clone https://github.com/urbit/urbit
256git clone https://github.com/urbit/urbit
228cd urbit
257cd urbit
229./scripts/bootstrap
258./scripts/bootstrap
@@ -232,21 +261,58 @@ sudo ninja -C ./build/ meson-install
232urbit
261urbit
233```
262```
234
263
264+(tested on Amazon EC2 using Amazon Machine Image
265+ * Release 2018.06.15 / ebs hvm x86_64 lts ( ami-a40a47db via https://www.uplinklabs.net/projects/arch-linux-on-ec2/ )
266+on 6 July 2018)
267+
268+
269+
235##### AWS
270##### AWS
236
271
237```
272```
238# Bash
273# Bash
239
274
240sudo yum update
275sudo yum update
241−sudo yum install --enablerepo epel autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool meson ncurses-devel openssl-devel pkgconfig python re2c
276+sudo yum install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool ncurses-devel openssl openssl-devel pkgconfig python2 python3 python3-pip ragel re2c wget git
277+sudo env "PATH=$PATH" pip3 install --upgrade pip
278+sudo env "PATH=$PATH" pip3 install meson
279+
280+
281+# we need libsigsegv
282+#
283+
284+wget http://dl.fedoraproject.org/pub/fedora/linux/releases/25/Everything/x86_64/os/Packages/l/libsigsegv-2.10-10.fc24.x86_64.rpm
285+wget http://dl.fedoraproject.org/pub/fedora/linux/releases/25/Everything/x86_64/os/Packages/l/libsigsegv-devel-2.10-10.fc24.x86_64.rpm
286+sudo yum localinstall libsigsegv-2.10-10.fc24.x86_64.rpm
287+sudo yum localinstall libsigsegv-devel-2.10-10.fc24.x86_64.rpm
288+
289+# we need re2c
290+#
291+wget https://rpmfind.net/linux/dag/redhat/el6/en/x86_64/dag/RPMS/re2c-0.13.5-1.el6.rf.x86_64.rpm
292+sudo yum localinstall re2c-0.13.5-1.el6.rf.x86_64.rpm
293+
294+git clone git://github.com/ninja-build/ninja.git
295+pushd ninja
296+ git checkout release
297+ ./configure.py --bootstrap
298+ sudo cp ./ninja /usr/local/bin
299+popd
300+
301+
242git clone https://github.com/urbit/urbit
302git clone https://github.com/urbit/urbit
243cd urbit
303cd urbit
244./scripts/bootstrap
304./scripts/bootstrap
245./scripts/build
305./scripts/build
246−sudo ninja -C ./build/ meson-install
306+sudo env "PATH=$PATH" ninja -C ./build/ install
307+
247urbit
308urbit
248```
309```
249
310
311+(tested on Amazon EC2 using Amazon Machine Image
312+ * Amazon Linux 2 AMI (HVM), SSD Volume Type - ami-b70554c8
313+on 6 July 2018)
314+
315+
250### Test for successful installation
316### Test for successful installation
251
317
252After running your installed `urbit` command, check to see if the following output was printed:
318After running your installed `urbit` command, check to see if the following output was printed: