FAQ Potential Topics

Suggested Questions

Where can I find and/or submit user-created scripts/plugins?
- Currently being discussed on listserv
Where can I find a list of institutions who are live with ArchivesSpace?
- Christine's answer
How can ArchivesSpace be integrated with other applications?

Geared towards non-archivists, possibly compare with other archival applications
Ann's comment: Maybe link to some projects that integrate ASpace with other archival systems as examples, maybe a short explanation of archival CMSs. (Need to check, but is there already a good explanation in user documentation or on the website?)
Example question

Can I edit the ArchivesSpace wiki?
- Christine's message on requesting JIRA accounts

System
- What ports do different ArchivesSpace components run on?
  - Inspired by this question
- How do I backup ArchivesSpace?
  - GitHub docu
- How big does a production MySQL database tend to be?
  - List question
- What authentication methods can be used with ArchivesSpace?
  - LDAP (official documentation)
  - OmniAuth/CAS (user provided plugin)
  - Shibboleth? (asked here)
- How do installing ArchivesSpace on a Windows/MySQL server?
  - Good step by step instructions provided by user
Functionality questions
- What defines a repository?
- - Inspired by this discussion (subjects and agents are shared across repositories, as well as user defined labels possibly)
- What is the difference between an archival object and an instance?
  - Based on discussion here
- What is the role of the digital object module in an institution's archival workflow?
  - Good listserv answer
- What is the role of digital object components?
  - Brad's answer
API
- How do I use cURL to interact with the API?
- How do I use the API to manipulate data for public display?
- How do I run an advanced search using the API?
  - Answer
Customizing ArchivesSpace

How do I customize ArchivesSpace URLs? (e.g., custom domains and subdomains)
How do I set a default repository?
- Asked here, no answer (I feel like I used to see this question a lot)
Can I restrict the visibility of agent contact information based on staff permission level? (user oriented?)
- Asked here, no answer
How do I set up Google Analytics to work with ArchivesSpace?
- Chris's answer
Can I run ArchivesSpace using the default database?
- Should not be used for production (from official documentation):
  - "Out of the box, the ArchivesSpace distribution runs against an embedded database, but this is only suitable for demonstration purposes. When you are ready to starting using ArchivesSpace with real users and data, you should switch to using MySQL. MySQL offers significantly better performance when multiple people are using the system, and will ensure that your data is kept safe."
How do I change the look and feel of ArchivesSpace (e.g., adding my institution's logo)?
How do I add user defined fields?
Config.rb
How can I change tooltips?
- Brief answer

How do I convert MARC records to EAD for importing into ArchivesSpace?
- Stylesheet provided by user
Can I customize the PDF output?
- Asked on listserv, no answer
How do I map EAD to MODS?
- Stylesheet provided on listserv
Why do container IDs change on every export?
- Listserv discussion
How do I set EAD elements to always be published (unless they have an internal audience) when importing EAD files?
- Listserv answer
Can I include the public interface URL for a record in its exported EAD?
- Asked on listserv, no answer
Why am I getting an "invalid byte sequence" error when importing a CSV file?
- May be caused by importing a CSV that was created through MS Excel, use Google Sheets instead (listserv discussion)

Migration
- Why do I have duplicate records after migrating?
  - Need to rebuild index
Reports
- How do I enable Jasper reports?
  - Listserv answer
- How can I edit the SQL for a Jasper report?
  - Listserv answer
Upgrading

General question about where to find/discuss functionality changes after upgrade?

Indexing
- When should I reset the index?
  - When records are not showing up in search results after making changes (list question)
  - Duplicate records after migrating (list question)
  - Formerly deleted items or non-existent repositories are still displaying (list question)
- How do I reset the index?
  - Good explanation of what the different index directories do
- Why is the Solr indexer constantly rebuilding the index/running in a loop?
  - Chris's answer (when a record has a circular parent/child relationship)
Bugs

Error Messages
- What does the "translation missing: en.enumerations" error mean?
  - Listserv question