diff --git a/content/docs/en/resources/archive/download-guide.mdx b/content/docs/en/resources/archive/download-guide.mdx index a0a5610c2..ac6cf09a5 100644 --- a/content/docs/en/resources/archive/download-guide.mdx +++ b/content/docs/en/resources/archive/download-guide.mdx @@ -16,6 +16,17 @@ Before downloading, ensure you have sufficient: ## Download methods +:::callout +type: warn +### Archive Format Update: .tar.gz → .tar.zst +We are transitioning all Hiro archive downloads from gzip (.tar.gz) to the more efficient Zstandard (.tar.zst) format. Going forward, newly published archives will use the .zst extension. Older backups will continue to be available in .tar.gz. + +**What this means for you:** +- Update any scripts or automation to download `*.tar.zst` instead of `*.tar.gz`. +- Extracting `.zst` archives requires zstd support (e.g., `tar -I zstd -xvf archive.tar.zst`). +- `.tar.gz` examples are still provided below for backward compatibility. +::: + ### Method 1: wget with resume (Recommended for most users) The `wget` command with the `-c` flag enables resuming interrupted downloads: @@ -27,8 +38,8 @@ You may need to install wget first: `brew install wget`. Alternatively, use the ::: ```terminal -$ wget -c https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz -$ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz +$ wget -c https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst +$ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst ``` **Advantages:** @@ -44,11 +55,16 @@ $ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-b Use `curl` with automatic retries for robust downloads. The `--continue-at -` flag resumes partial downloads, while `--output` specifies the filename: +:::callout +### Archive format update +This example uses `.tar.zst` for the new format. For all new backups, use `.zst`. For older backups, replace `.zst` with `.gz` and use `--output file.tar.gz`. +::: + ```terminal $ curl --continue-at - --retry 10 --retry-delay 5 --retry-max-time 0 \ --progress-bar \ - --output mainnet-stacks-blockchain-latest.tar.gz \ - https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz + --output mainnet-stacks-blockchain-latest.tar.zst \ + https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst ``` **Advantages:** @@ -62,14 +78,24 @@ Google Cloud CLI provides the fastest download speeds with parallel transfers. F #### Download file to current directory +:::callout +type: warn +### Legacy archive format +Most new archives are published in `.tar.zst`. Use `.tar.gz` only when accessing older snapshots. +::: + ```terminal -$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz . +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst . ``` -#### OR stream directly to extraction (saves disk space but slower due to sequential download) +#### OR stream directly to extraction (saves disk space but slower due to sequential download, zst extension requires zstd installed) ```terminal -$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz - | tar -xz +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst - | tar -I zstd -xv +``` +Or for older backups with the tar.gz extention: +```terminal +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz - | tar -zxv ``` **Advantages:** @@ -112,11 +138,28 @@ SHA256 checksum files are available for **all archives** to verify download inte ``` 2. **Verify the download:** + + :::callout + ### Legacy checksum + Checksum verification for `.tar.gz` is provided for users downloading older backups. Use the `.zst` checksum example for all current and future archives. + ::: + ```terminal - $ echo "$(cat mainnet-stacks-blockchain-latest.sha256 | awk '{print $1}') mainnet-stacks-blockchain-latest.tar.gz" | shasum -a 256 -c + $ echo "$(cat mainnet-stacks-blockchain-latest.sha256 | awk '{print $1}') mainnet-stacks-blockchain-latest.tar.zst" | shasum -a 256 -c ``` -3. **Extract the archive:** +3. **Extract the archive (requires zstd-tool to be installed):** + + :::callout + type: tip + ### Using older backups? + If you are working with a legacy `.tar.gz` archive, use the extraction command below. All new archives are distributed as `.tar.zst`, which requires zstd support (`tar -I zstd`). + ::: + + ```terminal + $ tar -I zstd -xvf mainnet-stacks-blockchain-latest.tar.zst + ``` + Or for older backups with the tar.gz extention: ```terminal $ tar -zxvf mainnet-stacks-blockchain-latest.tar.gz -C /target/directory ``` diff --git a/content/docs/es/resources/archive/download-guide.mdx b/content/docs/es/resources/archive/download-guide.mdx index a926bdca5..786d125d0 100644 --- a/content/docs/es/resources/archive/download-guide.mdx +++ b/content/docs/es/resources/archive/download-guide.mdx @@ -1,12 +1,12 @@ --- title: Cómo descargar archivos de Hiro -description: Guía completa para descargar archivos de archivo grandes de manera confiable con consejos de resolución de problemas. +description: Guía completa para descargar archivos grandes de forma confiable con consejos de solución de problemas. --- ## Descripción general -Los archivos Hiro Archive son conjuntos de datos grandes (que van desde varios GB a varios *cien* GB) alojados en Google Cloud Storage. Debido a su tamaño, las descargas pueden verse interrumpidas por problemas de red, límites de velocidad o tiempos de espera de conexión. Esta guía proporciona múltiples métodos de descarga y soluciones de resolución de problemas. +Los archivos de Hiro Archive son conjuntos de datos grandes (que van desde varios GB hasta varios *cien* GB) alojados en Google Cloud Storage. Debido a su tamaño, las descargas pueden interrumpirse por problemas de red, límites de velocidad o tiempos de espera de conexión. Esta guía proporciona múltiples métodos de descarga y soluciones de resolución de problemas. -## Tamaños de archivos y requisitos +## Tamaños de archivo y requisitos Antes de descargar, asegúrate de tener suficiente: @@ -16,6 +16,20 @@ Antes de descargar, asegúrate de tener suficiente: ## Métodos de descarga +:::callout +type: warn + +### Actualización del Formato de Archivo: .tar.gz → .tar.zst + +Estamos haciendo la transición de todas las descargas de archivos de Hiro de gzip (.tar.gz) al formato más eficiente Zstandard (.tar.zst). En adelante, los archivos recién publicados usarán la extensión .zst. Las copias de seguridad más antiguas seguirán estando disponibles en .tar.gz. + +**Lo que esto significa para ti:** + +* Actualiza cualquier script o automatización para descargar `*.tar.zst` en lugar de `*.tar.gz`. +* Extrayendo `.zst` archivos requiere soporte de zstd (por ejemplo, `tar -I zstd -xvf archive.tar.zst`). +* `.tar.gz` los ejemplos aún se proporcionan a continuación para compatibilidad con versiones anteriores. +::: + ### Método 1: wget con reanudación (Recomendado para la mayoría de usuarios) El `wget` comando con el `-c` flag permite reanudar descargas interrumpidas: @@ -25,19 +39,19 @@ type: info ### Usuarios de macOS -Es posible que necesites instalar wget primero: `brew install wget`. Alternativamente, usa el método curl a continuación que está preinstalado en macOS. +Puede que necesites instalar wget primero: `brew install wget`. Alternativamente, usa el método curl a continuación que está preinstalado en macOS. ::: ```terminal -$ wget -c https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz -$ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz +$ wget -c https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst +$ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst ``` **Ventajas:** * Reanuda descargas interrumpidas automáticamente * Integrado en la mayoría de sistemas Unix -* Fácil de usar +* Simple de usar **Desventajas:** @@ -46,13 +60,19 @@ $ wget -c --progress=bar:force:noscroll https://archive.hiro.so/mainnet/stacks-b ### Método 2: curl con reintentos -Usar `curl` con reintentos automáticos para descargas robustas. El `--continue-at -` flag reanuda descargas parciales, mientras `--output` especifica el nombre del archivo: +Usar `curl` con reintentos automáticos para descargas robustas. La `--continue-at -` flag reanuda descargas parciales, mientras `--output` especifica el nombre del archivo: + +:::callout +### Actualización del formato de archivo + +Este ejemplo utiliza `.tar.zst` para el nuevo formato. Para todas las copias de seguridad nuevas, usa `.zst`. Para respaldos más antiguos, reemplaza `.zst` con `.gz` y usar `--output file.tar.gz`. +::: ```terminal $ curl --continue-at - --retry 10 --retry-delay 5 --retry-max-time 0 \ --progress-bar \ - --output mainnet-stacks-blockchain-latest.tar.gz \ - https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz + --output mainnet-stacks-blockchain-latest.tar.zst \ + https://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst ``` **Ventajas:** @@ -63,18 +83,32 @@ $ curl --continue-at - --retry 10 --retry-delay 5 --retry-max-time 0 \ ### Método 3: gcloud storage cp (Más rápido, requiere autenticación) -Google Cloud CLI proporciona las velocidades de descarga más rápidas con transferencias paralelas. Primero autentica con `gcloud auth login`, entonces descarga el archivo al disco o transmite directamente a la extracción: +Google Cloud CLI proporciona las velocidades de descarga más rápidas con transferencias paralelas. Primero autentica con `gcloud auth login`, luego descarga el archivo al disco o transmite directamente a la extracción: #### Descargar archivo al directorio actual +:::callout +type: warn + +### Formato de archivo heredado + +La mayoría de los nuevos archivos se publican en `.tar.zst`. Usar `.tar.gz` solo al acceder a instantáneas más antiguas. +::: + ```terminal -$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz . +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst . ``` -#### O transmitir directamente a la extracción (ahorra espacio en disco pero es más lento debido a la descarga secuencial) +#### O transmitir directamente a la extracción (ahorra espacio en disco pero es más lento debido a la descarga secuencial, la extensión zst requiere zstd instalado) ```terminal -$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz - | tar -xz +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.zst - | tar -I zstd -xv +``` + +O para copias de seguridad más antiguas con la extensión tar.gz: + +```terminal +$ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stacks-blockchain-latest.tar.gz - | tar -zxv ``` **Ventajas:** @@ -87,15 +121,15 @@ $ gcloud storage cp gs://archive.hiro.so/mainnet/stacks-blockchain/mainnet-stack **Desventajas:** * Requiere autenticación de cuenta de Google -* Instalación de software adicional necesaria +* Se necesita instalación de software adicional ### Método 4: Gestores de descarga (JDownloader) -Para usuarios que prefieren aplicaciones con interfaz gráfica o necesitan gestión avanzada de descargas: +Para usuarios que prefieren aplicaciones GUI o necesitan gestión avanzada de descargas: 1. Descargar e instalar [JDownloader](https://jdownloader.org/download/index) 2. Copia la URL del archivo en JDownloader -3. Configurar conexiones paralelas para descargas más rápidas +3. Configura conexiones paralelas para descargas más rápidas **Ventajas:** @@ -122,11 +156,33 @@ SHA256 checksum files are available for **todos los archivos** para verificar la ``` 2. **Verifica la descarga:** + + :::callout + ### Suma de verificación heredada + + Verificación de suma de comprobación para `.tar.gz` se proporciona para usuarios que descargan copias de seguridad más antiguas. Utiliza el `.zst` ejemplo de suma de verificación para todos los archivos actuales y futuros. + ::: + ```terminal - $ echo "$(cat mainnet-stacks-blockchain-latest.sha256 | awk '{print $1}') mainnet-stacks-blockchain-latest.tar.gz" | shasum -a 256 -c + $ echo "$(cat mainnet-stacks-blockchain-latest.sha256 | awk '{print $1}') mainnet-stacks-blockchain-latest.tar.zst" | shasum -a 256 -c ``` -3. **Extrae el archivo:** +3. **Extrae el archivo (requiere que zstd-tool esté instalado):** + + :::callout + type: tip + + ### ¿Usando copias de seguridad más antiguas? + + Si estás trabajando con un sistema heredado `.tar.gz` archivo, use el comando de extracción a continuación. Todos los archivos nuevos se distribuyen como `.tar.zst`, que requiere soporte de zstd (`tar -I zstd`). + ::: + + ```terminal + $ tar -I zstd -xvf mainnet-stacks-blockchain-latest.tar.zst + ``` + + O para respaldos más antiguos con la extensión tar.gz: + ```terminal $ tar -zxvf mainnet-stacks-blockchain-latest.tar.gz -C /target/directory ``` @@ -136,33 +192,33 @@ type: info ### Extracción de archivos grandes -El `marf.sqlite.blobs` el archivo puede ser muy grande y puede tomar un tiempo considerable para extraer. Asegúrese de tener suficiente espacio en disco y sea paciente durante la extracción. +The `marf.sqlite.blobs` El archivo puede ser muy grande y puede tomar un tiempo considerable para extraer. Asegúrese de tener suficiente espacio en disco y sea paciente durante la extracción. ::: ## Consejos de rendimiento 1. **Usa gcloud para descargas más rápidas** - requiere autenticación pero proporciona mejoras significativas de velocidad 2. **Descargar durante las horas de menor actividad** - típicamente tarde en la noche o temprano en la mañana -3. **Usar conexiones por cable** - evita el Wi-Fi para descargas grandes cuando sea posible +3. **Usar conexiones por cable** - evita Wi-Fi para descargas grandes cuando sea posible 4. **Monitorear espacio en disco** - los archivos extraídos pueden ser 2-3x más grandes que los archivos comprimidos 5. **Considera la extracción por streaming** con gcloud para ahorrar espacio en disco -## Preguntas Frecuentes +## FAQ ¿Por qué siguen fallando las descargas? - Las descargas de archivos grandes desde el almacenamiento en la nube pueden interrumpirse debido a problemas de red, limitación de velocidad o tiempos de espera de conexión. Utiliza herramientas con capacidad de reanudación como `wget -c` o `gcloud storage cp`. + Las descargas de archivos grandes desde el almacenamiento en la nube pueden ser interrumpidas debido a problemas de red, limitación de velocidad o tiempos de espera de conexión. Use herramientas capaces de reanudar como `wget -c` o `gcloud storage cp`. - ¿Qué método de descarga debo usar? + ¿Qué método de descarga debería usar? - Para obtener las velocidades más rápidas, usa `gcloud storage cp` (requiere autenticación de Google). Para simplificar, use `wget -c`. Para mayor confiabilidad sin autenticación, prueba un gestor de descargas como JDownloader. + Para velocidades más rápidas, usa `gcloud storage cp` (requiere autenticación de Google). Por simplicidad, usa `wget -c`. Para mayor confiabilidad sin autenticación, prueba un gestor de descargas como JDownloader. @@ -170,11 +226,11 @@ El `marf.sqlite.blobs` el archivo puede ser muy grande y puede tomar un tiempo c ¿Cuánto tiempo debería tomar una descarga? - El tiempo de descarga varía según el tamaño del archivo y la velocidad de conexión. El archivo de blockchain de mainnet (varios cientos de GB+) puede tomar de 6 a 24+ horas en conexiones de banda ancha típicas. + El tiempo de descarga varía según el tamaño del archivo y la velocidad de conexión. El archivo de la cadena de bloques de la red principal (varios cientos de GB+) puede tomar de 6 a 24+ horas en conexiones de banda ancha típicas. - + ¿Puedo reanudar una descarga fallida? diff --git a/content/docs/es/resources/archive/stacks-api.mdx b/content/docs/es/resources/archive/stacks-api.mdx index 83b12bf2d..3c3c3e60c 100644 --- a/content/docs/es/resources/archive/stacks-api.mdx +++ b/content/docs/es/resources/archive/stacks-api.mdx @@ -1,38 +1,46 @@ --- -title: Usar el archivo de la API de la cadena de bloques de Stacks -description: Descubre cómo utilizar el Hiro Archive para poner en marcha una API de Stacks Blockchain. +title: Usar el archivo de la API de Blockchain de Stacks +description: Descubre cómo usar el Hiro Archive para poner en marcha una API de Stacks Blockchain. --- -## Requisitos previos +## Prerrequisitos -Dado que la API de Stacks Blockchain depende de que un nodo de la cadena de bloques Stacks esté a la misma altura de bloque, primero deberá [restaurar un nodo de blockchain de Stacks utilizando el Archivo Hiro](/resources/archive/stacks-blockchain) antes de restaurar la API de Stacks Blockchain. De lo contrario, puede encontrar errores al ejecutar la API. +Dado que la API de Stacks Blockchain depende de que un nodo de blockchain de Stacks esté en la misma altura de bloque, primero necesitarás [restaurar un nodo de blockchain de Stacks usando el Archivo de Hiro](/resources/archive/stacks-blockchain) antes de restaurar la API de Stacks Blockchain. De lo contrario, puedes encontrar errores al ejecutar la API. -Para que los archivos de la cadena de bloques Stacks y la API de la cadena de bloques Stacks sean compatibles, deben cumplir los siguientes criterios: +Para que la blockchain de Stacks y los archivos de la API de la Blockchain de Stacks sean compatibles, deben cumplir con los siguientes criterios: * Ambos archivos corresponden a la misma red de Stacks (mainnet/testnet). -* La versión del archivo API debe ser compatible con la versión del archivo de la cadena de bloques Stacks (Ver [Notas de la versión de la API](https://github.com/hirosystems/stacks-blockchain-api/releases) para orientación). +* La versión del archivo API debe ser compatible con la versión del archivo de la blockchain Stacks (Ver [Notas de versión de API](https://github.com/hirosystems/stacks-blockchain-api/releases) para orientación). * Ambos archivos fueron creados en la misma fecha. ## Métodos de restauración -Hay dos formas de restaurar una API de Stacks Blockchain utilizando el Archivo Hiro. El archivo que necesitará descargar dependerá de su método de restauración. No existe ningún escenario en el que necesite ambos métodos de restauración. +Hay dos maneras de restaurar una API de Blockchain de Stacks usando el Archivo Hiro. El archivo de archivo que necesitarás descargar dependerá de tu método de restauración. No hay ningún escenario donde necesitarías ambos métodos de restauración. **Restaurar mediante volcado de base de datos Postgres (Recomendado)** -Este es el método más rápido y directo, y es adecuado para la mayoría de los escenarios. Consiste en una copia de seguridad de la base de datos Postgres de la API tomada utilizando `pg_dump`Por lo general, recomendamos comenzar con este método antes de intentar el método siguiente si este no funciona por alguna razón. +Este es el método más rápido y directo, y es adecuado para la mayoría de escenarios. Consiste en una copia de seguridad de la base de datos Postgres de la API tomada usando `pg_dump`. Generalmente recomendamos comenzar con este método antes de intentar el método a continuación si este no funciona por alguna razón. + +:::callout +type: info + +### Esquema de Postgres + +Necesitarás configurar la API `PG_SCHEMA` variable de entorno a: `PG_SCHEMA=stacks_blockchain_api` al restaurar desde un archivo. +::: **Restaurar mediante archivo de valores separados por tabulaciones (TSV)** -Este método es varias veces más lento que la restauración desde un volcado de Postgres. El archivo TSV de la API contiene los eventos sin procesar en bruto de un nodo de la cadena de bloques de Stacks. La API puede ingerir este archivo para procesar eventos en una base de datos Postgres. -La restauración desde un archivo TSV puede ser útil cuando no está disponible un archivo de base de datos Postgres para una versión particular de la API o cuando no se puede utilizar por cualquier motivo. +Este método es varias veces más lento que restaurar desde un volcado de Postgres. El archivo TSV de la API contiene los eventos sin procesar en bruto de un nodo de blockchain de Stacks. La API puede ingerir este archivo para procesar eventos en una base de datos Postgres. +Restaurar desde un archivo TSV puede ser útil cuando un archivo de base de datos Postgres para una versión particular de API no está disponible o cuando no se puede usar por alguna razón. ## Dónde descargar archivos -Dependiendo del método de restauración utilizado anteriormente, los archivos del Stacks Blockchain API para cada red se pueden encontrar en las siguientes ubicaciones: +Dependiendo del método de restauración utilizado anteriormente, los archivos de la API de Stacks Blockchain para cada red se pueden encontrar en las siguientes ubicaciones: * Volcado de base de datos Postgres * mainnet: https://archive.hiro.so/mainnet/stacks-blockchain-api-pg/ * testnet: https://archive.hiro.so/testnet/stacks-blockchain-api-pg/ -* Archivo TSV +* archivo TSV * mainnet: https://archive.hiro.so/mainnet/stacks-blockchain-api/ * testnet: https://archive.hiro.so/testnet/stacks-blockchain-api/ @@ -41,54 +49,54 @@ Los patrones de nombres de archivo son los siguientes: * Volcado de base de datos Postgres * archivo: `stacks-blockchain-api-pg---.dump` * shasum: `stacks-blockchain-api-pg---.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api--.gz` * shasum: `-stacks-blockchain-api--.sha256` -Existe un archivo y un shasum que se actualizan continuamente y siempre apuntan a la carga más reciente: +Hay un archivo continuamente actualizado y shasum que siempre apunta a la carga más reciente: * Volcado de base de datos Postgres * archivo: `stacks-blockchain-api-pg--latest.dump` * shasum: `stacks-blockchain-api-pg--latest.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api-latest.gz` * shasum: `-stacks-blockchain-api-latest.sha256` -o la carga más reciente para una versión en particular: +o la carga más reciente para una versión particular: * Volcado de base de datos Postgres * archivo: `stacks-blockchain-api-pg---latest.dump` * shasum: `stacks-blockchain-api-pg---latest.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api--latest.gz` * shasum: `-stacks-blockchain-api--latest.sha256` -## Restaurando la API de la cadena de bloques de Stacks utilizando el archivo de Hiro +## Restaurando la API de Blockchain de Stacks usando el Archivo de Hiro -**Si se restaura mediante un volcado de Postgres** +**Si se restaura mediante volcado de Postgres** -1. Descargue el archivo y el shasum para la red y el método de restauración apropiados. -2. Verifique el archivo usando los pasos en el [descargar guía](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). -3. Importe el archivo de archivo en una base de datos Postgres en ejecución (puede tardar hasta una hora dependiendo de las especificaciones y la configuración de la base de datos): +1. Descarga el archivo y shasum para la red apropiada y método de restauración. +2. Verifica el archivo usando los pasos en el [guía de descarga](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). +3. Importa el archivo de archivo en una base de datos Postgres en ejecución (puede tomar hasta una hora dependiendo de las especificaciones y configuración de la base de datos): ```terminal $ export PGPASSWORD= $ pg_restore --username postgres --verbose --jobs 4 --dbname stacks_blockchain_api /path/to/archive/file ``` -4. Inicie el servicio de API de Stacks Blockchain. -5. Verifique que el conjunto de datos se esté utilizando comparando sus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [De Hiro](https://api.hiro.so/extended/v1/status)Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. - 1. Es posible que el nodo local tarde unos minutos en responder en este punto final. - 2. Es posible que la altura de su bloque esté hasta unos cientos de bloques alejada de la de Hiro, dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. +4. Lanza el servicio de API de Blockchain de Stacks. +5. Verificar que el conjunto de datos esté siendo utilizado comparando sus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [Hiro's](https://api.hiro.so/extended/v1/status). Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. + 1. Puede tomar unos minutos para que el nodo local responda en este endpoint. + 2. La altura de tu bloque puede estar hasta unos cientos de bloques de distancia del de Hiro dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. **Si se restaura mediante archivo TSV** -1. Descargue el archivo y el shasum para la red y el método de restauración apropiados. -2. Verifique el archivo usando los pasos en el [descargar guía](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). -3. Extraiga el archivo en el directorio deseado: +1. Descarga el archivo y el shasum para la red apropiada y el método de restauración. +2. Verificar el archivo usando los pasos en el [guía de descarga](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). +3. Extrae el archivo en el directorio deseado: ```terminal $ gzip -d --stdout > /path/to/extracted/file ``` -4. [Siga estas instrucciones](https://github.com/hirosystems/stacks-blockchain-api#export-and-import) para procesar e importar los eventos del archivo TSV en su base de datos Postgres. -5. Inicie el servicio de API de Stacks Blockchain. -6. Verifique que el conjunto de datos se esté utilizando comparando sus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [De Hiro](https://api.hiro.so/extended/v1/status)Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. - 1. Es posible que el nodo local tarde unos minutos en responder en este punto final. - 2. Es posible que la altura de su bloque esté hasta unos cientos de bloques alejada de la de Hiro, dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. +4. [Sigue estas instrucciones](https://github.com/hirosystems/stacks-blockchain-api#export-and-import) procesar e importar los eventos del archivo TSV en tu base de datos Postgres. +5. Lanzar el servicio de API de Stacks Blockchain. +6. Verifica que el conjunto de datos esté siendo utilizado comparando tus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [Hiro's](https://api.hiro.so/extended/v1/status). Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. + 1. Puede tomar unos minutos para que el nodo local responda en este endpoint. + 2. La altura de tu bloque puede estar hasta unos cientos de bloques por detrás de la de Hiro dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. diff --git a/idioma.lock b/idioma.lock index 39b4aff84..9f69585c5 100644 --- a/idioma.lock +++ b/idioma.lock @@ -77,7 +77,7 @@ files: translations: es: true content/docs/en/resources/archive/stacks-api.mdx: - content: e6d8c822db7123a05d4673d4d560fdce + content: 2c7621f4c633e56a189da951687de5ae translations: es: true content/docs/en/resources/archive/index.mdx: @@ -1169,7 +1169,7 @@ files: translations: es: true content/docs/en/resources/archive/download-guide.mdx: - content: 830654f26dc77cad2d5a56a7ba9aa849 + content: f72efc6a4505048cbf1c7aa179d67ad3 translations: es: true content/docs/en/tools/chainhooks/index.mdx: