Hello and thank you for choosing to use this AMI

## Notes
- Depending on your use case T-series may not be an appropriate choice, especially on first boot as the application of new incremental data to the database will cause initial high CPU load. 
- This AMI comes with minimal free disk space. The application of incremental database updates and logs will cause it to fill up rapidly. If you intend to run your instance for a long period of time you are advised to allocate additional space and to monitor the disk usage on an ongoing basis. 
- The snapshot of the database built into this AMI **excludes areas and attic data**.
  - Should you require area data you can start it building by following the following instructions
  - https://wiki.openstreetmap.org/wiki/Overpass_API/Installation#Area_creation
- The minutely updates and the overpass dispatcher can be controlled via the services command
  - osm_overpass_update
  - osm_overpass_dispatch
- You can find various log files that relate to the overpass system in the following places, which may help in debugging
  - /opt/osm/replication/success.pointer
    /opt/osm/replication/fetch_osc.log
    /opt/osm/database/apply_osc_to_db.log
    /opt/osm/database/replicate_id
    /opt/osm/database/transactions.log
- You can access the api status via
  - http://<instance ip>/api/status
- The AMI only opens port 80 for HTTP traffic should you need to enable HTTPS please read an appropriate guide on configuring SSL on Apache

## Issues

- Overpass is quite sensitive to running out of disk space or stopping suddenly which may corrupt the database
  - Keep an eye on disk space
  - Shutdown of an instance is best done via _poweroff_ or _reboot_ from the command line
  - If the database becomes corrupt generally the best option is to start a fresh instance
- The builds of this AMI are automated to a large extent. Sometimes, however rarely, the cloning of the source database results in corruption or missing files.
  - Should you find this to be the case please reach out and contact support (see below)

## Support

- We very much want to help if we can. So please reach out to osm_overpass_help@mfaconsulting.com
  - We do not help with debugging queries or general AWS issues.
  - We will help if there are issues with the pre-built AMI
  - Please add the following details in the email
    - AMI version + ID
    - Instance type and size
    - Free disk space
    - Any error messages you receive from the service
    - Any error messages you see in any of the above mentioned logs
      - Also check your apache logs
- Additionally, should you need any of the following please contact us at the above support email
  - The AMI added to a new region
  - The AMI to be run on a different/new instance type
- We do provide consulting services on setting up large clusters, high throughput or HA use-cases