mirror of
https://github.com/planetmint/planetmint.git
synced 2025-03-30 15:08:31 +00:00
4ffd8ca9df
* removed korean documentation Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * removed CN and KOR readme Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * changed to the press theme Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * first changes Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * fixe H3 vs H1 issues Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * added missing png Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * added missing file Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * fixed warnings Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * moved documents Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * removed obsolete files Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * removed obsolete folder Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * removed obs. file Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * added some final changes Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * removed obs. reference Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com>
113 lines
3.4 KiB
Markdown
113 lines
3.4 KiB
Markdown
<!---
|
|
Copyright © 2020 Interplanetary Database Association e.V.,
|
|
Planetmint and IPDB software contributors.
|
|
SPDX-License-Identifier: (Apache-2.0 AND CC-BY-4.0)
|
|
Code is Apache-2.0 and docs are CC-BY-4.0
|
|
--->
|
|
|
|
# Set Up Planetmint, MongoDB and Tendermint
|
|
|
|
We now install and configure software that must run
|
|
in every Planetmint node: Planetmint Server,
|
|
MongoDB and Tendermint.
|
|
|
|
## Install Planetmint Server
|
|
|
|
Planetmint Server requires **Python 3.9+**, so make sure your system has it.
|
|
|
|
Install the required OS-level packages:
|
|
|
|
```
|
|
# For Ubuntu 18.04:
|
|
sudo apt install -y python3-pip libssl-dev
|
|
# Ubuntu 16.04, and other Linux distros, may require other packages or more packages
|
|
```
|
|
|
|
Planetmint Server requires [gevent](http://www.gevent.org/), and to install gevent, you must use pip 19 or later (as of 2019, because gevent now uses manylinux2010 wheels). Upgrade pip to the latest version:
|
|
|
|
```
|
|
sudo pip3 install -U pip
|
|
```
|
|
|
|
Now install the latest version of Planetmint Server.
|
|
You can find the latest version by going
|
|
to the [Planetmint project release history page on PyPI](https://pypi.org/project/Planetmint/#history).
|
|
For example, to install version 2.2.2, you would do:
|
|
|
|
```
|
|
# Change 2.0.0 to the latest version as explained above:
|
|
sudo pip3 install planetmint==2.2.2
|
|
```
|
|
|
|
Check that you installed the correct version of Planetmint Server using `planetmint --version`.
|
|
|
|
## Configure Planetmint Server
|
|
|
|
To configure Planetmint Server, run:
|
|
|
|
```
|
|
planetmint configure
|
|
```
|
|
|
|
The first question is ``API Server bind? (default `localhost:9984`)``.
|
|
|
|
* If you're using NGINX (e.g. if you want HTTPS),
|
|
then accept the default value (`localhost:9984`).
|
|
* If you're not using NGINX, then enter the value `0.0.0.0:9984`
|
|
|
|
You can accept the default value for all other Planetmint config settings.
|
|
|
|
If you're using NGINX, then you should edit your Planetmint config file
|
|
(in `$HOME/.planetmint` by default) and set the following values
|
|
under `"wsserver"`:
|
|
|
|
```
|
|
"advertised_scheme": "wss",
|
|
"advertised_host": "bnode.example.com",
|
|
"advertised_port": 443
|
|
```
|
|
|
|
where `bnode.example.com` should be replaced by your node's actual subdomain.
|
|
|
|
## Install (and Start) MongoDB
|
|
|
|
Install a recent version of MongoDB.
|
|
Planetmint Server requires version 3.4 or newer.
|
|
|
|
```
|
|
sudo apt install mongodb
|
|
```
|
|
|
|
If you install MongoDB using the above command (which installs the `mongodb` package),
|
|
it also configures MongoDB, starts MongoDB (in the background),
|
|
and installs a MongoDB startup script
|
|
(so that MongoDB will be started automatically when the machine is restarted).
|
|
|
|
Note: The `mongodb` package is _not_ the official MongoDB package
|
|
from MongoDB the company. If you want to install the official MongoDB package,
|
|
please see
|
|
[the MongoDB documentation](https://docs.mongodb.com/manual/installation/).
|
|
Note that installing the official package _doesn't_ also start MongoDB.
|
|
|
|
## Install Tendermint
|
|
|
|
The version of Planetmint Server described in these docs only works well
|
|
with Tendermint 0.31.5 (not a higher version number). Install that:
|
|
|
|
```
|
|
sudo apt install -y unzip
|
|
wget https://github.com/tendermint/tendermint/releases/download/v0.31.5/tendermint_v0.31.5_linux_amd64.zip
|
|
unzip tendermint_v0.31.5_linux_amd64.zip
|
|
rm tendermint_v0.31.5_linux_amd64.zip
|
|
sudo mv tendermint /usr/local/bin
|
|
```
|
|
|
|
## Start Configuring Tendermint
|
|
|
|
You won't be able to finish configuring Tendermint until you have some information
|
|
from the other nodes in the network, but you can start by doing:
|
|
|
|
```
|
|
tendermint init
|
|
```
|