grin/doc/build_ES.md

116 lines
4.5 KiB
Markdown
Raw Normal View History

2018-10-09 18:55:05 +03:00
# Grin - Compilación, configuración y ejecución
## Plataformas soportadas
En un largo plazo, es probable que la mayoría de las plataformas sean compatibles en cierta medida.
El lenguaje de programación de Grin `rust` ha compilado metas para la mayoría de las plataformas.
¿Qué funciona hasta ahora?
* Linux x86\_64 y MacOS [grin + mining + development]
* Todavía no funciona con windows 10 [grin kind-of builds. No mining yet. Help wanted!]
## Requisitos
* rust 1.31+ (usa [rustup]((https://www.rustup.rs/))- por ejemplo, `curl https://sh.rustup.rs -sSf | sh; source $HOME/.cargo/env`)
2018-10-09 18:55:05 +03:00
* Si rust está instalado, puede simplemente actualizar la versión con `rustup update`
* clang
* ncurses y libs (ncurses, ncursesw5)
* zlib libs (zlib1g-dev or zlib-devel)
* pkg-config
* libssl-dev
* linux-headers (reportado como necesario en Alpine linux)
* llvm
2018-10-09 18:55:05 +03:00
Para las distribuciones basadas en Debian (Debian, Ubuntu, Mint, etc), todo en un comando (exceptuando Rust):
```sh
apt install build-essential cmake git libgit2-dev clang libncurses5-dev libncursesw5-dev zlib1g-dev pkg-config libssl-dev llvm
2018-10-09 18:55:05 +03:00
```
Para las Mac:
```sh
xcode-select --install
brew install --with-toolchain llvm
brew install pkg-config
brew install openssl
```
2018-10-09 18:55:05 +03:00
## Pasos para la compilación
```sh
git clone https://github.com/mimblewimble/grin.git
cd grin
cargo build --release
```
Grin también puede compilarse en modo debug (sin la etiqueta `--release`, pero usando la etiqueta `--debug` o `--verbose`) esto hará que la sincronización rápida sea excesivamente lenta debido a la gran sobrecarga de las operaciones criptográficas.
## Errores de compilación
Vea [Solución de problemas](https://github.com/mimblewimble/docs/wiki/Troubleshooting)
## ¿Qué se ha compilado?
Con una compilación finalizada se obtiene:
* `target/release/grin` - los binarios principales de grin
2019-01-22 16:39:29 +03:00
Todos los datos, configuración y archivos de registro creados y utilizados por Grin se encuentran en el directorio oculto `~/.grin` (bajo el directorio home del usuario) por defecto. Puede modificar toda la configuración editando el archivo `~/.grin/main/grin-server.toml`.
2018-10-09 18:55:05 +03:00
También es posible hacer que Grin cree sus propios archivos de datos en el directorio actual. Para ello ejecute:
```sh
grin server config
```
2019-01-22 16:39:29 +03:00
Lo que generará un archivo `grin-server.toml` en el directorio actual, preconfigurado para usar el directorio actual para todos sus datos. Ejecutando Grin desde un directorio que contiene el archivo `grin-server.toml` usará los valores de ese archivo en lugar de los valores por defecto de `~/.grin/main/grin-server.toml`.
2018-10-09 18:55:05 +03:00
Durante las pruebas, ponga el binario de Grin en su ruta de esta manera:
```sh
2019-01-22 16:39:29 +03:00
export PATH=/path/to/grin/dir/target/release:$PATH
2018-10-09 18:55:05 +03:00
```
Donde `path/to/grin/dir` es su ruta absoluta al directorio raíz de la instalación de Grin.
Puede ejecutar `grin` directamente (pruebe `grin help` para más opciones).
## Configuración
Grin se ejecuta con valores predeterminados, y puede configurarse aún más a través del archivo `grin-server.toml`. Este fichero es generado por grin en su primera ejecución, y contiene documentación sobre cada opción disponible.
Aunque se recomienda que realice toda la configuración de grin server a través de `grin-server.toml`, también es posible suministrar cambios de comandos para grin que anulan cualquier configuración en el archivo.
Para obtener ayuda sobre los comandos de grin y sus cambios intente:
```sh
grin help
grin wallet help
grin client help
```
## Docker
```sh
2018-11-30 18:35:24 +03:00
docker build -t grin -f etc/Dockerfile .
2018-10-09 18:55:05 +03:00
```
Puede ubicar la caché de Grin para que se ejecute dentro del contenedor
```sh
2018-11-30 19:06:27 +03:00
docker run -it -d -v $HOME/.grin:/root/.grin grin
2018-10-09 18:55:05 +03:00
```
## Compilación multiplataforma
Rust (cargo) puede compilar Grin para muchas plataformas, así que en teoría ejecutar `grin` como un nodo de validación en un dispositivo de baja potencia podría ser posible. Para hacer una compilación cruzada `grin` en una plataforma x86 Linux y generar binarios de ARM, por ejemplo para Raspberry-pi.
## Usando Grin
La página de la wiki [Cómo usar grin](https://github.com/mimblewimble/docs/wiki/How-to-use-grin) y las páginas de enlaces tienen más información sobre las características que disponemos, resolución de problemas, etc.
## Minando en Grin
Tenga en cuenta que todas las funciones de minería de Grin se han trasladado a un paquete independiente llamado [grin_minner](https://github.com/mimblewimble/grin-miner). Una vez que el nodo de grin esté listo y funcionando, puede empezar a minar compilando y ejecutando grin-miner con su nodo Grin en funcionamiento.