720-727-7002

info@civiclens.com

@civiclens_gis

Trademarks provided under license from Esri.

Backup Utility for ArcGIS  Online

®

Desktop Users: Read This First

Please read this section as it contains essential information for getting the most from the application. If you have questions not covered here or in the FAQs below, or if you run into any issues whatsoever, please click here for support.

Important things to be aware of when using the desktop application:

  • The application will take 30-60 seconds or more to load once you double-click, depending on the speed of your machine, because several libraries have to be extracted. See FAQs.

  • Besides the number and size of items included in your backup, the speed of your internet connection will affect backup time.

  • It's best to leave items in your org alone while the backup is running. You can continue to use your items and apps, just don't delete items or change settings during the backup.

  • If you lose your internet connection during the backup, the backup will be interrupted and will need to be restarted. A folder with backups completed up to that point will be left in your chosen directory.

  • Since the application accesses data on the web, its performance can be impacted by external factors (for example, the server does not return a valid response). Three attempts will be made for each item.

  • Rarely, some feature services simply cannot be backed up due to internal issues with the service, even if that service functions normally in your maps and apps. If feasible, you can usually resolve this by republishing the service. The application console will notify you in the Status window of any items that fail, at the end of the run.

  • If a feature service backup hangs for any reason, it will eventually time out, and the backup process will continue. Timeouts are rare and are usually (but not always) caused by exceptionally large services with lots of attachments or with several layers in a single service. If you find that certain services are taking a long time, you can exclude them by tag and run them separately if desired. Let us know if you are experiencing regular timeouts on a particular service and we can adjust some parameters in your application to reduce total backup time.

  • If you need to cancel a backup, use the Stop button. A folder with backups completed up to that point will be left in your chosen directory.

 

Desktop FAQ and Troubleshooting

Q: Why does the application take 30-60 seconds to load?

A: The application has to extract and load several libraries before it can start. This is necessary to avoid having to install anything on your machine, add libraries to your registry, etc.

Q: Why does my feature service keep failing?

A: Rarely, there are feature services that simply cannot be backed up due to internal issues with the service itself, even if the service works fine in your maps and apps. Although not always practical to do so, this can be resolved by republishing the service, or you can use the Exclude feature to skip these services with a tag.

Q: Why does my backup take so long?

A: Backup times are dependent on the number and size of items in your org and your internet connection speed. Very large services (e.g., those with a high number of attachments, complex geometries, or a high number of layers) will take a while. Please reach out to us if you experience problems with a particular service and we can help you look into it.

Q: What item types are included in backups?
A: Almost every item type is included in backups (click
here for full list). Exceptions include service definitions and a few uncommon item types. If you have item types that are not included in your backup, let us know and we can easily configure your application to grab them.

Q: Why did my backup fail?

A: Although rare, backups do occasionally fail. Because the application accesses items on the internet, there is no way to plan for every contingency; the server could return an error, your internet connection could be interrupted, or there could be temporary problems with ArcGIS Online. Clicking restart and running the backup again usually resolves any problems. If not, please let us know and we'll resolve it right away.

 

Managed Service User Guide

  • Working with our scheduled managed service is easy - except for minor tasks at initial implementation, users only need to interact with the system when retrieving backups.

  • Backups are stored in secure, direct-access buckets on Amazon Web Services Simple Storage Service (AWS S3) and are typically retained for a rolling 120-day period unless a longer retention period has been included in your organization's contract.

  • CivicLens will provide you with an AWS login, or you may choose to create your own AWS account and provide your information (AWS Account ID and username) so we can share your bucket with you. 

  • Daily backups will be retained in the frequent-access storage class (available for immediate download) for a rolling 15-day period, after which they will be transitioned to the Glacier Deep Storage class for an additional rolling 105-day period. Initiating downloads for backups that have been moved to the Glacier Deep Storage class can take up to 12 hours. At the base price of $1,500/year, total storage consumption must not exceed 2 terabytes per month on a rolling basis. This is equivalent to an average 50 gigabyte daily backup (more than most organizations will ever need).

Accessing your backups

  • Go to https://s3.console.aws.amazon.com/s3/buckets/<your-org-name>-agol-backup/ and sign in with your AWS credentials.

  • Your bucket will open with a list of backups in chronological order. For backups less than 30 days old, simply click on the backup you wish to access, then click the Download button in the upper left of the Overview pane. A zip file containing your backup will download to your browser’s default download folder.

  • Navigate to the download location, right-click on the zip file, and extract. 7-Zip is highly recommended.

  • Within your backup folder are subfolders which split out your backup items by item type. Folders for item types that do not exist in your organization or for which the script has not been configured to download will be empty. 

  • Also within this folder is a CSV file titled AllItems.csv, a spreadsheet with a list of all items contained in the backup, with several item attributes (Item ID, owner, sharing, etc.). The last column shows the backup result for that item.

  • Backups older than 30 days must be restored before they can be downloaded. To restore, check the box next to the backup(s) you wish to restore, select Actions, and select Restore as shown below. Once backups are restored, they may be downloaded as described above. When restoring, don’t worry about the “Retrieval Fees Apply” warning – this nominal charge goes to CivicLens and is included in your subscription cost.

 

Support Request Form