diff --git a/docs/run-first-validator.md b/docs/run-first-validator.md index 8429312..7b24e2b 100644 --- a/docs/run-first-validator.md +++ b/docs/run-first-validator.md @@ -138,7 +138,7 @@ - Run the following steps in machine where [the genesis file is to be generated (machine 3)](#build-laconicd-to-generate-genesis-file) -- Copy over compressed `testnet-state.zst` file to target machine +- Copy over compressed `testnet-state.zst` file in previous steps from machine 1 to machine 3 - Set envs: diff --git a/playbooks/cosmos-multisig-app/README.md b/playbooks/cosmos-multisig-app/README.md index ad3c19b..000761a 100644 --- a/playbooks/cosmos-multisig-app/README.md +++ b/playbooks/cosmos-multisig-app/README.md @@ -8,7 +8,6 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall - [ansible](../README.md#ansible-installation) - If running playbook to setup deployment on remote machine, the following need to be installed in remote: - [laconic-so](https://github.com/cerc-io/stack-orchestrator/?tab=readme-ov-file#install) - - [yq](https://github.com/mikefarah/yq?tab=readme-ov-file#wget) ## Configuration @@ -26,7 +25,6 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall * Update `~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-vars.yml` with your node configuration: ```yaml - # TODO: Update with example domains mapped to ports next_public_node_addresses: '["https://laconicd-mainnet.laconic.com"]' node_rest_endpoint: "https://api.laconicd-mainnet.laconic.com" ``` @@ -37,14 +35,20 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall ```bash # Parent directory where the deployment directory will live export DATA_DIRECTORY= + export MULTISIG_DEPLOYMENT_DIR=cosmos-multisig-deployment ``` +* Copy the inventory file: + ```bash + cp ~/cerc/laconicd-stack/playbooks/hosts.ini.example ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini + ``` + ### Local Setup * Setup and start the multisig app: ```bash - ansible-playbook -v -i hosts.ini ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-app-start.yml --limit local + ansible-playbook -v -i ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-app-start.yml --limit local ``` * Access the app at @@ -52,16 +56,14 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall ### Remote Setup * Create and configure hosts.ini: - * Copy the example file: - ```bash - cp ~/cerc/laconicd-stack/playbooks/hosts.ini.example ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini - ``` + * Edit `~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini` and update the remote host details: ```ini [remote] # Replace with your actual remote host details remote_host ansible_host=your.remote.host ansible_user=your_remote_user ansible_ssh_common_args='-o ForwardAgent=yes' ``` + * Verify SSH connection using Ansible ping: ```bash ansible all -m ping -i ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini --limit remote_host @@ -81,6 +83,38 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall laconic-so deployment --dir $DATA_DIRECTORY/$MULTISIG_DEPLOYMENT_DIR logs -f cosmos-multisig-ui ``` +## Update + +- Set environment variables for the deployment: + ```bash + # Parent directory where the deployment directory will live + export DATA_DIRECTORY= + + export MULTISIG_DEPLOYMENT_DIR=cosmos-multisig-deployment + ``` + +- Stop the deployment: + + ```bash + laconic-so deployment --dir $DATA_DIRECTORY/$MULTISIG_DEPLOYMENT_DIR stop + ``` + +- Update `~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-vars.yml` with required values + +- Run ansible playbook to deploy again: + + - For local host + + ```bash + ansible-playbook -v -i ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-app-start.yml --limit local + ``` + + - For remote host (check that remote is configured properly in `~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini`) + + ```bash + ansible-playbook -v -i ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/hosts.ini ~/cerc/laconicd-stack/playbooks/cosmos-multisig-app/cosmos-multisig-app-start.yml --limit remote_host + ``` + ## Clean up - To stop the deployment: