diff --git a/README.md b/README.md index a8f2b13f50e8ebce7a054ea1bb29769d5445de8b..6254982f2141d6a10b027fcabf1f1f022fded336 100644 --- a/README.md +++ b/README.md @@ -3,38 +3,18 @@ ## Sitio web: https://www.bfa.ar/ ## Repositorio: https://gitlab.bfa.ar/blockchain/nucleo.git -Esta guÃa deberÃa funcionar en Debian o sus derivados. Testeado en *Debian* y *Ubuntu server* sin la GUI instalada en ninguno de ellos. - -([Capturas de pantallas instalando un Ubuntu 18.04](https://gitlab.bfa.ar/blockchain/nucleo/wikis/Instalando-Ubuntu-Server-18.04)) -([Capturas de pantallas instalando un Debian 9.5](https://gitlab.bfa.ar/blockchain/nucleo/wikis/Instalando-debian-9.5)) - -1. Instalá `git` - - como root: `apt install git` -2. Cloná el repositorio oficial BFA - - `git clone https://gitlab.bfa.ar/blockchain/nucleo.git bfa` -3. Ejecutá el script de instalación. Esto cambiará algunas configuraciones en tu sistema. Si te preocupa (¿deberÃa?), podés ejecutar este escript paso a paso manualmente. - - como root: `bfa/bin/installbfa.sh` - Van a aparecer varios **warnings** mientras se instala web3. Esto parece ser "normal". Ignorarlo no parece causar problemas. -4. Cambiá al usuario `bfa` - - como root: `su - bfa` -5. Crea una cuenta - - como bfa: `admin.sh account` -6. Comenzá la sincronización. **Esto puede llevar un rato largo** (este script se ejecuta automáticamente cuando se reinicia el sistema). - - como bfa: `start.sh` -7. Monitoreá los logs con `bfalog.sh`. Apretá CTRL-C en cualquier momento para detener el `tail -f`. -8. Cambiá la configuración de tu nodo usando `admin.sh syncmode` - - Hacé esto antes de haber sincronizado mucho en el paso anterior, ya que esto podrÃa remover todos los datos de la cadena que hayas bajado y reiniciar la sincronización de la cadena. -9. Esperá a aque termine de sincronizar -10. Herramientas simples super básicas (más bien pruebas de concepto, para inspirar a los programadores): - - `explorer.sh` : Sigue el bloque más nuevo "*lastest*" por default, pero podés especificar un número de bloque cualquiera como argumento, por ejemplo `explorer.sh 0` permite ver el génesis (bloque 0). - - `walker.pl` : También toma un número de bloque para iniciar. Sigue esperando nuevos bloques. - - `sealerwatch.pl` : Mira cuando los selladores firman. - -Hay otros programas "interesantes" en los directorios `bin/` y `src/`, -pero para los desarrolladores, el branch `dev` es más intersante y tambien el -([repositorio contrib](https://gitlab.bfa.ar/blockchain/contrib)). - -**Puede tardarse alrededor de una hora conectarse la primera vez. En el log no se ve nada. Hay que tener paciencia.** +Este repositorio es un _fork_ del repositorio principal de la BFA, a los efectos de probar mecanismos alternativos de instalación y configuración. + +En particular permite usar los mismos scripts para arrancar un nodo de la red principal de la BFA que para arrancar un nodo de la red de prueba. + +Los parámetros que difieren en ambas redes (bootnodes, bloque génesis), están en el directorio `config/${BFANETWORKID}` + +Los distintos scripts trabajan con una u otra red según la versión de `env` utilizada. + +* `${BFAHOME}/bin/env` trabaja con la red principal +* `${BFAHOME}/bin/env.testnet` trabaja con la de de prueba + +## start.sh ## start.sh