{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"_parentId":{"value":"2443815149"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"f66e195a-c925-431c-be37-bb14273ea2e3"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a32065f2-d86f-496e-a7bf-cb6eb2287497"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Choosing S3 for Disaster Recovery","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to on-premises Swarm storage, an organization may want to take advantage of public cloud services for off-premises disaster recovery (DR) storage. With the S3 protocol support, Swarm provides choices of many public cloud providers including AWS S3, AWS S3 Glacier, and Wasabi. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The security of knowing backups is continuous. It has minimal latency and requires little intervention and monitoring by implementing an S3 backup feed from Swarm. Using Swarm's feed mechanism for backup leverages numerous existing strengths:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The long-term iteration over objects in the cluster","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A proven method for tracking work as it is performed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support for TLS network encryption and forward proxies. Using the parallelism of the entire Swarm cluster makes the best use of network bandwidth while sending the backups through an optional forward proxy allows implementing bandwidth throttling if needed.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Back up:","type":"text","marks":[{"type":"strong"}]},{"text":" S3 Backup is an integral part of the operating Swarm cluster. In the Swarm UI, create a new feed of type S3 Backup, and provide credentials and information about the network path to the service. After the feed is started, progress can be monitored and warnings of blockages and particular object failures can be sent, as with any other feed. The S3 Backup feed honors the ","type":"text"},{"text":"versioning settings in a cluster","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Implementing Versioning","versionAtSave":"16"},"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443812387"}}]},{"text":", as enabled, disabled, or suspended throughout the domains and buckets. While multiple S3 Backup feeds can be created, each one requires a dedicated target bucket. ","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"800","id":"3a8620c3-78ad-4d69-b54c-54e4a8ea0575","collection":"contentId-2443815149","height":""}}}]},{"type":"paragraph","content":[{"text":"Clean up:","type":"text","marks":[{"type":"strong"}]},{"text":" No action is needed to keep the backup current and trimmed. When disabling Swarm versioning on buckets or domains, delete the buckets/domains, or expire the ","type":"text"},{"text":"object lifepoints","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Lifepoint Metadata Headers","versionAtSave":"16"},"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443821972"}}]},{"text":" as the Swarm feeds mechanism processes the expired content as deleted, allowing the S3 Backup feed to clear them from the S3 bucket. Throughout content additions and deletions, the total number of objects in the S3 bucket always approximates ","type":"text"},{"text":"twice","type":"text","marks":[{"type":"em"}]},{"text":" the number of logical objects backing up from the source cluster (because AWS functionality requires there to be one for the object's content and another for metadata).","type":"text"}]},{"type":"paragraph","content":[{"text":"Restore:","type":"text","marks":[{"type":"strong"}]},{"text":" The Restore tool runs outside of Swarm, using a command-line interface for executing the data and restoration tasks. Restore what is needed, either the entire cluster or some portions of the cluster. Swarm supports bulk restores at the granularity of cluster, domain, or bucket, as well as more surgical restores of a few objects. Multiple copies can be run to achieve a faster, parallel recovery. See the ","type":"text"},{"text":"S3 Backup Restore Tool","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"S3 Backup Restore Tool","versionAtSave":"21"},"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443815581"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important","type":"text"}]},{"type":"paragraph","content":[{"text":"Objects in the S3 backup bucket are wholly dedicated to DR for Swarm and are ","type":"text"},{"text":"not","type":"text","marks":[{"type":"em"}]},{"text":" for general use by owners of the account where the bucket resides. Swarm uses a very specific naming convention within the backup bucket to provide 100% fidelity for object restoration. No external processes other than Swarm should manipulate the content within this bucket.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Standard or Cold Storage?","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm 12 supports the ","type":"text"},{"text":"AWS S3 storage classes","type":"text","marks":[{"type":"link","attrs":{"href":"https://aws.amazon.com/s3/storage-classes/"}}]},{"text":" for standard buckets and those using S3 Glacier and S3 Glacier Deep Archive. For this discussion, ","type":"text"},{"text":"cold storage","type":"text","marks":[{"type":"em"}]},{"text":" refers to S3 Glacier and S3 Glacier Deep Archive, and ","type":"text"},{"text":"standard storage","type":"text","marks":[{"type":"em"}]},{"text":" refers to the traditional S3 storage classes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to the documentation for the public cloud provider, and consider these points when choosing among the AWS S3 storage classes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cold storage offers the lowest monthly prices per byte stored compared to the standard storage classes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Standard storage classes have low-latency retrieval times, which can allow a ","type":"text"},{"text":"Swarm Restore to complete in a single run.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cold storage has longer retrieval latency, as much as 12-48 hours for S3 Glacier Deep Archive, to pull content from archival storage. Depending upon how a restore is performed, the Swarm Restore tool may need to be run multiple times over several hours to complete a restoration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cold storage incurs additional charges for egress and API requests to access the backup, so it is best suited to low-touch use cases.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"S3 Glacier Deep Archive rounds up small objects, so the overall footprint being charged may be larger because of Swarm's use of metadata objects.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Public storage pricing is competitive, and services such as ","type":"text"},{"text":"Wasabi Hot Cloud Storage","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"S3 Backup Feeds to Wasabi","versionAtSave":"9"},"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443815266"}}]},{"text":" may compare favorably with AWS cold storage, especially when considering egress and API charges.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setting up the S3 Bucket","type":"text"}]},{"type":"paragraph","content":[{"text":"To implement an S3 backup feed, complete a one-time setup of the S3. Set up an account with an S3 cloud service provider and then create an S3 bucket dedicated to backing up ","type":"text"},{"text":"this cluster","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm must be granted access to the target S3 bucket and provide login credentials as part of the S3 backup feed configuration. Neither the S3 Backup feed nor the ","type":"text"},{"type":"inlineCard","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"S3 Backup Restore Tool","versionAtSave":"21"},"url":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443815581"}},{"text":" administers the S3 credentials or create any target S3 buckets.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"While these instruction steps are for ","type":"text"},{"text":"AWS S3 (see also ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3c80e627-6057-49fd-be72-5679c2f6fd03"}}]},{"text":"S3 Backup Feeds to Wasabi","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"S3 Backup Feeds to Wasabi","versionAtSave":"9"},"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443815266"}}]},{"text":"), S3-based public cloud providers","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3c80e627-6057-49fd-be72-5679c2f6fd03"}}]},{"text":" have a similar setup process","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3c80e627-6057-49fd-be72-5679c2f6fd03"}},{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":":","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Service:","type":"text","marks":[{"type":"strong"}]},{"text":" Sign up for Amazon S3 if needed.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to ","type":"text"},{"text":"aws.amazon.com/s3","type":"text","marks":[{"type":"link","attrs":{"href":"https://aws.amazon.com/s3/"}}]},{"text":" and select ","type":"text"},{"text":"Get started with Amazon S3","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the on-screen instructions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AWS notifies by email when the account is active and ready to use.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note: ","type":"text"},{"text":"S3","type":"text","marks":[{"type":"strong"}]},{"text":" is accessed for the new bucket but the separate ","type":"text"},{"text":"IAM","type":"text","marks":[{"type":"strong"}]},{"text":" service for the new user:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":140105,"__fileMimeType":"image/png","width":916,"id":"95cd17a0-f476-4154-a03f-6fbfd8c11746","collection":"contentId-2443815149","type":"file","__fileName":"image2019-6-19_16-18-33.png","height":540}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bucket:","type":"text","marks":[{"type":"strong"}]},{"text":" Create a bucket dedicated to backing up the Swarm cluster.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sign in and open the S3 console: ","type":"text"},{"text":"console.aws.amazon.com/s3","type":"text","marks":[{"type":"link","attrs":{"href":"https://console.aws.amazon.com/s3/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose ","type":"text"},{"text":"Create bucket","type":"text","marks":[{"type":"strong"}]},{"text":". (See S3 documentation: ","type":"text"},{"text":"Creating a Bucket","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html"}}]},{"text":".) ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On tab ","type":"text"},{"text":"1 - Name and region","type":"text","marks":[{"type":"strong"}]},{"text":", make the initial entries:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"Bucket name","type":"text","marks":[{"type":"strong"}]},{"text":", enter a DNS-compliant name for the new bucket. This cannot be changed later, so choose well:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The name must be unique across all existing bucket names in Amazon S3.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The name must be a valid DNS name, containing lowercase letters and numbers (and internal periods, hyphens, underscores), between 3 and 64 characters. (See S3 documentation: ","type":"text"},{"text":"Rules for Bucket Naming","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/AmazonS3/latest/dev//BucketRestrictions.html#bucketnamingrules"}}]},{"text":".)","type":"text"},{"type":"hardBreak"},{"text":"Tip:","type":"text","marks":[{"type":"em"}]},{"text":" For easier identification, incorporate the name of the Swarm cluster that this bucket is dedicated to backing up.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"Region","type":"text","marks":[{"type":"strong"}]},{"text":", choose the one that is appropriate for business needs. (See S3 documentation: ","type":"text"},{"text":"Regions and Endpoints","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region"}}]},{"text":".)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On tab ","type":"text"},{"text":"2 - Configure options","type":"text","marks":[{"type":"strong"}]},{"text":", take the defaults. (See S3 documentation: ","type":"text"},{"text":"Creating a Bucket","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html"}}]},{"text":", step 4.)","type":"text"},{"type":"hardBreak"},{"text":"Best practice: ","type":"text","marks":[{"type":"em"}]},{"text":"Do not enable versioning or any other optional features, unless it is required for the organization.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On tab","type":"text"},{"text":" 3 - Set permissions","type":"text","marks":[{"type":"strong"}]},{"text":", take the default to select ","type":"text"},{"text":"Block all public access","type":"text","marks":[{"type":"strong"}]},{"text":"; now the bucket owner account has full access. ","type":"text"},{"type":"hardBreak"},{"text":"Best practice:","type":"text","marks":[{"type":"em"}]},{"text":" Do not use the bucket owner account to provide Swarm's access to the bucket; instead, create a new, separate IAM user that holds the credentials to share with Swarm. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"}]},{"text":", and record the fully qualified bucket name (such as \"","type":"text"},{"text":"arn:aws:s3:::example.cluster1.backup","type":"text","marks":[{"type":"code"}]},{"text":"\") for use later, in policies.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Record these values for configuring the S3 Backup feed in Swarm:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bucket Name","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Region","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User:","type":"text","marks":[{"type":"strong"}]},{"text":" Create a programmatic (non-human) user dedicated to Swarm access.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Amazon S3 console, select the service ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"IAM","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"strong"}]},{"text":" (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"Identity and Access Management","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4a4a4a"}}]},{"text":") and click ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"Users","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"420","id":"24fd9074-b3aa-400d-8e09-9256723c6e16","collection":"contentId-2443815149","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"strong"}]},{"text":" a dedicated user, such as ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"caringo_backup","type":"text","marks":[{"type":"code"}]},{"text":", to provide ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"Programmatic access","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"strong"}]},{"text":" for Swarm.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"520","id":"3739d816-5d34-4e80-894f-8658e0178180","collection":"contentId-2443815149","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The IAM console generates an access key (an access key ID + secret access key), which must be recorded immediately.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"type":"hardBreak"},{"text":"(See S3 documentation: ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"Managing Access Keys for IAM Users","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html"}}]},{"text":" and ","type":"text"},{"text":"Understanding and Getting Your Security Credentials","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys"}}]},{"text":".)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This is the sole opportunity to view or download the secret access key, so save it in a secure place.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Record the fully qualified user (such as \"","type":"text"},{"text":"arn:aws:iam::123456789012:user/caringo_backup","type":"text","marks":[{"type":"code"}]},{"text":"\") for use later, in policies.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Record these values for configuring the S3 Backup feed in Swarm:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access Key ID","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Secret Access Key ","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Policies:","type":"text","marks":[{"type":"strong"}]},{"text":" Create policies on ","type":"text"},{"text":"both","type":"text","marks":[{"type":"em"}]},{"text":" the user and the bucket so the programmatic user has exclusive rights to the S3 bucket. Use the policy generators provided or enter edited versions of the examples below.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an ","type":"text"},{"text":"IAM policy","type":"text","marks":[{"type":"strong"}]},{"text":" for this user, allowing it all S3 actions on the backup bucket, which need to be specified as a fully qualified ","type":"text"},{"text":"Resource","type":"text","marks":[{"type":"code"}]},{"text":"(recorded above), starting with ","type":"text"},{"text":"arn:aws:s3:::","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"600","id":"30f1bf36-4fed-40da-971b-06e64dc79de4","collection":"contentId-2443815149","height":""}}}]},{"type":"paragraph","content":[{"text":"IAM Policy","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"s3:*\",\n \"Resource\": \"arn:aws:s3:::example.cluster1.backup\"\n }\n ]\n}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a matching ","type":"text"},{"text":"bucket policy","type":"text","marks":[{"type":"strong"}]},{"text":" to grant access to the dedicated backup user, which needs to be specified as a fully qualified ","type":"text"},{"text":"Principal","type":"text","marks":[{"type":"code"}]},{"text":", which is the User ARN (recorded above) starting with ","type":"text"},{"text":"arn:aws:iam::","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"(See S3 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"Using Bucket Policies","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html"}}]},{"text":".) ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"type":"hardBreak"},{"text":"Using the Policy Generator, allow ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"text":"all","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}},{"type":"em"}]},{"text":" S3 actions for the bucket, using the full ARN name:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#444444"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"600","id":"57712721-6a5d-4769-86ed-6e1fd11bd23b","collection":"contentId-2443815149","height":""}}}]},{"type":"paragraph","content":[{"text":"Bucket Policy","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n \"Id\": \"Policy1560809845679\",\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Sid\": \"Stmt1560809828003\",\n \"Action\": \"s3:*\",\n \"Effect\": \"Allow\",\n \"Resource\": \"arn:aws:s3:::example.cluster1.backup\",\n \"Principal\": {\n \"AWS\": [\n \"arn:aws:iam::123456789012:user/caringo_backup\"\n ]\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Best practice for security:","type":"text","marks":[{"type":"em"}]},{"text":" After implementing the S3 Backup feed in Swarm, write a script to automate the rotation of the S3 secret access key on a regular basis, including updates in the S3 Backup feed definition in Swarm (using the management API call, given in ","type":"text"},{"text":"Rotating the S3 Access Key","type":"text","marks":[{"type":"em"}]},{"text":", below).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuring the S3 Backup Feed","type":"text"}]},{"type":"paragraph","content":[{"text":"The S3 Backup Feed option is available in Swarm 11 and higher, and it may be used immediately after upgrading Swarm Storage. (v11.0)","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to Swarm's other feed types, ","type":"text"},{"text":"Search","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Replication","type":"text","marks":[{"type":"strong"}]},{"text":", a dedicated ","type":"text"},{"text":"S3 Backup","type":"text","marks":[{"type":"strong"}]},{"text":" feed can be created. It resembles a Replication feed, but it requires an S3 bucket as the destination and has defaults appropriate for use with a cloud service.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to the ","type":"text"},{"text":"Feeds","type":"text","marks":[{"type":"strong"}]},{"text":" page.","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"450","id":"d96bc79b-712d-47c7-8250-15a8deb1ebb7","collection":"contentId-2443815149","height":""}}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"+ Add","type":"text","marks":[{"type":"strong"}]},{"text":" at the top right.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":20068,"__fileMimeType":"image/png","width":590,"id":"91e0ee8f-833f-4430-a4be-48730cb81ed2","collection":"contentId-2443815149","type":"file","__fileName":"image2019-10-4_15-5-26.png","height":317}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"the S3 Backup","type":"text","marks":[{"type":"strong"}]},{"text":" feed type:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":29848,"__fileMimeType":"image/png","width":749,"id":"59d7d7a7-ba17-4ea8-bba3-d74bc80231a2","collection":"contentId-2443815149","type":"file","__fileName":"image2019-6-21_14-55-4.png","height":532}}]}]}]},{"type":"paragraph","content":[{"text":"An S3 Backup feed has these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"f1f30fe0-6cb4-4791-a65f-133b75322792"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"ID (Existing feeds)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Read-only; system-assigned identifier","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Status (Existing feeds)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Read-only; the current feed processing state. The state can be:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Active:","type":"text","marks":[{"type":"strong"}]},{"text":" Default state when operating normally.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recovering:","type":"text","marks":[{"type":"strong"}]},{"text":" Temporarily paused due to volume recovery.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Paused:","type":"text","marks":[{"type":"strong"}]},{"text":" Paused by user request.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Blocked:","type":"text","marks":[{"type":"strong"}]},{"text":" Processing blocked due to a transient condition. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configuration Error:","type":"text","marks":[{"type":"strong"}]},{"text":" Feed is unable to operate due to incorrect configuration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Overlapping Feeds:","type":"text","marks":[{"type":"strong"}]},{"text":" More than the limit of 8 feeds are defined for the same set of objects.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Closed:","type":"text","marks":[{"type":"strong"}]},{"text":" Feed is inactive and no longer operational.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"The name attached to this backup feed.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Scope","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"The scope filter selected for the backup feed. Backup includes objects within the scope indicated here. If the scope includes a context where Swarm object versioning is (or was) generating historical versions, those versions are backed up as well.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Entire Source Cluster (Global):","type":"text","marks":[{"type":"strong"}]},{"text":" To replicate ","type":"text"},{"text":"all","type":"text","marks":[{"type":"em"}]},{"text":" objects in the source cluster, leave the default selection of Entire source cluster (global)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only Objects in Select Domain(s):","type":"text","marks":[{"type":"strong"}]},{"text":" To replicate the objects in one or more domains, select the 'Only objects in select domain(s) option. In the text box that appears, enter one or more domains:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To replicate the objects within a ","type":"text"},{"text":"specific domain","type":"text","marks":[{"type":"em"}]},{"text":", enter that domain.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To replicate the objects within ","type":"text"},{"text":"multiple domains","type":"text","marks":[{"type":"em"}]},{"text":", enter those domains separated by commas and/or use pattern matching.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To exclude domains from replication, enter them.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The field value allows pattern matching with the ","type":"text"},{"text":"Python regular expression (RE) ","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.python.org/2/library/re.html"}}]},{"text":"syntax so multiple domain names can be matched. The exception to the RE matching is that the \"{m,n}\" repetitions qualifier may not be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"An example domain list value using RE is: ","type":"text"},{"text":".*\\.example\\.com","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"This matches both of these domains: ","type":"text"},{"text":"accounting.example.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://accounting.example.com"}}]},{"text":", ","type":"text","marks":[{"type":"code"}]},{"text":"engineering.example.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://engineering.example.com"}}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":24709,"__fileMimeType":"image/png","width":761,"id":"f7140f04-5e28-4b6e-8f51-4455a5397a57","collection":"contentId-2443815149","type":"file","__fileName":"image2018-12-19_21-18-37.png","height":236}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include Objects without a Domain:","type":"text","marks":[{"type":"strong"}]},{"text":" To replicate any unnamed objects that are not tenanted in any domain, enable the option.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Target S3 Provider","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"The configuration for the S3 bucket.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caution","type":"text"}]},{"type":"paragraph","content":[{"text":"Although it is possible to specify another Swarm cluster (via Content Gateway S3) for the S3 backup, it is risky if there is any chance of it replicating back to the ","type":"text"},{"text":"source","type":"text","marks":[{"type":"em"}]},{"text":" cluster: both clusters can fill to capacity with backups of backups. Best practice is to use a regular Replication feed, which has the mechanisms needed for mirroring clusters safely.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Host","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"From the S3 configuration, the host name of the S3 service. An IP address cannot be used here because the host name itself becomes the Host header in the feed operation, which is required for communication to S3 ","type":"text"},{"text":"services","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"78f319c1-7cf8-43f2-b23f-152646c9b517"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the bucket name as the prefix to the host name (","type":"text"},{"text":"mybackup.s3.aws.com","type":"text","marks":[{"type":"code"}]},{"text":"). This prefix must match the bucket name exactly, including case. This supports the new AWS bucket-in-host request style. If the bucket is not defined here, Swarm uses the legacy bucket-in-path (","type":"text"},{"text":"s3.aws.com/mybackup","type":"text","marks":[{"type":"code"}]},{"text":") request style. (v12.0) ","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Amazon AWS:","type":"text","marks":[{"type":"strong"}]},{"text":" Existing feeds are not required to change to this format immediately, but new ones should, as bucket-in-path is unsupported in the future. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Other S3 Provider:","type":"text","marks":[{"type":"strong"}]},{"text":" Verify the provider supports the bucket-in-host request style, where the bucket is part of the FQDN; if not, use bucket-in-path.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Port","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"The port to use for the S3 service, which defaults to 443 (for HTTPS) or else 80 (HTTP), if ","type":"text"},{"text":"Require trusted SSL","type":"text","marks":[{"type":"strong"}]},{"text":" is disabled, below. If the port is customized, the value no longer updates based on changes to the SSL setting.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Region","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"From the S3 configuration, the destination S3 bucket’s region.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Changing this value triggers a restart of the feed.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Bucket","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"From the S3 configuration, the destination S3 bucket name. This bucket must be dedicated to one source cluster. Complete this field regardless of whether the Host includes the bucket name as a prefix.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Changing this value triggers a restart of the feed.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Access Key ID ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"and Secret Key","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"From the S3 configuration, the S3 access key ID and S3 secret access key to use. (See S3 documentation: ","type":"text"},{"text":"Understanding and Getting Your Security Credentials","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys"}}]},{"text":".)","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm protects the secret key as a secure field, and hides it. ","type":"text"},{"text":"Updating the key does not trigger a restart of the feed, so keys may be updated as frequently as the security policies require","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"31a71add-1a13-4dca-a19e-1aa3b7dec300"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"SSL Server","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"For production usage, select ","type":"text"},{"text":"Require trusted SSL","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Recommended","type":"text"}]},{"type":"paragraph","content":[{"text":"To keep bandwidth usage by the S3 Backup feed in check, select the option to use a ","type":"text"},{"text":"Local Cluster Forward Proxy","type":"text","marks":[{"type":"strong"}]},{"text":" and configure one for that purpose. The Forward Proxy ","type":"text"},{"text":"Host","type":"text","marks":[{"type":"strong"}]},{"text":" (hostname or IP address) and ","type":"text"},{"text":"Port","type":"text","marks":[{"type":"strong"}]},{"text":" are required.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Threads","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"The default backup speed for push thread (20 per Swarm Storage node) is optimal for maintaining an existing S3 backup. In releases prior to v15.0, it was 6 per volume.","type":"text"}]},{"type":"paragraph","content":[{"text":"For a faster initial backup, increase the threads temporarily, but monitor bandwidth and cluster performance, as boosting the speed stresses","type":"text"},{"text":" internet bandwidth.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2fff4779-75c3-412f-aa0e-215a62378201"}}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Rotating the S3 Access Key","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Best Practice","type":"text"}]},{"type":"paragraph","content":[{"text":"It is a DevOps best practice to routinely change cloud access credentials and to automate this S3 access key rotation for the S3 Backup feed.","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Through the public cloud provider, create a new S3 access key and grant the correct permissions for the target S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using Swarm's management API, update the access credentials for the existing S3 backup feed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expire/remove the old S3 access key upon confirming successful feed operations with the new credentials.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following command template demonstrates how to use the Swarm management API to update the access credentials for an existing S3 backup feed:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"a6339eeb-7f86-4046-b89b-69fa8cdcd97a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"curl -X PATCH --header 'Content-Type: application/json' -u : -d '[ \\\n{\"op\": \"replace\", \"path\":\"destination/accessKeyId\", \"value\":\"\"}, \\\n{\"op\": \"replace\", \"path\":\"destination/secretAccessKey\", \"value\":\"\"}]' \\\n'http:///api/storage/s3backupfeeds/'","type":"text"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The Swarm administrative user name, which is usually ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The Swarm administrative password, required for all management API calls that perform actions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The new access key ID for the target S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The new secret access key for the target S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The IP address of any Swarm node in the cluster.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" — The small integer feed ID that is associated with the S3 Backup feed. It appears as the feed's ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"strong"}]},{"text":" field in the Swarm UI.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Replication Feeds"},"_parentId":{"value":"2443815149"},"_referencedContentId":{"value":"2443814668"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"fbbe0e80-3608-4093-8d69-7a3d96496d98"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"ea7a2959-56b2-44db-81ec-0521ca3d8118"}},{"type":"hardBreak"}]}],"version":1}

Browser not supported