{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This guide will help you to set up and enable regular backups of your Elasticsearch index without causing downtime. Backing up Elasticsearch indices is particularly beneficial for use cases where the data on Swarm is static, like Write Once Read Many (WORM). However, it is still necessary to perform a “Refresh Search Index” operation after recovery to ensure the Elasticsearch index is fully updated and synchronized. This process is crucial because it catches up the Elasticsearch index with the latest data state.","type":"text"}]},{"type":"paragraph","content":[{"text":"For use cases with frequent updates, such as backup software like Commvault, NetBackup, Veeam et al, restoring an Elasticsearch index from backup is not suitable. After restoring a specific point-in-time of the Elasticsearch index, the backup client software may not be able to read the data beyond that time. To address this, a “Refresh Search Index” is required. This synchronizes the Elasticsearch Index with the current state of data in the storage cluster. This refresh process can take almost the same amount of time as creating a new search feed, which is why recovery of Elasticsearch from backup is less beneficial for these use cases.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Elasticsearch cluster running.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shared file system accessible by all Elasticsearch nodes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the cluster via curl or a similar HTTP client.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(Optional) Elasticsearch Curator for automating snapshots.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step-by-Step Guide","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Snapshot Repository","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You need to create a snapshot repository where the snapshots will be stored. This can be a shared file system or an S3 bucket.","type":"text"},{"type":"hardBreak"},{"text":"Using a Shared File System:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"First, specify the shared repository location in the ","type":"text"},{"text":"elasticsearch.yml","type":"text","marks":[{"type":"code"}]},{"text":" file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"path.repo: \"/mount/backups/my_backup\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Then, create the repository using the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X PUT \"http://:9200/_snapshot/my_backup\" -H 'Content-Type: application/json' -d'\n{\n \"type\": \"fs\",\n \"settings\": {\n \"location\": \"/mount/backups/my_backup\"\n }\n}'","type":"text"}]},{"type":"paragraph","content":[{"text":"Using DataCore Swarm S3 bucket:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"When the target repository is another Swarm cluster, the command to create the snapshot repository would be as follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X PUT \"http://:9200/_snapshot/my_s3_backup\" -H 'Content-Type: application/json' -d'\n{\n \"type\": \"s3\",\n \"settings\": {\n \"bucket\": \"my-elasticsearch-backup-bucket\",\n \"endpoint\": \"https://datacore-swarm.example.com\",\n \"access_key\": \"your_access_key\",\n \"secret_key\": \"your_secret_key\",\n \"protocol\": \"https\"\n }\n}'","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"Replace ‘","type":"text"},{"text":"my-elasticsearch-backup-backup","type":"text","marks":[{"type":"code"}]},{"text":"’, ‘","type":"text"},{"text":"https://datacore-swarm.example.com","type":"text","marks":[{"type":"code"}]},{"text":"’, ‘","type":"text"},{"text":"your_access_key","type":"text","marks":[{"type":"code"}]},{"text":"’, and ‘","type":"text"},{"text":"your_secret_key","type":"text","marks":[{"type":"code"}]},{"text":"’ with your actual S3 bucket name, DataCore Swarm endpoint URL, and AWS credentials.","type":"text"},{"type":"hardBreak"},{"text":"NOTE: ","type":"text","marks":[{"type":"strong"}]},{"text":"Ensure that the location path is accessible and writable by all nodes in the cluster.","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify the Repository","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"After creating the repository, verify it to ensure it is set up correctly:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X GET \"http://:9200/_snapshot/my_backup\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Snapshot","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Once the repository is set up and verified, create a snapshot of your index. Replace ","type":"text"},{"text":"index_mumbkctcomobs.datacore.com.com0","type":"text","marks":[{"type":"code"}]},{"text":" with your index name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X PUT \"http://:9200/_snapshot/my_backup/snapshot_$(date +\\%Y\\%m\\%d\\%H\\%M)\" -H 'Content-Type: application/json' -d'\n{\n \"indices\": \"index_swarm.datacore.com.com0\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false\n}'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automate Snapshot Creation","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To automate the creation of snapshots, you can use cron jobs on Linux or scheduled tasks on Windows.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example using a cron job (runs daily at 2 AM):","type":"text"}]},{"type":"codeBlock","content":[{"text":"0 2 * * * curl -X PUT \"http://:9200/_snapshot/my_backup/snapshot_$(date +\\%Y\\%m\\%d\\%H\\%M)\" -H 'Content-Type: application/json' -d'\n{\n \"indices\": \"index_swarm.datacore.com.com0\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false\n}'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Monitor Snapshots","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Regularly check the status of your snapshots to ensure they are completing successfully:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X GET \"http://:9200/_snapshot/my_backup/_all/_status\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restoring a Snapshot (if needed)","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If you need to restore a snapshot, you can do so with the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X POST \"http://:9200/_snapshot/my_backup/snapshot_/_restore\" -H 'Content-Type: application/json' -d'\n{\n \"indices\": \"index_swarm.datacore.com.com0\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false\n}'","type":"text"}]},{"type":"paragraph","content":[{"text":"For the S3 bucket:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -X POST \"http://:9200/_snapshot/my_s3_backup/snapshot_/_restore\" -H 'Content-Type: application/json' -d'\n{\n \"indices\": \"index_swarm.datacore.com.com0\",\n \"ignore_unavailable\": true,\n \"include_global_state\": false\n}'","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'","type":"text"},{"text":"\"include_global_state\": false","type":"text","marks":[{"type":"code"}]},{"text":"' means that only the data stored in the particular index is restored.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you wan to restore everything from the cluster, including templates, persistent cluster settings, and more, set ","type":"text"},{"text":"'\"include_global_state\": true","type":"text","marks":[{"type":"code"}]},{"text":"'.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Automating with Elasticsearch Curator","type":"text"}]},{"type":"paragraph","content":[{"text":"Elasticsearch Curator simplifies managing indices and snapshots. Here’s how to set it up:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install Curator","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pip install elasticsearch-curator","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Curator Configuration File","type":"text","marks":[{"type":"strong"}]},{"text":" (","type":"text"},{"text":"curator.yml","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"client:\n hosts:\n - 127.0.0.1\n port: 9200\nlogging:\n loglevel: INFO\n logfile: /var/log/curator.log\n logformat: default\n blacklist: ['elasticsearch', 'urllib3']","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Curator Action File","type":"text","marks":[{"type":"strong"}]},{"text":" (","type":"text"},{"text":"snapshot.yml","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"actions:\n 1:\n action: snapshot\n description: \"Snapshot selected indices\"\n options:\n repository: my_backup\n name: snapshot-%Y%m%d%H%M\n ignore_unavailable: false\n include_global_state: false\n filters:\n - filtertype: pattern\n kind: prefix\n value: index_swarm.datacore.com.com0","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Cron Job to Run Curator","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"0 2 * * * curator --config /path/to/curator.yml /path/to/snapshot.yml","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Best Practices","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Test Snapshots","type":"text","marks":[{"type":"strong"}]},{"text":": Regularly restore snapshots to a test cluster to ensure data integrity.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Monitor Resources","type":"text","marks":[{"type":"strong"}]},{"text":": Monitor cluster resources during snapshot operations to ensure they do not impact performance.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automate Alerts","type":"text","marks":[{"type":"strong"}]},{"text":": Set up alerts to notify you if a snapshot operation fails.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Retention Policy","type":"text","marks":[{"type":"strong"}]},{"text":": Implement a retention policy to manage storage, deleting older snapshots to save space.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"By following these steps, you can enable regular backups of your Elasticsearch index without causing downtime, ensuring your data is safe and recoverable.","type":"text"}]}],"version":1}

Browser not supported