Archivematica - User contributions [en]

Main Page

2020-05-08T13:55:10Z

Ablewer: /* Community */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
* [https://wiki.archivematica.org/Community/Regional_User_Groups Regional groups]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]
*[https://twitter.com/archivematica Twitter]

</div>
</div>

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

* Unfortunately due to concerns about COVID19 [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] will be postponed indefinitely. We hope it will be rescheduled later in 2020 or early 2021. Watch this space!

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Community/Regional User Groups

2020-05-07T20:39:55Z

Ablewer: /* UNITED KINGDOM */

== '''GLOBAL Users Forum''' ==

Every other month on the first Thursday of the month.

More information can be found here: https://docs.google.com/document/d/1xowR7G9u_5HmJFLcnQRp5rWiPfocmjQ7o-2T6QVkAu4/edit

Meeting minutes: https://drive.google.com/drive/folders/0B4hO2MJSeCa5cmtrclVMOVg0X00

== '''UNITED KINGDOM''' ==

:: Contact: Rachel MacGregor, Digital Preservation Officer, Modern Records Centre, University of Warwick (rachel.macgregor@warwick.ac.uk)

:: The UK Archivematica group was established in late 2014 and the first meeting of the group was held in January 2015.

:: '''Purpose of group'''

:: The UK Archivematica group provides a friendly and informal forum for UK users to discuss Archivematica and share experiences, workflows and use cases. It enables members to get feedback on their own work with Archivematica and benefit from the experience of other users.

:: '''Who is it for?'''

::* The group is open to individuals and organisations in the UK who are actively using, exploring or testing Archivematica
::* It is also open to representatives from user communities who are not be using Archivematica themselves but who can keep abreast with the group and signpost and promote us and our activities
::* It is also open to relevant tool and service providers (particularly those that Archivematica relies on) to enable open discussion on how these tools may be used within Archivematica or enhanced
::* Members may come from a variety of backgrounds and job roles - for example, archivists, research data managers, IT staff
::* There are no restrictions on the number of members, though individual meetings will have an upper limit for number of attendees

:: '''Meetings'''

:: The UK Archivematica group meets 2 or 3 times per year in different locations around the UK.

:: The venue and format of the meetings will vary but they are intended to be friendly and informal and enable members to see how others are using Archivematica and openly discuss what is and isn’t working well.

::Content of a meeting may include:

::* Presentations and progress reports from members
::* Presentations from international Archivematica users
::* Archivematica demonstrations
::* Discussion topics
::* Updates and Q&A from Artefactual Systems
::* Opportunities for informal discussion and networking
</br>

== '''UNITED STATES''' ==

=== '''<U>TEXAS</U>''' ===

:: Contact: Bethany Scott (bscott3@uh.edu), Coordinator of Digital Projects, University of Houston Libraries or Sean Buckner (sbuckner@tamu.edu), Digital Preservation Librarian, Texas A&M University Libraries, to be added to the [https://groups.google.com/forum/#!forum/texas-archivematica-users-group Google Group].[[File:a-tex.jpg|170px|right|text-top]]

:: The TX Archivematica group, also known as Archivematica TEX Support (pun intended) or A-TEX, was formed in early 2017 with the support of the [https://tdl.org/ Texas Digital Library] (TDL). Its inaugural meeting was held at the 2017 [https://tcdl-ocs-tdl.tdl.org/tcdl/index.php/TCDL/TCDL2017 Texas Conference on Digital Libraries] (TCDL) in May.

:: '''Purpose of group'''

:: The Texas Archivematica Users Group (A-TEX) provides a network of collegial support and inspiration among Archivematica users in Texas, and an informal forum for discussion and sharing about the Archivematica digital preservation system.

:: '''Membership'''

:: A-TEX is intended for Texas users actively exploring or implementing Archivematica. Members may be individuals with an interest in Archivematica or those whose institutions are using or investigating Archivematica.

:: To participate, please visit the Google Group page to explore the users/support group. One may request to join the group directly from the [https://groups.google.com/forum/#!forum/texas-archivematica-users-group Google Group] site.

:: '''Meetings'''

:: In-person meetings will be held once or twice per year in different locations in Texas. The purpose of in-person meetings is to provide an informal setting for members to present their progress, ask questions, solicit feedback, and share challenges and successes. The content of in-person meetings may include presentations by Artefactual staff, presentations or institutional updates from members, Archivematica-related discussion questions, or general digital preservation discussion. The business portion of the in-person meeting will also include requests for feedback from members on the direction and future activities of the group. The Steering Committee will solicit contributions to the agenda for in-person meetings from group members via calls for proposals distributed on the Google Group site.

=== '''<U>NORTHEAST</U>''' ===

:: We've formed in order to meet up and discuss the work we're doing with Archivematica, with a special emphasis on development work with Artefactual. Our goal is to share this development work with each other in order to reduce overlaps in functionality and to help ensure its usefulness outside our own institutions. Visit [https://groups.google.com/forum/#!forum/nearchivematicausers Google Group].
</br>

== '''AUSTRALASIA''' ==

:: AtoM and Archivematica Users Australasia [https://groups.google.com/forum/#!forum/atom-users-australasia Google Group].

</br>

== '''NETHERLANDS and FLANDERS''' ==

:: Contact: Robert Gillesse (robert.gillesse@iisg.nl), Digital Archivist, International Institute of Social History (IISH). Google [https://groups.google.com/forum/#!forum/nl-vl-archivematica-user-group discussion forum].

:: The Netherlands and Flanders (NL-VL) Archivematica group was established in 2017.

:: '''Purpose of group'''

:: The NL-VL Archivematica group provides a friendly and informal forum for Dutch and Flemish users to discuss Archivematica and share experiences, workflows and use cases. It enables members to get feedback on their own work with Archivematica and benefit from the experience of other users.

:: '''Who is it for?'''

::* The group is open to individuals, organisations and companies in the Netherland and Flanders who are actively using, exploring or testing Archivematica
::* It is also open to representatives from user communities who are not be using Archivematica themselves but who can keep abreast with the group and signpost and promote us and our activities
::* Members may come from a variety of backgrounds and job roles - for example, archivists, research data managers, IT staff
::* There are no restrictions on the number of members, though individual meetings will have an upper limit for number of attendees
::* You can become a member by joining the [https://groups.google.com/forum/#!forum/nl-vl-archivematica-user-group Google Group]

:: '''Meetings'''

::* The NL-VL Archivematica group meet 1 on or 2 times per year in different locations around the Netherlands or Belgium
::* The venue and format of the meetings will vary but they are intended to be friendly and informal and enable members to see how others are using Archivematica and openly discuss what is and isn’t working well
::* If all attendees are Dutch speaking the meeting will be held in Dutch

:: Content of a meeting may include:
::* Presentations and progress reports from members
::* Presentations from international Archivematica users
::* Archivematica demonstrations
::* Discussion topics
::* Updates and Q&A from Artefactual Systems
::* Opportunities for informal discussion and networking

:: '''Online discussion platform'''
:: The NL-VL Archivematica [https://groups.google.com/forum/#!forum/nl-vl-archivematica-user-group Google Group] is used to organise meetings, continue discussions and share documents after our meetings, share updates and progress reports and discuss ideas and areas for future collaboration.

:: The group communicates via an e-mail list established as a private Google Group hosted by the IISH. Only list members can see the posts to this group. The e-mail archive is not public. Robert Gillesse at the IISH manages this list and can invite and direct add new members as appropriate.

:: The NL-VL Archivematica e-mail list is not intended to duplicate the [https://groups.google.com/forum/#!forum/archivematica Archivematica User Forum]. Members of the NL-VL group are encouraged to use the main user forum for help, advice and technical queries about Archivematica.

== '''SOUTH AFRICA''' ==

:: '''Background''': The AtoM/Archivematica South Africa User Community group was first established in July of 2018.

:: '''Purpose''': The group has been created to provide a friendly and informal way for regional AtoM and Archivematica users to connect, share resources and workflows, and collaborate on both troubleshooting and future projects.

:: '''Email list''': A regional Google group (which also functions as an email list) has been created, and is available at: https://groups.google.com/forum/#!forum/atomsa

:: '''How do I join the group?'''

:: You will need to apply to gain access to the group. Once you apply at the link above, a group moderator will review your request, and you should receive a notification about your membership shortly.

:: Because this is a private group, you will need a Google account to configure your mail delivery preferences, but this does *not* require the use of a Gmail address. Google has more information on working with Groups here:
:: * https://support.google.com/groups/?hl=en#topic=9216
:: * https://support.google.com/groups/answer/1067205?hl%3Den%26ref_topic%3D2458614

== '''SWEDEN'''==

:: '''Background''': The Archivematica and AtoM Swedish User Group started in 2018 to help local Archivematica and AtoM users Sweden and other Nordic countries share experiences.

:: '''Purpose of group''': The user group forms a network for organizations using, or preparing to use, Archivematica and AtoM for digital preservation for internal use, or for providing public access to their information.

:: '''Who is it for?''' The group is open to any organization or company in Sweden or the Nordics who are willing to share their experiences with these two products and their efforts and challenges for digital preservation.

:: '''Meetings''': Twice a year, in spring and fall, one member organization hosts a meeting. Online meetings may be held, depending on member locations. Usually one or two presentations are given, followed by discussions around current topics, new features in latest releases, and proposals for new implementations or other work that may benefit the group or the community.

:: '''Web presence''': https://www.aoais.se/ The user group web site includes an online forum for questions.

:: '''Contact''': Info, Swedish User group (info@aoais.se)

Release Notes

2020-04-03T19:23:19Z

Ablewer: /* Archivematica 1.x releases */

[[Main_Page|Home]] > Release Notes

== About ==

Release notes are prepared by Artefactual for each release of Archivematica. Most releases also have a corresponding release of the Storage System, and may also include corresponding releases for various dependencies and libraries (i.e. FIDO, Automation Tools) - be sure to check the release notes for more information.

Major releases are '''bolded''', minor releases are not.

Features, enhancements, and bug fixes are often sponsored by members of the Archivematica community who are dedicated to funding Archivematica's ongoing development and maintenance. Code contributors are individuals who write Archivematica code and [https://github.com/artefactual/archivematica/blob/stable/1.6.x/CONTRIBUTING.md| contribute it] back to the project. Archivematica couldn't continue to grow without sponsors and contributors - thank you!

Questions about a release or the release notes? Ask on the [https://groups.google.com/forum/#!forum/archivematica| Archivematica Google Group!]

== Archivematica 1.x releases ==

* [[Archivematica_1.11_and_Storage_Service_0.16_release_notes|'''Archivematica 1.11 and Storage Service 0.16 Release Notes''']] (Current)
* [[Archivematica_1.10.1_release_notes|Archivematica 1.10.1 and Storage Service 0.15.1 Release Notes]]
* [[Archivematica_1.10_and_Storage_Service_0.15_release_notes|'''Archivematica 1.10 and Storage Service 0.15 Release Notes''']]
* [[Archivematica_1.9.2_release_notes|Archivematica 1.9.2 Release Notes]]
* [[Archivematica_1.9.1_and_Storage_Service_0.14.1_release_notes|Archivematica 1.9.1 and Storage Service 0.14.1 Release Notes]]
* [[Archivematica_1.9_and_Storage_Service_0.14_release_notes|'''Archivematica 1.9 and Storage Service 0.14 Release Notes''']]
* [[Archivematica_1.8.1_release_notes|Archivematica 1.8.1 Release Notes]]
* [[Archivematica_1.8_and_Storage_Service_0.13_release_notes|'''Archivematica 1.8 and Storage Service 0.13 Release Notes''']]
*[[Archivematica 1.7.2_release_notes|Archivematica 1.7.2 Release Notes]]
*[[Storage Service 0.12 Release Notes|'''Storage Service 0.12 Release Notes''']]
*[[Archivematica 1.7.1_release_notes|Archivematica 1.7.1 Release Notes]]
*[[Storage Service 0.11.1 Release Notes]]
* [[Archivematica_1.7_and_Storage_Service_0.11_release_notes|'''Archivematica 1.7 and Storage Service 0.11 Release Notes''']]
* [[Archivematica_1.6.1_release_notes|Archivematica 1.6.1 Release Notes]]
* [[Archivematica_1.6_release_notes|'''Archivematica 1.6 Release Notes''']]
* [[Archivematica_1.5.1_Release_Notes|Archivematica 1.5.1 Release Notes]]
* [[Archivematica_1.5_Release_Notes|'''Archivematica 1.5 Release Notes''']]
* [[Archivematica_1.4.1_Release_Notes|Archivematica 1.4.1 Release Notes]]
* [[Archivematica_1.4_Release_Notes|'''Archivematica 1.4 Release Notes''']]
* [[Archivematica_1.3.2_Release_Notes|Archivematica 1.3.2 Release Notes]]
* [[Archivematica_1.3.1_Release_Notes|Archivematica 1.3.1 Release Notes]]
* [[Archivematica_1.3_Release_Notes|'''Archivematica 1.3 Release Notes''']]
* [[Archivematica_1.2_Release_Notes|'''Archivematica 1.2 Release Notes''']]
* [[Archivematica_1.1_Release_Notes|'''Archivematica 1.1 Release Notes''']]
* [[Archivematica_1.0_Release_Notes|'''Archivematica 1.0 Release Notes''']]

== Archivematica 0.x releases ==

* [[Archivematica_0.10-beta_Release_Notes|'''Archivematica 0.10 Release Notes''']]
* [[Archivematica_0.9_Release_Notes|'''Archivematica 0.9 Release Notes''']]
* [[Archivematica_0.8_Release_Notes|'''Archivematica 0.8 Release Notes''']]
* [[Archivematica_0.7.1_Release_Notes|Archivematica 0.7.1 Release Notes]]
* [[Archivematica_0.7_Release_Notes|'''Archivematica 0.7 Release Notes''']]
* [[Archivematica_0.8_Release_Notes|'''Archivematica 0.6 Release Notes''']]

== Templates ==

* [[Major_release_notes|Template for major releases]]
* [[Minor_release_notes|Template for minor releases]]

Archivematica 1.11 and Storage Service 0.16 release notes

2020-03-25T19:43:09Z

Ablewer: /* Upgraded tools and dependencies */

[[Main_Page|Home]] > [[Release_Notes|Release Notes]] > Archivematica 1.11 and Storage Service 0.16

'''March ## 2020'''

==Supported environments==

Please see the [https://www.archivematica.org/en/docs/archivematica-1.11/admin-manual/installation-setup/installation/installation/#installation installation instructions].

Archivematica 1.11 and Storage Service 0.16 are supported for production use in the following environments:

* Ubuntu 16.04 64-bit Server Edition
* Ubuntu 18.04 64-bit Server Edition
* CentOS 7 64-bit

For development purposes, most of our developers prefer to use Docker containers. These and all above supported environments are linked from the installation instructions above.

==Added==

===PREMIS Event import===

This feature allows the import of PREMIS events which took place prior to processing in Archivematica. The PREMIS events are written in an xml format (see [https://github.com/artefactual/archivematica-sampledata/blob/master/SampleTransfers/PremisImporter/metadata/premis.xml sample data]) and placed in the metadata folder of a transfer. The PREMIS events are then written to the AIP METS file.

This work was sponsored by Piql and the Norwegian Health Archives. Thank you!

* Documentation: link
* Issue: https://github.com/archivematica/Issues/issues/710

===S3 as a transfer source===

This allows an Amazon S3 space to be used as a transfer source location. This feature is a community PR from Wellcome Collection. Thank you!

* Documentation: link
* Issue: https://github.com/archivematica/Issues/issues/975

===Easier access to AIP METS===

This feature add a "View METS" button in the user interface when viewing an AIP in Archival Storage. The METS file is then downloaded to your desktop for your viewing pleasure.

* Documentation: link
*Issue: https://github.com/archivematica/Issues/issues/644

===Zipped transfers===

This is a new transfer type that enables a zipped (non-bagged) package to be a transfer. Similar to the zipped bag transfer, the name of the package is used as the transfer name. This is a community contribution by Wellcome Collection. Thank you!

* Documentation: link
* Issue: https://github.com/archivematica/Issues/issues/682

===Add package name as configurable value to call backs===

When using AIP, AIC, and DIP store callbacks, the package_name is now a configurable value. This is a community contribution from Concordia University Libraries, who developed this to facilitate an EPrints to Archivematica workflow. Thank you!

* Documentation: link
* Issue: https://github.com/archivematica/Issues/issues/978

==Changed==

===Performance and monitoring improvements===

This is a collection of issues fixed that improve performance for processing at scale, and also enable performance monitoring through external applications such as Prometheus and Grafana.

These updates have been sponsored by Piql and the Norwegian Health Archives. Thank you!

* Documentation: link
* Issues:
** Commonly used database tables don't have indexes: https://github.com/archivematica/Issues/issues/907
** MCPServer should reuse database connections: https://github.com/archivematica/Issues/issues/913
** Archivematica does not output metrics to analyze its performance: https://github.com/archivematica/Issues/issues/906
** MCPService must process all transfer packages sent to it at once: https://github.com/archivematica/Issues/issues/911
** Some jobs run even when disabled: https://github.com/archivematica/Issues/issues/866
** "Check transfer directory for objects" executed multiple times: https://github.com/archivematica/Issues/issues/782
** index_aip crashes elasticsearch for large transfers: https://github.com/artefactual/archivematica/issues/1199

===Improvements for full disks===

Managing workflows when various spaces on the disk fill up is a recognized pain point for Archivematica users. This project makes
three overall changes to storage space reporting in Archivematica and the Storage Service in an effort to mitigate these issues:
* Change the processing storage usage page to clarify storage paths/locations and improve usability
* Improve the transfer source location and AIP storage location pages to clarify storage paths/locations and improve usability
* Change Storage Service functionality to support the above changes.

===Changes to default normalization for videos/images===

Archivematica's default FPR normalization rules were creating in some cases very large video files for arguably no sound preservation reason. After discussion and community consultation, we have removed default video normalization rules. Users can still "opt in" to the rules but they are not enabled by default in '''new or upgraded''' installations. Any custom changes you have made to your own FPR will still be maintained after upgrade. We also removed default rules for preservation for PNG, JPG, GIF and DNG still images. For full details and affected formats, see [https://github.com/archivematica/Issues/issues/912#issuecomment-565197594 this comment] in the issue ticket.

* Issue: https://github.com/archivematica/Issues/issues/912

===Allow users to choose whether to receive fail report emails===

Users can now be configured to either receive fail report emails or not (previously all users received the emails). This is a community contribution from Hillel Arnold at Rockefeller Archive Center- thank you!

*Documentation: link
* Issue: https://github.com/archivematica/Issues/issues/709

===Change name of sanitize names micro-service===

Following reading a paper by [https://medium.com/on-archivy/invisible-defaults-and-perceived-limitations-processing-the-juan-gelman-files-4187fdd36759 Elvia Arroyo-Ramirez] we decided to change the name of this micro-service and align it more with the Library of Congress events vocabulary. The micro-service now displays as "Change transfer filenames" and "Change SIP filenames" in the Transfer and Ingest tabs respectively.

* Issue: https://github.com/archivematica/Issues/issues/230

===Drop-down menu orders===

In short, the order of options in drop down menus were all over the place and it was driving us nuts so we finally tried to put them in more logical orders.

* Issue: https://github.com/artefactual/archivematica/issues/891

==Removed==

===Quarantine===

As [https://groups.google.com/d/msg/archivematica/rGMsO8htF38/Pl-eLimwAgAJ discussed on the community forum] the quarantine micro-service has been removed from Archivematica in this release.
* Issue: https://github.com/artefactual/archivematica/issues/598
* ADR: https://github.com/archivematica/archivematica-architectural-decisions/blob/master/0008-remove-quarantine.md

===Add next disk image button===

This button seemed redundant to the workflow so it's been removed.
* Issue: https://github.com/archivematica/Issues/issues/290

==Fixed==

* Non-Dublin Core columns cause metadata re-ingest to fail ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/1139
* RuntimeError which was causing sporadic workflow issues ('''Community contribution''' by Jorik van Kemanade- thank you!): https://github.com/archivematica/Issues/issues/1108
* Reindexing large transfer backlog error ('''Community contribution''' by Matt LaChance- thank you!): https://github.com/archivematica/Issues/issues/962
* Parallel bzip2 compression failing in am19rpm: https://github.com/archivematica/Issues/issues/606
* Fixity API endpoint and Fixity tool tail to check replicated AIPs ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/1054
* Decision points break with 10 choices or more ('''Sponsored''' by Picturae- thank you!): https://github.com/archivematica/Issues/issues/850
* S3 us-east-1 fails when chosen as region in the Storage Service ('''Community contribution''' by Joseph Anderson, Fashion Institution of Technology- thank you!): https://github.com/archivematica/Issues/issues/922
* "Remove bagged files" reports failure when thumbnails aren't created: https://github.com/archivematica/Issues/issues/651
* Directories are greyed out while they still contain files available for arrangement ('''Sponsored''' by Simon Fraser University Archives- thank you!): https://github.com/archivematica/Issues/issues/822
* Dublin Core dmdSec not created if filename has diacritics: https://github.com/archivematica/Issues/issues/1073
* Cannot add metadata files through the UI ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/1090
* GPG/TRANSFORMKEY being lost when reingesting an encrypted AIP: https://github.com/archivematica/Issues/issues/803
* Pointer file uses a mix of PREMIS2 and PREMIS3: https://github.com/archivematica/Issues/issues/820
* Failure to match in ArchivesSpace DIP Upload shows as success ('''Sponsored''' by Rockefeller Archive Center- thank you!): https://github.com/archivematica/Issues/issues/258
* Allow S3 credentials to be blank ('''Community contribution''' by Wellcome Collection- thank you!): https://github.com/archivematica/Issues/issues/712
* Version of METS in mets-reader-writer is an older version: https://github.com/archivematica/Issues/issues/637
* S3 bucket name can't be configured: https://github.com/archivematica/Issues/issues/558
* Pointer files for reingested AIP has two compression events: https://github.com/archivematica/Issues/issues/1062
* Bags with metadata fail to ingest when additional metadata is added by automation tools ('''Sponsored''' by the Museum of Modern Art- thank you!): https://github.com/archivematica/Issues/issues/1022
* Transfer browser breaks if transfer source contains read protected directories: https://github.com/archivematica/Issues/issues/1019
* AIP status in dashboard does not update after AIP is deleted: https://github.com/archivematica/Issues/issues/1014
* SIPs started from ArchivesSpace pane fail when a parent object does not have a title ('''Community contribution''' by Dallas Pillen- thank you!): https://github.com/archivematica/Issues/issues/799
* Cannot create user with accented characters/diacritics: https://github.com/archivematica/Issues/issues/261
* AIP METS and pointer METS files reference outdated METS schema: https://github.com/archivematica/Issues/issues/949
* Cannot start a transfer if transfer name has diacritics: https://github.com/archivematica/Issues/issues/1051
* Non-default processing configuration is not copied over for zipped transfers ('''Community contribution''' by Wellcome Collection- thank you!): https://github.com/archivematica/Issues/issues/771
* Directory level AIP metadata is not indexed: https://github.com/archivematica/Issues/issues/888
* Descriptive metadata added via GUI is not indexed for searching: https://github.com/archivematica/Issues/issues/547
* External PIDs are not searchable in Archival storage ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/1006
* Identifiers.json import fails if 'Bind PIDs' config option is not set to 'yes' ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/963
* Ldap auth fails on dashboard ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/841
* Cannot create storage service location via amclient ('''Sponsored''' by International Institute of Social History- thank you!): https://github.com/archivematica/Issues/issues/905
* It is difficult to combine status for different package types ('''Community contribution''' by Rockefeller Archive Center- thank you!): https://github.com/archivematica/Issues/issues/972
* Format identification errors are not being output from the FPR command ('''Community contribution''' by Wellcome Collection- thank you!): https://github.com/archivematica/Issues/issues/882
* Time zone setting not configurable ('''Sponsored''' by Piql/NHA- thank you!): https://github.com/archivematica/Issues/issues/1143
* Cannot store AIP with large files ('''Community contribution''' by Jorik van Kemenade- thank you!): https://github.com/archivematica/Issues/issues/981

And more! See https://github.com/archivematica/Issues/milestone/11 for full list of issues addresses in the 1.11 release.

==Upgraded tools and dependencies==

* Update to PRONOM v.96 https://github.com/archivematica/Issues/issues/791

==Known issues==

Please note that due to [https://github.com/archivematica/Issues/issues/1149 Issue 1149] the package replication functionality in the Storage Service does not work in this release. We anticipate fixing in the near future in a point release.

==End of life dependencies==

Python 2 has reached end of life. The Archivematica delivery team along with a number of community contributors has been working on upgrading this dependency. This release merges all Python 3 code that was ready in advance of the release, while still supporting Python 2. Components which have been upgraded and/or tested using Python 3 include:
* Dashboard: https://github.com/archivematica/Issues/issues/810
* Storage Service: https://github.com/archivematica/Issues/issues/806 '''Note''' We were not able to test some storage spaces, including Sword2, LOCKSS-o-matic and DSpace.
* amclient: https://github.com/archivematica/Issues/issues/817
* Automation tools: https://github.com/archivematica/Issues/issues/815
* Fixity: https://github.com/archivematica/Issues/issues/814
* am/compose: https://github.com/archivematica/Issues/issues/804
* Fido: https://github.com/archivematica/Issues/issues/847

We will continue to work toward full Python 3 use in upcoming releases.

Release Process

2020-02-18T15:25:54Z

Ablewer: /* Update FIDO */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in <code>fido/fido.py</code>
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

When a new Siegfried version becomes available, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo and update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

==== Examples ====
<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55

There used to be a [https://projects.artefactual.com/issues/10466#change-46673 bug] in the imports model. To fix, Remove the <code>apps.get_model</code> lines and Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code>. You shouldn't have to do this now.

</div>

==== Update workflow ====

This depends on FIDO having updated PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-current.json</code>
# Make a new migration (you can copy from a previous one) and update it accordingly
#* E.g. <code>cp src/dashboard/src/fpr/migrations/0022_pronom_94.py src/dashboard/src/fpr/migrations/0032_pronom_96.py</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python src/dashboard/src/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v96.xml --output-filename pronom96.txt</code>
# Copy the output into the blank migration above the Migration class. (Note: This is temporary, to create the data inside the FPR for the analyst steps below)
# Make sure the below RunPython operation is in the Migration class, in the operations list
# Deploy on testing pipeline or locally

(Analyst work)
# Update the new entries. Edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly!
#* Move new formats to the most appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analyst work)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python src/dashboard/src/manage.py get_fpr_changes fpr-current.json fpr-updated.json pronom_96.json</code>
# Update the migration to load the JSON updates (see previous migrations)
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove any direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Rebuild and test migration
# Commit, send PR, merge

=== Finally, update IDTools versions in the FPR ===
# FPR needs a migration to point to the latest and accurate versions of Fido and Siegfried, and disables the previous version of Siegfried (Fido is disabled by default. As of 1.9, there can only be one enabled identification tool). See this PR for an example of a functional migration, and heed the messy commits as a warning: https://github.com/artefactual/archivematica/pull/1547/files
# Testing the above migration can be done by running <code>make bootstrap-dashboard-db</code> to recreate the dashboard and run all associated migrations.

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Community/Camps

2020-02-13T19:41:48Z

Ablewer: /* Past Camps */

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is a chance for anyone interested in or currently using Archivematica to come together, learn more about the platform, and share their experiences.

== Upcoming Camps ==

=== [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 April 2020 - Archivematica Con Brooklyn] ===
The first Archivematica Con will be from April 15-17, 2020 in Brooklyn, NY!

== Past Camps ==

=== [https://wiki.archivematica.org/Community/Camps/Geneva2019 October 2019 - Archivematica Camp Geneva] ===
[https://home.cern/ CERN] hosted [https://wiki.archivematica.org/Community/Camps/Geneva2019 Archivematica Camp Geneva] from October 22-24, 2019 at the CERN campus in Geneva, Switzerland!

=== [https://wiki.archivematica.org/Community/Camps/Vancouver2019 June 2019 - Archivematica Camp Vancouver] ===
The [https://www.library.ubc.ca/ University of British Columbia] hosted [https://wiki.archivematica.org/Community/Camps/Vancouver2019 Archivematica Camp Vancouver] from June 24-26, 2019 in Vancouver, British Columbia!

=== [https://wiki.archivematica.org/Community/Camps/London2019 July 2019 - Archivematica Camp London] ===
The [http://www.lse.ac.uk/ London School of Economics] hosted [https://wiki.archivematica.org/Community/Camps/London2019 Archivematica Camp London] from July 10-12, 2019 in London, UK!

=== [https://wiki.archivematica.org/Community/Camps/Houston2018 November 2018 - Archivematica Camp Texas] ===
The [http://libraries.uh.edu/ University of Houston Libraries] and the [https://www.tdl.org/ Texas Digital Library] hosted [https://wiki.archivematica.org/Community/Camps/Houston2018 Archivematica Camp Texas] from November 14-16, 2018, at the University of Houston.

=== [[Community/Camps/Baltimore2018|June 2018 - Archivematica Camp Baltimore]] ===
The [https://www.library.jhu.edu/ Sheridan Libraries] at [https://www.jhu.edu/ Johns Hopkins University] graciously hosted Archivematica Camp from June 20-22, 2018.

=== [[Community/Camps/Amsterdam2018|April 2018 - IISH, Amsterdam]] ===
We headed back across the water to Amsterdam in April of 2018, hosted by the International Institute for Social History, April 11-13, 2018.

=== [[Community/Camps/York2017|April 2017 - University of York, UK]] ===
The first European Archivematica Camp was hosted by the University of York in York, England from April 4-6, 2017.

=== [[Community/Camps/UMSI2016|August 2016 - University of Michigan School of Information]] ===
The first ever Archivematica Camp was hosted by the University of Michigan School of Information in Ann Arbor, Michigan, from August 24 - 26, 2016.

== Cohosting a Camp ==
Interested in bringing Archivematica Camp to your region? For more information, check out [[Community/Camps/Organize|Organizing an Archivematica Camp]]!

Community/Camps

2020-02-13T19:41:13Z

Ablewer: /* Upcoming Camps */

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is a chance for anyone interested in or currently using Archivematica to come together, learn more about the platform, and share their experiences.

== Upcoming Camps ==

=== [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 April 2020 - Archivematica Con Brooklyn] ===
The first Archivematica Con will be from April 15-17, 2020 in Brooklyn, NY!

== Past Camps ==

=== [https://wiki.archivematica.org/Community/Camps/Vancouver2019 June 2019 - Archivematica Camp Vancouver] ===
The [https://www.library.ubc.ca/ University of British Columbia] is hosting [https://wiki.archivematica.org/Community/Camps/Vancouver2019 Archivematica Camp Vancouver] from June 24-26, 2019 in Vancouver, British Columbia!

=== [https://wiki.archivematica.org/Community/Camps/London2019 July 2019 - Archivematica Camp London] ===
The [http://www.lse.ac.uk/ London School of Economics] is hosting [https://wiki.archivematica.org/Community/Camps/London2019 Archivematica Camp London] from July 10-12, 2019 in London, UK!

=== [https://wiki.archivematica.org/Community/Camps/Houston2018 November 2018 - Archivematica Camp Texas] ===
The [http://libraries.uh.edu/ University of Houston Libraries] and the [https://www.tdl.org/ Texas Digital Library] hosted [https://wiki.archivematica.org/Community/Camps/Houston2018 Archivematica Camp Texas] from November 14-16, 2018, at the University of Houston.

=== [[Community/Camps/Baltimore2018|June 2018 - Archivematica Camp Baltimore]] ===
The [https://www.library.jhu.edu/ Sheridan Libraries] at [https://www.jhu.edu/ Johns Hopkins University] graciously hosted Archivematica Camp from June 20-22, 2018.

=== [[Community/Camps/Amsterdam2018|April 2018 - IISH, Amsterdam]] ===
We headed back across the water to Amsterdam in April of 2018, hosted by the International Institute for Social History, April 11-13, 2018.

=== [[Community/Camps/York2017|April 2017 - University of York, UK]] ===
The first European Archivematica Camp was hosted by the University of York in York, England from April 4-6, 2017.

=== [[Community/Camps/UMSI2016|August 2016 - University of Michigan School of Information]] ===
The first ever Archivematica Camp was hosted by the University of Michigan School of Information in Ann Arbor, Michigan, from August 24 - 26, 2016.

== Cohosting a Camp ==
Interested in bringing Archivematica Camp to your region? For more information, check out [[Community/Camps/Organize|Organizing an Archivematica Camp]]!

Release Process

2020-01-25T17:20:29Z

Ablewer: /* Finally, update FPR */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

When a new Siegfried version becomes available, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo and update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

==== Examples ====
<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55

There used to be a [https://projects.artefactual.com/issues/10466#change-46673 bug] in the imports model. To fix, Remove the <code>apps.get_model</code> lines and Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code>. You shouldn't have to do this now.

</div>

==== Update workflow ====

This depends on FIDO having updated PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-current.json</code>
# Make a new migration (you can copy from a previous one) and update it accordingly
#* E.g. <code>cp src/dashboard/src/fpr/migrations/0022_pronom_94.py src/dashboard/src/fpr/migrations/0032_pronom_96.py</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python src/dashboard/src/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v96.xml --output-filename pronom96.txt</code>
# Copy the output into the blank migration above the Migration class. (Note: This is temporary, to create the data inside the FPR for the analyst steps below)
# Make sure the below RunPython operation is in the Migration class, in the operations list
# Deploy on testing pipeline or locally

(Analyst work)
# Update the new entries. Edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly!
#* Move new formats to the most appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analyst work)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python src/dashboard/src/manage.py get_fpr_changes fpr-current.json fpr-updated.json pronom_96.json</code>
# Update the migration to load the JSON updates (see previous migrations)
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove any direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Rebuild and test migration
# Commit, send PR, merge

=== Finally, update IDTools versions in the FPR ===
# FPR needs a migration to point to the latest and accurate versions of Fido and Siegfried, and disables the previous version of Siegfried (Fido is disabled by default. As of 1.9, there can only be one enabled identification tool). See this PR for an example of a functional migration, and heed the messy commits as a warning: https://github.com/artefactual/archivematica/pull/1547/files
# Testing the above migration can be done by running <code>make bootstrap-dashboard-db</code> to recreate the dashboard and run all associated migrations.

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-25T17:19:53Z

Ablewer: /* Update workflow */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

When a new Siegfried version becomes available, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo and update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

==== Examples ====
<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55

There used to be a [https://projects.artefactual.com/issues/10466#change-46673 bug] in the imports model. To fix, Remove the <code>apps.get_model</code> lines and Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code>. You shouldn't have to do this now.

</div>

==== Update workflow ====

This depends on FIDO having updated PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-current.json</code>
# Make a new migration (you can copy from a previous one) and update it accordingly
#* E.g. <code>cp src/dashboard/src/fpr/migrations/0022_pronom_94.py src/dashboard/src/fpr/migrations/0032_pronom_96.py</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python src/dashboard/src/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v96.xml --output-filename pronom96.txt</code>
# Copy the output into the blank migration above the Migration class. (Note: This is temporary, to create the data inside the FPR for the analyst steps below)
# Make sure the below RunPython operation is in the Migration class, in the operations list
# Deploy on testing pipeline or locally

(Analyst work)
# Update the new entries. Edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly!
#* Move new formats to the most appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analyst work)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python src/dashboard/src/manage.py get_fpr_changes fpr-current.json fpr-updated.json pronom_96.json</code>
# Update the migration to load the JSON updates (see previous migrations)
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove any direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Rebuild and test migration
# Commit, send PR, merge

=== Finally, update FPR ===
# FPR needs a migration to point to the latest and accurate versions of Fido and Siegfried, and disables the previous version of Siegfried (Fido is disabled by default. As of 1.9, there can only be one enabled identification tool). See this PR for an example of a functional migration, and heed the messy commits as a warning: https://github.com/artefactual/archivematica/pull/1547/files
# Testing the above migration can be done by running <code>make bootstrap-dashboard-db</code> to recreate the dashboard and run all associated migrations.

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-25T17:17:00Z

Ablewer: /* Package Siegfried */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

When a new Siegfried version becomes available, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo and update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

==== Examples ====
<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55

There used to be a [https://projects.artefactual.com/issues/10466#change-46673 bug] in the imports model. To fix, Remove the <code>apps.get_model</code> lines and Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code>. You shouldn't have to do this now.

</div>

==== Update workflow ====

This depends on FIDO having updated PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-current.json</code>
# Make a new migration (you can copy from a previous one) and update it accordingly
#* E.g. <code>cp src/dashboard/src/fpr/migrations/0022_pronom_94.py src/dashboard/src/fpr/migrations/0032_pronom_96.py</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python src/dashboard/src/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v96.xml --output-filename pronom96.txt</code>
# Copy the output into the blank migration above the Migration class. (Note: This is temporary, to create the data inside the FPR for the analyst steps below)
# Make sure the below RunPython operation is in the Migration class, in the operations list
# Deploy on testing pipeline or locally

(Analyst work)
# Update the new entries. Edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly!
#* Move new formats to the most appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analyst work)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python src/dashboard/src/manage.py get_fpr_changes fpr-current.json fpr-updated.json pronom_96.json</code>
# Update the migration to load the JSON updates (see previous migrations)
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove any direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Rebuild and test migration
# Commit, send PR, merge

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-22T17:36:08Z

Ablewer: /* Update FPR */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

First, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo. Update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

==== Examples ====
<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55

There used to be a [https://projects.artefactual.com/issues/10466#change-46673 bug] in the imports model. To fix, Remove the <code>apps.get_model</code> lines and Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code>. You shouldn't have to do this now.

</div>

==== Update workflow ====

This depends on FIDO having updated PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-current.json</code>
# Make a new migration (you can copy from a previous one) and update it accordingly
#* E.g. <code>cp src/dashboard/src/fpr/migrations/0022_pronom_94.py src/dashboard/src/fpr/migrations/0032_pronom_96.py</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python src/dashboard/src/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v96.xml --output-filename pronom96.txt</code>
# Copy the output into the blank migration above the Migration class. (Note: This is temporary, to create the data inside the FPR for the analyst steps below)
# Make sure the below RunPython operation is in the Migration class, in the operations list
# Deploy on testing pipeline or locally

(Analyst work)
# Update the new entries. Edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly!
#* Move new formats to the most appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analyst work)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python src/dashboard/src/manage.py dumpdata fpr > tmp/fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python src/dashboard/src/manage.py get_fpr_changes fpr-current.json fpr-updated.json pronom_96.json</code>
# Update the migration to load the JSON updates (see previous migrations)
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove any direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Rebuild and test migration
# Commit, send PR, merge

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-21T15:37:58Z

Ablewer: /* Update FIDO */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Update version:
#* Update in __init__.py
#* Update in versions.xml
# Create pull request.
# Release new version of FIDO.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

First, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo. Update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55
</div>

This process is currently more convoluted than it needs to be, and should be simplified.

This depends on FIDO having updated their PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python testproject/manage.py dumpdata fpr > fpr-current.json</code>
# Generate a blank data migration
#* E.g. <code>python testproject/manage.py makemigrations --empty --name pronom_89 fpr</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python testproject/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v89.xml --output-filename pronom89.txt</code>
# Copy the output into the blank migration above the Migration class
# Add the below RunPython operation into the Migration class, in the operations list
#* <code>migrations.RunPython(data_migration),</code>
# <s>Due to a [https://projects.artefactual.com/issues/10466#change-46673 bug], fix the imports</s>
#* <s>Remove the <code>apps.get_model</code> lines</s>
#* <s>Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code></s>
# Commit
# Deploy on testing pipeline or locally

(Analysts)
# Update the new entries
#* '''Ask to edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly'''
#* Move new formats to a more appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analysts)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python testproject/manage.py dumpdata fpr > fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python testproject/manage.py get_fpr_changes fpr-current.json fpr-updated.json fpr/migrations/pronom_89.json</code>
# Update the migration to load the JSON updates
#* Replace the contents of the data migration function with
#** <code>fixture_file = os.path.join(os.path.dirname(__file__), 'pronom_89.json')</code>
#** <code>call_command('loaddata', fixture_file, app_label='fpr')</code>
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove the direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Commit
# Merge
# Make new FPR release. Don't forget to update fpr/__init__.py! Then tag the release (e.g. `v.1.7.9`) and push the latest tag.
# Update AM's dashboard base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/dashboard/src/requirements/base.txt]

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-21T15:33:06Z

Ablewer: /* Update FIDO */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
#* the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* the reference path to the container signatures in fido.py
# Create pull request.
# Release new version of FIDO. Make sure to update __init__.py AND the versions XML with a new version before creating a release.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

First, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo. Update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55
</div>

This process is currently more convoluted than it needs to be, and should be simplified.

This depends on FIDO having updated their PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python testproject/manage.py dumpdata fpr > fpr-current.json</code>
# Generate a blank data migration
#* E.g. <code>python testproject/manage.py makemigrations --empty --name pronom_89 fpr</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python testproject/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v89.xml --output-filename pronom89.txt</code>
# Copy the output into the blank migration above the Migration class
# Add the below RunPython operation into the Migration class, in the operations list
#* <code>migrations.RunPython(data_migration),</code>
# <s>Due to a [https://projects.artefactual.com/issues/10466#change-46673 bug], fix the imports</s>
#* <s>Remove the <code>apps.get_model</code> lines</s>
#* <s>Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code></s>
# Commit
# Deploy on testing pipeline or locally

(Analysts)
# Update the new entries
#* '''Ask to edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly'''
#* Move new formats to a more appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analysts)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python testproject/manage.py dumpdata fpr > fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python testproject/manage.py get_fpr_changes fpr-current.json fpr-updated.json fpr/migrations/pronom_89.json</code>
# Update the migration to load the JSON updates
#* Replace the contents of the data migration function with
#** <code>fixture_file = os.path.join(os.path.dirname(__file__), 'pronom_89.json')</code>
#** <code>call_command('loaddata', fixture_file, app_label='fpr')</code>
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove the direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Commit
# Merge
# Make new FPR release. Don't forget to update fpr/__init__.py! Then tag the release (e.g. `v.1.7.9`) and push the latest tag.
# Update AM's dashboard base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/dashboard/src/requirements/base.txt]

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-21T15:32:50Z

Ablewer: /* Update FIDO */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Replace:
# * the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
# * the reference path to the container signatures in fido.py
# Create pull request.
# Release new version of FIDO. Make sure to update __init__.py AND the versions XML with a new version before creating a release.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

First, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo. Update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55
</div>

This process is currently more convoluted than it needs to be, and should be simplified.

This depends on FIDO having updated their PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python testproject/manage.py dumpdata fpr > fpr-current.json</code>
# Generate a blank data migration
#* E.g. <code>python testproject/manage.py makemigrations --empty --name pronom_89 fpr</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python testproject/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v89.xml --output-filename pronom89.txt</code>
# Copy the output into the blank migration above the Migration class
# Add the below RunPython operation into the Migration class, in the operations list
#* <code>migrations.RunPython(data_migration),</code>
# <s>Due to a [https://projects.artefactual.com/issues/10466#change-46673 bug], fix the imports</s>
#* <s>Remove the <code>apps.get_model</code> lines</s>
#* <s>Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code></s>
# Commit
# Deploy on testing pipeline or locally

(Analysts)
# Update the new entries
#* '''Ask to edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly'''
#* Move new formats to a more appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analysts)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python testproject/manage.py dumpdata fpr > fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python testproject/manage.py get_fpr_changes fpr-current.json fpr-updated.json fpr/migrations/pronom_89.json</code>
# Update the migration to load the JSON updates
#* Replace the contents of the data migration function with
#** <code>fixture_file = os.path.join(os.path.dirname(__file__), 'pronom_89.json')</code>
#** <code>call_command('loaddata', fixture_file, app_label='fpr')</code>
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove the direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Commit
# Merge
# Make new FPR release. Don't forget to update fpr/__init__.py! Then tag the release (e.g. `v.1.7.9`) and push the latest tag.
# Update AM's dashboard base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/dashboard/src/requirements/base.txt]

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Release Process

2020-01-21T14:48:48Z

Ablewer: /* Update FIDO */

This is an outline/checklist of the process to create Archivematica & Storage service releases.

== Overview ==

# Merge new features
# Test new features
# [[#Update PRONOM]]
# Write documentation
# Update dependencies
# Update version
# [[#Build deb/rpm packages]]
# Test packages for new installs and upgrades
# [[#Tag Release]]
# Update ansible roles
# Announce release

== Translations ==

'''Needs to be improved!'''

* Determine code freeze / call for translations process
* Describe processes: push and pull - and when it needs to happen
* We made a choice on how we're using Transifex to keep things simple: only one branch at a time pushed to Transifex. E.g. once SS 0.10.0 is released we have to decide if:
*# We move Transifex to stable/0.10.x for a while so we can work on a minor release with translation fixes (e.g. 0.10.1), or
*# We move to qa/0.11.x which would only make possible to bring new translations to SS 0.11.0.
* Affected repositories
** archivematica-storage-service
** archivematica-workflow
** archivematica-dashboard
*** Includes archivematica-fpr-admin
*** Includes appraisal-tab

== Update PRONOM ==

PRONOM needs to be updated in our file identification tools, FIDO & Siegfried, as well as in the FPR.

=== Update FIDO ===

The FPR update currently use FIDO as a source for new PRONOM, since it is formatted nicer than PRONOM offers, so we depend on FIDO having updated their PRONOM. If that has not happened, we can generate a new formats-v##.xml by updating signatures manually. Artefactual can also update PRONOM and submit a PR to FIDO.

# Checkout fido from https://github.com/openpreserve/fido
# Update signatures
#* Run <code>python setup.py install</code>
#* Run <code>python -m fido.update_signatures</code> from the fido repository root
# Add:
#* New signature file <code>fido/conf/DROID_SignatureFile-v##.xml</code>
#* New formats file <code>fido/conf/formats-v##.xml</code>
#* New PRONOM zip file <code>fido/conf/pronom-xml-v##.zip</code>
#* Updated <code>fido/conf/versions.xml</code>
# Remove:
#* Old signature file
#* Old formats file
#* Old PRONOM zip file
# Update the container signatures (download here: https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm)
#* See this pull request submitted to update to PRONOM 90: https://github.com/openpreserve/fido/pull/110
# Update <code>fido/fido.py</code> to point to the new format_files
# Create pull request.
# Release new version of FIDO. Make sure to update __init__.py AND the versions XML with a new version before creating a release.

Remember to package FIDO and Siegfried in Archivematica! See next step below.

=== Package FIDO ===

FIDO is packaged via [http://pypi.org/ PyPi] under opf-fido. The Makefile includes a `make package` command that will do the update.

MCPClient's base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/MCPClient/requirements/base.txt] will need to be updated with the latest version.

=== Package Siegfried ===

First, clone the [https://github.com/artefactual-labs/am-packbuild/ am-packbuild] repo. Update the Makefiles available at <code>rpm/siegfried/Makefile</code>, and <code>deb/siegfried/Makefile</code> , and run <code>make</code> in each directory to build the packages.

=== Update FPR ===

<div class="text-alert">
* In https://github.com/artefactual/archivematica-fpr-admin/pull/51, the devtools used here to generate the migration were included in archivematica-fpr-admin as django-admin management tools.
* At the end of the process: '''remember''' to remove "pk"s from the final migration fixture! E.g. see PR #55
* Examples
** PRONOM 92:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/63
*** ???
** PRONOM 90:
*** https://github.com/artefactual/archivematica-fpr-admin/pull/51
*** https://github.com/artefactual/archivematica-fpr-admin/pull/55
</div>

This process is currently more convoluted than it needs to be, and should be simplified.

This depends on FIDO having updated their PRONOM files. See [[#Update FIDO]]

# Generate a JSON with the current version of the FPR (for use later)
#* <code>python testproject/manage.py dumpdata fpr > fpr-current.json</code>
# Generate a blank data migration
#* E.g. <code>python testproject/manage.py makemigrations --empty --name pronom_89 fpr</code>
# Generate the FPR migration body. This also updates the local database's FPR with the new PRONOM IDs
#* E.g. <code>python testproject/manage.py import_pronom_ids path/to/fido/fido/conf/formats-v89.xml --output-filename pronom89.txt</code>
# Copy the output into the blank migration above the Migration class
# Add the below RunPython operation into the Migration class, in the operations list
#* <code>migrations.RunPython(data_migration),</code>
# <s>Due to a [https://projects.artefactual.com/issues/10466#change-46673 bug], fix the imports</s>
#* <s>Remove the <code>apps.get_model</code> lines</s>
#* <s>Import the models directly with <code>from fpr.models import Format, FormatVersion, IDRule</code></s>
# Commit
# Deploy on testing pipeline or locally

(Analysts)
# Update the new entries
#* '''Ask to edit ONLY entries added by the latest PRONOM update otherwise the fixture won't work properly'''
#* Move new formats to a more appropriate category
#* Create rules & commands
#* Test with data for new formats
(End Analysts)

# Generate a JSON with the updated version of the FPR on the testing pipeline
#* <code>python testproject/manage.py dumpdata fpr > fpr-updated.json</code>
# Get the updates as JSON
#* E.g. <code>python testproject/manage.py get_fpr_changes fpr-current.json fpr-updated.json fpr/migrations/pronom_89.json</code>
# Update the migration to load the JSON updates
#* Replace the contents of the data migration function with
#** <code>fixture_file = os.path.join(os.path.dirname(__file__), 'pronom_89.json')</code>
#** <code>call_command('loaddata', fixture_file, app_label='fpr')</code>
# Review JSON -- some IDs with multipleformats are being imported and will have to be manually reviewed until bug is identified/corrected.
#* Remove the direct imports from the bug
#* '''Remove the pk's from the entries in the JSON document.'''
#* Improvement Note: Because this is using loaddata, this will have problems if the FPR models are changed. A possible solution is to update get-fpr-changes to generate a migration instead of JSON
# Commit
# Merge
# Make new FPR release. Don't forget to update fpr/__init__.py! Then tag the release (e.g. `v.1.7.9`) and push the latest tag.
# Update AM's dashboard base.txt [https://github.com/artefactual/archivematica/blob/qa/1.x/src/dashboard/src/requirements/base.txt]

== Update dependencies ==

=== Python Packages ===

[https://github.com/artefactual-labs/mets-reader-writer metsrw] and [https://github.com/artefactual-labs/agentarchives agentarchives] both have Makefiles that handle most of the packaging

# Check for open PRs, merge as necessary
# Update <code>setup.py</code> with the new version, create a pull request, code review, [[Merging | merge]].
# Tag new release, push tag
#* <code>git push --tags</code>
# Run <code>make package</code>
#* This will build the package and upload it to PyPI. It will prompt for your PyPI username and password for the upload
#* The Makefile was created from instructions at https://packaging.python.org/distributing/
# <code>make clean</code> will delete packaging related files

== Update version ==

# Update PREMIS agent to Archivematica-X.X.X
# Update Dashboard-Administration-Version to X.X.X
# Update Storage services-Admin-Version to X.X.X

== Build deb/rpm packages ==

The am-packbuild repository has all the code related to building packages, except the building gpg keys. The steps to follow in order to build production production packages are as follow

=== Debian packages ===

# Clone the [https://github.com/artefactual-labs/am-packbuild am-packbuild] repo. Latest work is available in master
# Put your gpg private key into <code>debs/GPG-KEYS-REPOS</code>. That's the place the Dockerfile looks for it when building the environment.
# Update the makefile at <code>debs/archivematica/Makefile</code> in order to reflect version/keys you want to use.
# Run <make>, and the packages will be available in the <code>build</code> once the building finishes.
# Upload packages to public debian repository

=== Debian reposities ===

There are two debian repositories, one for archivematica packages, and one for dependencies. The procedure in order to create new ones, or upload packages to them, is the same:

#* Create folder for repo, and configuration file:
<code>
mkdir -p /path/to/repos/repo/conf

cat > /path/to/repos/repo/conf/distributions << EOF

Codename: trusty

Components: main

Architectures: amd64 source

SignWith: <short gpg keyid>

EOF
</code>

#* Go inside the repo, and import the packages previously uploaded with:
<code>
cd /path/to/repos/repo/

reprepro includedeb trusty /path/to/packages/*.deb

reprepro includedsc trusty /path/to/packages/*.deb

</code>

The current official repo is at packages.archivematica.org

=== RPM Packages ===

# Package specs are available in [https://github.com/artefactual-labs/am-packbuild/tree/dev/packaging-1.6-docker/rpm am-packbuild/rpms]
# There are vars in the Makefiles for version/release , so update them when needed
# In order to build them, just go into the directory you want to build, and run “make”

=== RPM Repositories ===

Once the packages are built, upload them to packages.archivematica.org/<version>/centos
Sign the packages with rpm --addsign *.rpm (already signed packages will be skipped)

Go inside that dir, and as user ohbot run:

* ''rpm --addsign *.rpm'' (already signed packages will be skipped)

* ''createrepo .'' (For packages other than archivematica , use “centos-extras” repository)

* ''gpg --detach-sign --armor repodata/repomd.xml''

The first gpg command signs the rpms, and the later signs the repository content.

=== Development stage ===

In the final stages of development, the repositories for the new releases are created, but packages are signed with a development key to avoid mistakes. Once the development stage finishes, all new packages need to be rebuild using the production keys.

Development packages are built on each new commit to stable branches by Jenkins. Repositories are available at http://jenkins-ci.archivematica.org/repos/

== Website ==

'''Needs to be improved!'''

==== Homepage ====

* Make changes in archivematica-web.git
** Update links
** Add new doc repos
* Deploy
** Log in sites-pub as archivematica-web and run update-web.sh

==== Documentation ====

* Deploy
** Log in sites-pub as archivematica-web and run update-docs.sh

==== Wiki ====

* Release notes
* Installation notes
* ...

== News ==

* Twitter
* Mailing list
* News section in artefactual.com

== Update ansible roles ==

Check that the deploy-pub vars files for archivematica are updated, and the ansible-ansiblematica-src and ansible-archivematica-pkg roles are able to deploy the new version

== Tag Release ==

# Add release tags to repositories
#* Archivematica
#* Storage Service
#* FPR-admin
#* appraisal tab
#* transfer browser
#* Others?
# Create stable/#.x branch
# Delete qa/#.x branch if necessary

== Release Day Checklist ==

'''Step 0''': Operations Team checklist tasks are complete (as of September 2018, this is an internal Trello list).
*At this point, there should be a release candidate that has been tested. A release candidate always precedes a tagged release. If any new issues have been uncovered, a new release candidate should be made and tested before proceeding with the rest of the steps.

'''Step 1''': Release Captain decides whether the current release candidate is ready to release

* Look at all recently filed issues in GitHub -- is anything concerning / relevant for this release? Does anything need to be addressed? If an issue is uncovered that does need to be fixed, this restarts the checklist back to Step 0.
* Have automated tests passed?

'''Step 2''': Release Captain creates a new tag for the release via gitolite (e.g. `v1.7.0` or `v0.11.0` for the Storage Service) or assigns someone else to do it.

* Ensure you are adding the tag to the right commit! It should match the last commit of the final release candidate.
* You can create the tags from GitHub or from CLI: <code>git tag $VERSION $REVISION</code>and <code>git push origin refs/tags/$VERSION</code>
* Make sure that the version is valid,
** Valid values: v1.8.1, v1.8.1-rc.1
** Invalid values: 1.8.1, 1.8, 1.8.1-rc1, v1.8.1-rc1

'''Step 3''': Sysadmin (for now; hopefully Jenkins for 1.8) builds new packages using the release tag.

* See the internal wiki for steps.

'''Step 4''': Sysadmin copies new packages to the proper repository (e.g., https://packages.archivematica.org/1.7.x/)

* See the internal wiki for steps.

'''Step 5''': Analyst updates the Archivematica documentation links in the install / upgrade section with the correct package names and locations (e.g. conf.py in docs repo)

'''Step 6''': Sysadmin updates deploy-pub to use the new links.

'''Step 7''': Developer updates archivematica-web (managed in Gitolite / Gitlab) to show the new release.

* See the internal wiki for steps.

'''Step 8''': Developer changes the default branches in GitHub and Gitolite and updates references in https://gist.github.com/qubot.

'''Step 9''': Systems administrator updates am-packbuild and upgrades public and private demo sites.

* See the internal wiki for steps.

'''Step 10''': Developer, Ops, or Analyst, creates a release branch, and release, of [https://github.com/artefactual-labs/archivematica-acceptance-tests Archivematica Automated Acceptance tests] (AMAUAT) in-line with the Archivematica versioning, e.g. for Archivematica 1.10 release a 1.10 branch and [https://github.com/artefactual-labs/archivematica-acceptance-tests/releases release] of AMAUAT.

'''Step 11''': Release Captain finalizes the [https://wiki.archivematica.org/Release_Notes release notes] and adds a link to them in the [https://github.com/artefactual/archivematica/releases GitHub release]. Make sure that the releases are marked as "published".
* https://github.com/artefactual/archivematica/releases
* https://github.com/artefactual/archivematica-storage-service/releases

'''Step 12''': Release Captain posts a notification to the [https://groups.google.com/forum/#!forum/archivematica Archivematica Google Group] and the News section of the Artefactual website.

'''Step 13''': Release Captain closes all release-related issues in the Verified column in Waffle.

'''Step 14''': All involved eat cake (for a major release) or cupcakes (for a minor release).

[[Category:Process documentation]]

Portable Document Format

2020-01-07T18:02:55Z

Ablewer: Created page with "Main Page > Documentation > Format policies > Portable Document Format ===File extension(s)=== .pdf ===Format registry information=== *[http://www.nationalarchi..."

[[Main Page]] > [[Documentation]] > [[Format policies]] > Portable Document Format

===File extension(s)===
.pdf

===Format registry information===
*[http://www.nationalarchives.gov.uk/PRONOM/Format/proFormatSearch.aspx?status=detailReport&id=637 PRONOM]

===Significant characteristics===
See [[Significant characteristics of word processing files]]

===Preservation action plan===
Normalize to PDF/A

===Preservation issues===
PDF/A is the only version of PDF recommended for long-term preservation. According to Library of Congress, "For pragmatic reasons, when PDF/A is mandated, PDF/A-1b is usually acceptable. Full PDF/A-1a compliance, with tagged document structure, is hard to achieve except in a workflow that anticipates that objective from initial document creation." ([http://www.digitalpreservation.gov/formats/fdd/fdd000125.shtml Library of Congress Sustainability of Digital Formats: PDF/A])

===Conversion test results===
[[PDF to PDF/A using Ghostscript]]

===Access format===
PDF/A

===More information===
*[http://www.digitalpreservation.gov/formats/fdd/fdd000030.shtml Library of Congress Sustainability of Digital Formats: PDF],
*[http://hul.harvard.edu/ois/digpres/docs/OIS_recs_for_pdf.pdf OIS Recommendations for PDF Files Created for Long-term Preservation and Access]
*[http://www.freebase.com/view/en/portable_document_format Freebase]

__NOTOC__

Community/Camps/Brooklyn2020

2020-01-02T22:07:17Z

Ablewer: /* Wednesday, April 15: Day One */

Announcing the first Archivematica Con! Archivematica Con hopes to create a broad forum for active Archivematica users across the user community continuum. The 2.5-day meeting will offer a variety of sessions and networking opportunities for beginners as well as well-versed practitioners from libraries and archives to museums. Day 1 will consist of two streams: Artefactual Systems will conduct a boot camp for beginners in Stream 1, while Stream 2 will be geared for practitioners. Day 2 (full day) and Day 3 (half day) will be single-stream session blocks by and for practitioners, although beginners and boot campers are welcome to attend.

== Dates and Location ==

'''April 15-17, 2020 - [https://www.brooklynhistory.org/ Brooklyn Historical Society]'''

== Schedule ==

=== Wednesday, April 15: Day One ===

Day 1 will run from approximately 9am to 5pm and consist of hackathons, workshops, and breakout discussions. Concurrently, Artefactual will run a one-day Archivematica Bootcamp (an Archivematica and Digital Preservation 101 course).

=== Thursday, April 16: Day Two ===

Day 2 will run from approximately 9am to 5pm. In addition to the following sessions, there will be a second room available for breakout discussions.

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Session'''

|-
| rowspan="3" | Morning
| Opening
|-
| Why can't we just fix *all* the things?
AIPing research data: The Dataverse-Archivematica integration
|-
| DIPs with wings: maximizing access to AV collections with Aviary
Managing Your Digital Inheritance: Strategies for Picking Up and Starting New with Archives Direct
|-
| Lunch
| Lunch on your own
|-
| rowspan="3" | Afternoon
| Digital Preservation and Storage in Museums: Sharing Practices
Archivematica and Digital Preservation at the Guggenheim Museum Archives<br/>
Glenstone TBM Workflow<br/>
An Integrated Approach: Piloting a Comprehensive Digital Preservation Workflow at the Whitney Museum<br/>
Preserving The Frick Collection's Photoarchive
|-
| Lightning talks
|-
| Wrap-up
|}
</br>

=== Friday, April 17: Day Three ===

Day 3 will run from approximately 9am to 1pm. In addition to the following sessions, there will be a second room available for breakout discussions.

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Session'''

|-
| rowspan="5" | Morning
| Opening
|-
| SCOPE: An access interface for digital archives
Re-Appraising the Appraisal Tab
|-
| Normalization panel
|-
| Open discussion
|-
| Putting Archivematica on the map: the roadmap, where we’ve been and where we can go
|}
== Registration ==

Registration opens '''Monday, January 6'''

== Program Committee ==

Email the entire program committee at archivematicacon2020@gmail.com. This is a community-driven event, so please reach out to the program committee with any questions or ideas.

* Amy Brost, Assistant Media Conservator, MoMA; amy_brost@moma.org
* Joe Carrano, Digital Archivist, MIT; carrano@mit.edu
* Bonnie Gordon, Digital Archivist, Rockefeller Archive Center; bgordon@rockarch.org
* Stephen Klein, Digital Services Librarian, CUNY Graduate Center; sklein@gc.cuny.edu

== Local arrangements ==

=== Hotel Options ===

[https://www.marriott.com/hotels/travel/nycbk-new-york-marriott-at-the-brooklyn-bridge/ Marriott Brooklyn Bridge]
333 Adams Street, Brooklyn, NY 11201

[https://hamptoninn3.hilton.com/en/hotels/new-york/hampton-inn-brooklyn-downtown-NYCBOHX/index.html Hampton Inn Brooklyn/Downton]
125 Flatbush Ave Extension, Brooklyn, NY 11201

[https://www3.hilton.com/en/hotels/new-york/hilton-brooklyn-new-york-NYCBSHH/index.html Hilton Brooklyn]
140 Schermerhorn Street, Brooklyn, NY 11201

[https://www.nuhotelbrooklyn.com/ NU Hotel Brooklyn]
85 Smith Street, Brooklyn, NY 11201

[https://www.marriott.com/hotels/travel/nycyl-aloft-new-york-brooklyn/ Aloft New York Brooklyn]
216 Duffield Street, Brooklyn, NY 11201

[https://www.ihg.com/hotelindigo/hotels/us/en/brooklyn/bxyid/hoteldetail Hotel Indigo Brooklyn]
229 Duffield Street, Brooklyn, NY 11201

[https://www.marriott.com/hotels/travel/nycys-sheraton-brooklyn-new-york-hotel/ Sheraton Hotel Brooklyn]
228 Duffield Street, Brooklyn, NY 11201

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

== Sponsorship ==

We’re aiming to make Archivematica Con as low-cost as possible, to ensure that we have a variety of Archivematica users. The sponsors of Archivematica Con help make this possible. Sponsors may be acknowledged on the conference program and verbally during the conference. Sponsors may indicate that their contribution is allocated to a specific need, such as hosting a reception, assisting speakers with travel costs, or supporting live streaming or recording sessions. Please contact the program committee to discuss sponsorship opportunities.

== Call for Proposals ==

Submissions closed on October 28, 2019.

=== Topics ===

The program committee invites proposals from Archivematica users in all sectors and cultural institutions (museums, archives, libraries, etc.). Proposals may include, but are not limited to, installation, hosting, configuration, and system integration; documentation and training; workflows, metadata, and pre-processing; normalization, migration, and file obsolescence monitoring; storage; access strategies and DIPs; sustainability and advocacy, and other session types such as hackathons, demos, and more.

''Note: in addition to planned sessions selected by the program committee, there will be opportunities for less formal ad-hoc lightning talks and roundtables.''

=== Submission Formats ===

* '''Presentations''' - A 20-minute talk (e.g., slide presentation), with additional time for Q&A.
* '''Lightning talks''' - A 5-minute talk
* '''Other sessions''' - Talks, panels, workshops, trainings, meetings, discussions or whatever events you care to propose outside of what is listed above.

The submission form requires the following information for different types of proposals:
* '''Presentations''' - Title, Short Description (limit 150 words), Full Proposal Description (limit 500 words), Additional Presenters (if applicable)
* '''Lightning talks''' - Title, Short Description (limit 150 words), Additional Presenters (if applicable)
* '''Other sessions''' - Title, Expected Length of Time (15 minutes to 3 hours), Short Description (limit 150 words), Full Proposal Description (limit 800 words), Additional Presenters (if applicable)

External tools

2019-12-12T15:57:46Z

Ablewer:

[[Main Page]] > [[Documentation]] > External tools

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

=External software tools used in Archivematica=

==Current release==

Archivematica integrates a suite of free and open-source tools that allows users to process digital objects from ingest to access based on the ISO-OAIS functional model. In addition to the core software which is released under AGPL v3 license, the following tools are bundled with Archivematica:

{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:20%"|'''Tool'''
!style="width:40%"|'''Description'''
!style="width:30%"|'''License'''
|-
|-
|[http://www.accesstomemory.org AtoM]
|Web-based archival description and access tool.
|GNU General Public License (GPL)
|-
|[https://github.com/LibraryOfCongress/bagit-java/ BagIt]
|Standard and script to package digital objects and metadata for archival storage
|BSD License
|-
|[https://github.com/simsong/bulk_extractor bulk_extractor]
|Disk image and file contents analysis tool
|Public domain
|-
|[http://www.clamav.net/ Clam AV (anti-virus)]
|Anti-virus toolkit for UNIX
|GNU General Public License (GPL)
|-
|[https://www.djangoproject.com/ Django]
|Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.
|BSD License
|-
|[http://www.elasticsearch.org/ ElasticSearch]
|Indexing and search
|Apache License 2.0
|-
|[http://www.sno.phy.queensu.ca/~phil/exiftool/index.html ExifTool]
|Multimedia metadata extraction
|GNU General Public License and Artistic License
|-
|[http://ffmpeg.org/ FFmpeg]
|Converts a wide variety of audio and video formats
|GNU Lesser General Public License (LGPL)
|-
|[https://github.com/openplanets/fido fido]
|File format identification tool
|Licensed under the Apache License, Version 2.0 (the "License")
|-
|[https://projects.iq.harvard.edu/fits File Information Tool Set (FITS)]
|File format identification and validation software integration tool
|GNU Lesser General Public License (LGPL)
|-
|[http://gearman.org/ Gearman]
|Gearman provides a generic application framework to farm out work to other machines or processes that are better suited to do the work.
|BSD License
|-
|[http://www.imagemagick.org/script/index.php Imagemagick]
|Converts a wide variety of bitmap images
|GPL compatible [http://www.imagemagick.org/script/license.php Imagemagick license]
|-
|[http://www.inkscape.org/ Inkscape]
|Converts vector images to Scalable Vector Graphic (SVG) format
|GNU General Public License (GPL) version 2
|-
|[http://jhove.sourceforge.net/ JHOVE]
|File format validation tool
|GNU Lesser General Public License (LGPL)
|-
|[http://md5deep.sourceforge.net/ md5deep]
|Checksum generation and verification scripts
|GNU General Public License (GPL)
|-
|[https://mediaarea.net/MediaConch MediaConch]
|File policy conformance checker tool
|BSD (2-clause)
|-
|[https://mediaarea.net/en/MediaInfo MediaInfo]
|Multimedia metadata extraction
|BSD (2-clause), Zlib
|-
|[https://pkgs.org/download/nfs-common NFS-common]
|Network File System Access - allows access to files on network storage devices.
|GNU General Public License (GPL)
|-
|[http://p7zip.sourceforge.net/ p7zip]
|7-Zip is a file archiver with a high compression ratio. (LZMA)
|GNU General Public License (GPL)
|-
|[https://lxml.de/ Python-lxml]
|Python binding for libxml2 and libxslt
|GNU General Public License (GPL)
|-
|[https://github.com/richardlehane/siegfried Seigfried]
|File format identification tool
|Licensed under the Apache License, Version 2.0 (the "License")
|-
|[http://www.sleuthkit.org/ Sleuthkit]
|Disk image management and extraction toolkit
|Common Public License / IBM Public License
|-
|[http://code.google.com/p/tesseract-ocr/ Tesseract]
|Optical Character Recognition -read image files and convert to text
|Apache Licence Vesion 2
|-
|[https://ubuntu.com/ Ubuntu Linux]
|Interface with computing hardware. Ubuntu Linux server edition.
|GNU General Public License (GPL)
|-
|[http://www.ossp.org/pkg/lib/uuid/ UUID]
|command line interface (CLI) for the generation of DCE 1.1, ISO/IEC 11578:1996 and IETF RFC-4122 compliant Universally Unique Identifier (UUID).
|GNU General Public License (GPL)
|-
|[http://unarchiver.c3.cx/commandline unar]
|The Unarchiver is an archive unpacker program
|GNU General Public License (GPL)
|-
|[http://manpages.ubuntu.com/manpages/hardy/man1/zip.1.html Zip]
|Utility called by Bagit to create AIP package
|Info-Zip license: "Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely"
|-
|}

</br>

==Past releases==

'''[[Release 1.6.0]]''' (March 2017)

'''[[Release 1.5]]''' (June 2016)

'''[[Release 1.4.1]]''' (June 2015)

'''[[Release 1.4]]''' (May 2015)

'''[[Release 1.3.1]]''' (February 2015)

'''[[Release 1.0]]''' (September 2014)

'''[[Release 0.10-beta]]''' (April 2013)

'''[[Release 0.9-beta]]''' (Aug 2012)

'''[[Release 0.8-alpha]]''' (Jan 2012)

'''[[Release 0.7.1-alpha]]''' (June 2011)

'''[[Release 0.7-alpha]]''' (Feb 2011)

'''[[Release 0.6.2-alpha]]''' (November 2010)

'''[[Release 0.6-alpha]]''' (May 2010)

'''[[Release 0.5-alpha]]''' (November 2009)

'''[[Release 0.4-alpha]]''' (October 2009)

'''[[Release 0.3.5-alpha]]''' (September 2009)

'''[[Release 0.3-alpha]]''' (June 2009)

'''[[Release 0.2-alpha]]''' (May 2009)

'''[[Release 0.1-alpha]]''' (Feb 2009)

Main Page

2019-12-11T20:29:28Z

Ablewer: /* Community */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]
*[https://twitter.com/archivematica Twitter]

</div>
</div>

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-12-11T20:29:10Z

Ablewer: /* Community */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]
*[https://twitter.com/archivematica Twitter]

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-12-11T20:28:45Z

Ablewer: /* Twitter */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]
*[https://twitter.com/archivematica Twitter]

</div>

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-12-11T20:28:34Z

Ablewer: /* Community */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]
*[https://twitter.com/archivematica Twitter]

</div>

== Twitter ==

{{#widget:Twitter Search}}

</div>

<div class="news">

</div>

</div><div style="overflow: hidden;">

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-12-11T20:26:57Z

Ablewer: /* Free Demo and Download */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/latest/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]

</div>

<div class="twitter">

== Twitter ==

{{#widget:Twitter Search}}

</div>

<div class="news">

</div>

</div><div style="overflow: hidden;">

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Getting started

2019-12-11T20:25:26Z

Ablewer: /* Projects */

[[Main Page]] > [[Development]] > [[:Category:Development documentation|Development documentation]] > Getting Started

This wiki page describes getting started with Archivematica as a developer. For user and administrative manuals, please see http://www.archivematica.org.

== Vital Stats ==

* Language: Python (primarily)
* License: [https://en.wikipedia.org/wiki/Affero_General_Public_License AGPL]
* VCS: git
* Major libraries: [https://www.djangoproject.com/ Django], [http://gearman.org/ gearman] ([https://pythonhosted.org/gearman/ Python API])
* [[Contribute_code|Contribution guidelines]]
** [[Contribute_code#Code_Style_Guide_For_Archivematica|Coding style]]

== Projects ==

Archivematica consists of several projects working together.

* [https://github.com/artefactual/archivematica Archivematica]: Main repository containing the user-facing dashboard, task manager MCPServer and clients scripts for the MCPClient
* [https://github.com/artefactual/archivematica-storage-service Storage Service]: Responsible for moving files to Archivematica for processing, and from Archivematica into storage

There are also several smaller repositories that support Archivematica in various ways. In general, you will not need these to develop on Archivematica.

* [https://github.com/artefactual/archivematica-devtools Development tools]: Scripts to help with development. E.g. restarting services, workflow analysis
* [https://github.com/artefactual/archivematica-fpr-tools FPR tools]: All the tools, commands and rules used to populate the FPR database. Changes to the FPR should be submitted here.
* [https://github.com/artefactual/archivematica-docs Archivematica Documentation]: Documentation found at https://www.archivematica.org/en/docs/ for Archivematica
* [https://github.com/artefactual/archivematica-storage-service-docs Storage Service Documentation]: Documentation found at https://www.archivematica.org/en/docs/ for the Storage Service
* [https://github.com/artefactual/automation-tools Automation Tools]: Scripts used to automate processing material through Archivematica
* [https://github.com/artefactual/deploy-pub Deployment]: Ansible scripts for deploying and configuring Archivematica
* [https://github.com/artefactual-labs/ansible-archivematica Deployment-Archivematica]: Ansible playbook for Archivematica package install.
* [https://github.com/artefactual-labs/ansible-role-archivematica-src Deployment-Archivematica-dev]: Ansible playbook for Archivematica github install.
* [https://github.com/artefactual/fixity Fixity checker]: Commandline tool that assists in checking fixity for AIPs stored in Archivematica Storage Service instances.
* [https://github.com/artefactual-labs/mets-reader-writer METS reader/writer]: Library to create and parse METS files.
* [https://github.com/artefactual-labs/agentarchives agentarchives]: Clients to retrieve, add, and modify records from archival management systems.
* [https://github.com/artefactual/archivematica-sampledata Sample data]: Data to test and show off Archivematica's processing
* [https://github.com/artefactual/archivematica-history History]: Contains the pre-git history of Archivematica. Useful for checking the origins of code.

== Installation ==

The recommended way to install Archivematica for development is with Ansible and Vagrant.

Alternatively, you can try our environment based on Docker Compose - see https://github.com/artefactual-labs/am/tree/master/compose.

=== Ansible & Vagrant ===

The following instructions detail how to install and run Archivematica from source on a virtual machine.
# Install VirtualBox, Vagrant, and Ansible with the following commands:
#* <code>sudo apt-get install virtualbox vagrant</code> (this is the command for Ubuntu; if you use Mac or a different Linux distribution, it may be slightly different).
#** Note: Vagrant must be at least 1.5 (it can also be downloaded from [https://www.vagrantup.com/downloads.html vagrantup.com]). Check your version with <code>vagrant --version</code>.
#* <code>sudo pip install -U ansible</code>
# Checkout the deployment repo:
#* <code>git clone https://github.com/artefactual/deploy-pub.git</code>
# Download the Ansible roles:
#* <code>cd deploy-pub/playbooks/archivematica</code>
#* <code>ansible-galaxy install -f -p roles/ -r requirements.yml</code>
# (Optional) Change the branch by opening the file <code>vars-singlenode.yml</code> and modifying the following:
#* <code>archivematica_src_am_version: "branch-name"</code>
#* <code>archivematica_src_ss_version: "branch-name"</code>
# Create the virtual machine and provision it:
#* <code>vagrant up</code> (it takes a while!)
# You can now log in to your virtual machine:
#* <code>vagrant ssh</code>
# You can now access the following services in a web browser:
#* Archivematica - http://192.168.168.192
#* Archivematica Storage Service: http://192.168.168.192:8000

You may also wish to do the following.
# Provisioning (via ansible) can be re-run with vagrant to update the code on the server (for example, if new features are added):
#* <code>vagrant provision</code>
# To re-deploy a new branch to the same VM, update the branch variables in <code>vars-singlenode.yml</code>:
#* <code>archivematica_src_am_version: "branch-name"</code>
#* <code>archivematica_src_ss_version: "branch-name"</code>
#** This will probably require resetting the Archivematica installation as well. This can be done by adding variables to <code>vars-singlenode.yml</code>
#* <code>archivematica_src_reset_am_all: "true"</code> This will reset the Archivematica database, clear ElasticSearch and clear shared directories
#* <code>archivematica_src_reset_ss_db: "true"</code> This will reset the Storage Service database
#* For more variables to control deployment, see the [https://github.com/artefactual-labs/ansible-role-archivematica-src/blob/master/README.md README]
# See also the FAQ below

=== Alternative Vagrant projects ===

Community-provided alternatives have also been developed.

*https://github.com/emltech/eml-archivematica-vagrant
*https://github.com/statsbiblioteket/archivematica-vagrant

== Tests ==

Archivematica and the related projects have a small but growing test suite. We use [http://pytest.org/ py.test] to run our tests, which should be listed as a requirement in the development/local requirements file.

To run the tests, go to the repository root and run <code>py.test</code>

See below for project-specific setup or changes to running the tests.

=== Archivematica ===

Before running Archivematica tests, set the following environment variable. Archivematica does not currently have a virtualenv that needs to be activated.

<pre>
#!/usr/bin/fish
set -xg PYTHONPATH /usr/share/archivematica/dashboard/:/usr/lib/archivematica/archivematicaCommon/
</pre>

<pre>
#!/usr/bin/bash
export PYTHONPATH=$PYTHONPATH:/usr/share/archivematica/dashboard/:/usr/lib/archivematica/archivematicaCommon/
</pre>

=== Storage Service ===

Before running Storage Service tests, activate the virtualenv and set the following environment variables. The tests should be run from the <code>storage_service</code> directory. This is the same directory that contains <code>manage.py</code>. You may need to install <code>requirements/test.txt</code> to install testing dependencies.

<pre>
#!/usr/bin/fish
set -xg PYTHONPATH (pwd)/storage_service # This directory contains manage.py
set -xg DJANGO_SETTINGS_MODULE storage_service.settings.test
set -xg DJANGO_SECRET_KEY 'ADDKEY'
</pre>
<pre>
#!/usr/bin/bash
export PYTHONPATH=$(pwd)/storage_service # This directory contains manage.py
export DJANGO_SETTINGS_MODULE=storage_service.settings.test
export DJANGO_SECRET_KEY='ADDKEY'
</pre>

== FAQ ==

=== How do I restart everything in Archivematica? ===

A default install using Ansible also installs the devtools. Run <code>am restart-services</code> to restart all services related to Archivematica and the storage service.

=== How do I restart just the dashboard? ===

<code>sudo /etc/init.d/apache2 start</code> or <code>sudo service apache2 restart</code>

=== How do I restart the storage service? ===

<code>sudo service uwsgi restart</code>

=== How do I restart nginx? ===

<code>sudo service uwsgi restart</code>
<code>sudo service nginx restart</code>

=== How do I update or reset an ansible install? ===

To update an install, re-run <code>vagrant provision</code>. If you only want to run part of the ansible tasks, you can use ansible's tags, for example: <code>env ANSIBLE_ARGS="--tags=amsrc-ss-code" vagrant provision</code> More tags are documented in the [https://github.com/artefactual-labs/ansible-role-archivematica-src ansible repo]

To reset an install (delete all existing data like a fresh install) you can use ansible's role variables. For example: <code>env ANSIBLE_ARGS="--extra-vars=archivematica_src_reset_ss_db=true" vagrant provision</code> will reset the storage service database. More role variables are documented in the [https://github.com/artefactual-labs/ansible-role-archivematica-src ansible repo]

The other way to control a deployment is to modify the Vagrantfile and vars-singlenote.yml files directly. Tags can be provided in the Vagrantfile. For example:
<pre>
# ... more above
# Ansible provisioning
config.vm.provision :ansible do |ansible|
ansible.playbook = "./singlenode.yml"
ansible.host_key_checking = false
# ansible.verbose = "v"
ansible.extra_vars = {
"archivematica_src_dir" => "/srv",
"archivematica_src_environment_type" => "development",
}
ansible.raw_arguments = ENV['ANSIBLE_ARGS']
ansible.tags = ['amsrc-pipeline']
end
# ... more below
</pre>

Role variables can be modified in vars-singlenote.yml. Default values are found in the Archivematica role (in <code>roles/archivematica-src/defaults/main.yml</code>). For example:

<pre>
---

# archivematica-src role

# What to install
archivematica_src_install_devtools: "yes"
archivematica_src_install_automationtools: "yes"
# archivematica_src_install_appraisaltab: "yes"

# SS django environment variables
archivematica_src_ss_env_django_setings_module: "storage_service.settings.local"

# Branches,
archivematica_src_am_version: "qa/1.x"
archivematica_src_ss_version: "qa/0.x"
# archivematica_src_devtools_version: "master"
# archivematica_src_automationtools_version: "master"

# Reset
# archivematica_src_reset_mcpdb: "true"
# archivematica_src_reset_shareddir: "true"
# archivematica_src_reset_es: "true"
archivematica_src_reset_am_all: "true"
archivematica_src_reset_ss_db: "true"

</pre>

=== How do I activate the Storage Service virtualenv? ===

<code>source /usr/share/python/archivematica-storage-service/bin/activate</code>

The location of the virtualenv is configured as part of the ansible install, which by default is <code>/usr/share/python/archivematica-storage-service</code> Sourcing the activate script should modify the prompt to display <code>(archivematica-storage-service)vagrant@am-local</code>. Note that if you're running fish, the activate script will not work; you may want to look in to [http://virtualfish.readthedocs.io/en/latest/ virtualfish].

You will also want to set environment variables as described in the storage service testing section.

== Documentation ==

Developer facing documentation can be found in the [[:Category:Development documentation|Development documentation]] category. Notable pages include:

* [[MCPServer]]
* [[MCPClient]]
* [[Storage Service]]
* [[Storage Service API]]
* [[Archivematica API]]

[[Category:Development documentation]]

Archivematica 0.7.1 Micro-services

2019-12-11T20:15:10Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 0.7.1 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|Create SIP backup
|Creates a backup of the SIP. By default these are stored in /sharedDirectoryStructure/SIPbackups/. The backups are automatically removed at the end of SIP processing, when the AIP has been moved to archival storage.
|-
|Verify SIP compliance
|Verify that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/logs/fileMeta/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
|Assign file UUIDs and checksums
|Assigns file UUIDs and generates checksums for each file in the /objects/ directory. This step also creates the PREMIS files located in the /logs/fileMeta/ directory. The files in this directory are named based on the fileUUID of the file they represent.
|-
|Verify metadata directory checksums
|Checks any checksum files that were placed in the /metadata/ folder of the SIP prior to ingest. Note that the filenames need to be named based on their algorithm: ''checksum.sha1'', ''checksum.sha256'', ''checksum.md5''.
|-
|Remove thumbs.db files
|Removes any [http://en.wikipedia.org/wiki/Windows_thumbnail_cache Thumbs.db] files. May be expanded to others in future releases.
|-
|Create Dublin Core template
|If the ingested SIP does not already contain one, a Dublin Core xml template is added to the ''/metadata/'' folder in the SIP. The user can fill in fields as desired. These values are uploaded to the access system as part of the DIP created by Archivematica.
|-
|Set file permissions
|Changes file permissions on the SIP to allow the user to modify the SIP contents.
|-
|Appraise SIP for submission
|Manual approval step. Review the SIP to confirm that it conforms to any submission agreements and remove files and folders if desired. Do not move or rename files or folders as this will cause them to be excluded from the AIP.
|-
|Scan for removed files post appraise SIP for submission
|Checks to see if any files were deleted and creates a list of them at ''/logs/removedFilesAppraiseSIPForSubmission.log''.
|-
|Place in quarantine
|Places SIP in quarantine for a pre-set period of time. The purpose of this is to allow time for new viruses to be identified, and antivirus groups to update their virus definitions. Note: for demonstration purposes, the quarantine period is set to a minute.
|-
|Remove from quarantine
|Archivematica uses a cron job to periodically check for SIPs that have met the configured quarantine time. Keeping in mind the purpose of the quarantine period, if you know the virus definitions are up to date for any virus possibly contained in the SIP (eg. The SIP source is a cd from 4 years ago) then you can remove it from quarantine manually.
|-
|Extract packages
|Extracts objects from any zipped files or other packages.
|-
|Sanitize file and directory names
|Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
|Scan for viruses
|Uses [http://www.clamav.net/lang/en/ ClamAV], parses the output and creates a PREMIS event. If a virus is found, the SIP is automatically placed in ''/sharedPath/watchedDirectories/failed/''.
|-
|Characterize and extract metadata
|Identifies and validates formats and extracts object metadata using the [http://code.google.com/p/fits/ File Information Tool Set (FITS)]. Adds output to the PREMIS files.
|-
|Set file permissions
|Changes file permissions on the SIP to allow the user to modify the SIP contents.
|-
|Appraise SIP for preservation
|Manual approval step. If desired, appraise SIP contents for preservation and delete any unwanted files and folders. Do not move or rename files or folders as this will cause them to be excluded from the AIP. Note: in future releases, appraisal decisions at this point will be assisted by a summary of technical information about the files (format, validation status, characteristics such as compression etc.).
|-
|Scan for removed files post appraise SIP for preservation
|Checks to see if any files were deleted and creates a list of them at ''/logs/removedFilesAppraiseSIPForPreservation.log''.
|-
|Create DIP directory
|Creates a directory for access copies of the ingested files.
|-
|Normalize
|Creates preservation copies and access copies of the ingested files based on rules in the transcoder database. These rules can be seen under the '''Preservation planning''' tab in the Archivematica dashboard. Adds access copies to the DIP directory.
|-
|Set file permissions
|Changes file permissions on the SIP to allow the user to modify the SIP contents.
|-
|Approve normalization
|Manual approval step. This micro-service allows for manual normalization. See [[0.7.1_How-To#Manual_Normalization]]. Note that the user cannot delete normalized files: see issue 678.
|-
|Check for submission documentation
|Checks for files in ''metadata/submissionDocumentation/''; if folder is empty, creates a log file indicating that no submission documentation was included in the SIP.
|-
|Move Submission Documentation into objects directory
|Moves the ''/submissionDocumentation/'' directory from ''/metadata/'' to ''/objects/'' for ingest processing.
|-
|Assign file UUIDs and checksums to submission documentation
|See Assign file UUIDs and checksums, above.
|-
|Extract packages in submission documentation
|See Extract packages, above.
|-
|Sanitize file and directory names in submission documentation
|See Sanitize file and directory names, above.
|-
|Scan for viruses in submission documentation
|See Scan for viruses, above.
|-
|Characterize and extract metadata in submission documentation
|See Characterize and extract metadata, above.
|-
|Normalize submission documentation
|See Normalize, above. No access copies are made since the submission documentation is not included in the DIP.
|-
|Remove files without PREMIS
|Removes any files in the ''/objects/'' directory that don't have PREMIS entries. This is done because some normalizations that fail will still leave behind artifacts/files (for example, 0 byte files) that don't belong in the AIP.
|-
|Verify PREMIS checksums
|Verifies the checksums assigned at ingest to ensure that the files have not been modified while being processed by Archivematica.
|-
|Compile METS
|Creates a ''METS.xml'' file using the PREMIS files in ''/logs/fileMeta/''.
|-
|Add Dublin Core to METS
|Adds the ''/metadata/dublincore.xml'' file to the ''METS.xml'' file.
|-
|Copy METS to DIP directory
|Creates a copy of the ''METS.xml'' file in the DIP directory.
|-
|Generate DIP
|Moves the DIP directory out of the SIP and into another Archivematica watched directory.
|-
|Set file permissions
|Changes file permissions on the DIP to allow the user to modify the DIP contents.
|-
|Prepare AIP
|Packages the SIP into an AIP using [http://sourceforge.net/projects/loc-xferutils/ BagIt]
|-
|Upload DIP
|Uploads the DIP to the access system ([http://www.ica-atom.org ICA-AtoM]). Removes the UUID from the filename as the upload title, but original filename still contains this UUID so it can be traced back to the file in the AIP.
|-
|Store AIP
|Moves the AIP to a specified directory. In the demo version of Archivematica the directory is ''/sharedDirectoryStructure/www/AIPsStore/''. In other environments it can be a remote network mounted directory. The directory structure of the AIP store contains UUID quad directories and an ''index.html'' file listing the AIPs in storage. The ''index.html'' file is displayed in the dashboard in the '''Archival storage''' tab. </br>
Once the AIP has been stored, a copy of the AIP is extracted from storage to a local temp directory, and is validated with the various BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}
</br>
</br>

==Archivematica 0.7.1 micro-services: additional micro-services for ingested bags==

For the 0.7.1 release we are alpha testing the ingest of bags compliant with the [https://wiki.ucop.edu/display/Curation/BagIt BagIt] specification. If a bag is dropped into ''/receiveBAG/'' the following micro-services are immediately run:

{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|Verify BAG
|Runs the various bagit checks: verifyvalid, checkpayloadoxum, verifycomplete , verifypayloadmanifests, verifytagmanifests
|-
|Restructure BAG
|Restructures bag into the Archivematica-compliant SIP format: the structure is as follows: ''/logs/'', ''/logs/fileMeta/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
|}

Archivematica 0.8 Micro-services

2019-12-11T20:14:52Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 0.8 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

This page describes the key micro-services that are undertaken during transfer and ingest.

=Transfer=

{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|Approve transfer
|Once the transfer has all its digital objects and has been formatted for processing, the user selects "Transfer complete" from the Actions drop-down menu.
|-
|Verify transfer compliance
|Verifies that the transfer conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
|Rename with transfer UUID
|Adds a unique universal identifier to the transfer folder name.
|-
|Include default Transfer processingMCP.xml
|Adds ''defaultTransferProcessing.xml'' file from ''/sharedDirectoryStructure/sharedMicroServiceTasksConfigs/'' to the transfer directory. This xml file can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
|Workflow decision - create transfer backup
|The user can choose to create a complete backup of the transfer in case transfer or ingest are interrupted or fail. The transfer backup is placed in ''/sharedDirectoryStructure/transferBackups/'' and will automatically be deleted once the AIP has been moved into storage.
|-
|Assign file UUIDs to objects
|Assigns a unique universal identifier to each file in the ''/objects/'' directory.
|-
|Assign checksums and file sizes to objects
|Assigns a sha-256 checksum to each file in the ''/objects/'' directory and calculates file sizes.
|-
|Verify metadata directory checksums
|Checks any checksum files that were placed in the /metadata/ folder of the SIP prior to ingest. Note that the filenames need to be named based on their algorithm: ''checksum.sha1'', ''checksum.sha256'', ''checksum.md5''.
|-
|Generate METS.xml document
|Generates a basic mets file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their location in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. The mets file is automatically added to any SIP generated from the transfer.
|-
|Extract packages
|Extracts objects from any zipped files or other packages.
|-
|Scan for viruses
|Uses [http://www.clamav.net/lang/en/ ClamAV], parses the output and creates a PREMIS event. If a virus is found, the SIP is automatically placed in ''/sharedDirectoryStructure/failed/''.
|-
|Sanitize object's file and directory names
|Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
|Sanitize transfer name
|Same as above except does it for the transfer folder name.
|-
|Characterize and extract metadata
|Identifies and validates formats and extracts object metadata using the [http://code.google.com/p/fits/ File Information Tool Set (FITS)]. Adds output to the PREMIS metadata.
|-
|Create SIP(s)
|The user chooses among a number of SIP creation options. See the [[UM ingest|user manual]] for details.
|-
|}
</br>

=Ingest=

{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|Verify SIP compliance
|Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
|Rename SIP directory with SIP UUID
|Adds a unique universal identifier to the SIP folder name.
|-
|Include default SIP processingMCP.xml
|Adds ''defaultSIPProcessing.xml'' file from ''/sharedDirectoryStructure/sharedMicroServiceTasksConfigs/'' to the transfer directory. This xml file canbe used to configure SIP workflow options.
|-
|Remove thumbs.db files
|Removes any [http://en.wikipedia.org/wiki/Windows_thumbnail_cache Thumbs.db] files. May be expanded to others in future releases.
|-
|Sanitize object's file and directory names
|If user created new folder and/or file names during SIP creation, any prhobited characters are removed from these names and replaced with dashes.
|-
|Sanitize SIP name
|Same as above except that it's done for the SIP folder name.
|-
|Check for Service directory
|For digitization output workflows, checks to see if the SIP contains any service copies of master files. See the [[UM digitization output|user manual]] for details.
|-
|Check for Access directory
|For digitization output workflows, checks to see if the SIP contains any access copies of master files. See the [[UM digitization output|user manual]] for details.
|-
|Normalize
|The user can choose to create preservation and/or access copies of the ingested files based on rules in the transcoder database. These rules can be seen under the '''Preservation planning''' tab in the Archivematica dashboard.
|-
|Normalize access
|Creates access copies to be added to the DIP.
|-
|Normalize preservation
|Creates preservation copies to be included in the AIP along with the original files.
|-
|Approve normalization
|If desired, the user can verify the quality of normalized files in ''/sharedDirectoryStructure/watchedDirectories/approveNormalization/''.
|-
|Check for submission documentation
|Checks for files in ''/metadata/submissionDocumentation/''.
|-
|Move submission documentation to objects directory
|Moves the ''/submissionDocumentation/'' directory from ''/metadata/'' to ''/objects/'' for ingest processing.
|-
|Assign file UUIDs to submission documentation
|Assigns a unique universal identifier to each file in the ''/objects/submissionDocumentation/'' directory.
|-
|Assign checksums and filesizes to submission documentation
|Assigns a sha-256 checksum to each file in the ''/objects/submissionDocumentation'' directory and calculates file sizes.
|-
|Extract packages in submission documentation
|Extracts objects from any zipped files or other packages in the ''/objects/'' directory.
|-
|Characterize and extract metadata on submission documentation
|Identifies and validates formats and extracts object metadata for files in the ''/objects/submissionDocumentation'' directory using the [http://code.google.com/p/fits/ File Information Tool Set (FITS)]. Adds output to the PREMIS metadata.
|-
|Normalize submission documentation to preservation format
|Creates preservation copies of all files in the ''/objects/submissionDocumentation'' directory to be included in the AIP along with the original files.
|-
|Verify checksums generated on ingest
|Verifies checksums that were generated during transfer processing to ensure that the files have not been corrupted during transfer or ingest.
|-
|Remove empty directories
|Removes any empty directories from the SIP.
|-
|Generate METS.xml document
|Generates a METS file with PREMIS metadata. For more information on the METS file, see [[METS]].
|-
|Copy transfers metadata and logs
|Copies all submission documentation included in the original transfer to the SIP. Copies all logs generated during transfer processing to the SIP.
|-
|Copy METS to DIP directory
|Creates a copy of the METS file in the DIP directory.
|-
|Generate DIP
|Moves the DIP to the DIP upload directory.
|-
|Upload DIP
|The user uploads the DIP to a selected description in the access system. See the [[UM access|user manual]] for details.
|-
|Prepare AIP
|Packages the SIP into an AIP using [http://sourceforge.net/projects/loc-xferutils/ BagIt]
|-
|Compress AIP
|Losslessly compresses the AIP for storage using [http://p7zip.sourceforge.net/ p7zip].
|-
|Store AIP
|Moves the AIP to a specified directory. In the demo version of Archivematica the directory is ''/sharedDirectoryStructure/www/AIPsStore/''. In other environments it can be a remote network mounted directory. The directory structure of the AIP store contains UUID quad directories and an ''index.html'' file listing the AIPs in storage. The ''index.html'' file is displayed in the dashboard in the '''Archival storage''' tab. </br>
Once the AIP has been stored, a copy of the AIP is extracted from storage to a local temp directory, and is validated with the various BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

Archivematica 0.9 Micro-services

2019-12-11T20:14:34Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 0.9 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

A micro-service may consist of a number of discrete tasks, or jobs. In the Archivematica 0.9 dashboard, micro-services are always shown, while jobs may be viewed by expanding the micro-service (i.e. by clicking on the grey background behind the micro-service name).

</br>

[[Image:Micro-services.png|600px|center|thumb|Arhivematica dashboard showing a micro-service and its jobs]]

</br>

The table below shows micro-services and jobs in Archivematica 0.9. Note that this is is only a list of micro-services; detailed user instructions are available in the [[User manual 0.9|user manual]].
</br>
=Transfer=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve Transfer'''<div class="mw-collapsible-content">
Set file permissions
</div>
</div>
| This is the approval step that moves the transfer into the Archivematica processing pipeline.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Set transfer type
<br/>Remove hidden files and directories
<br/>Attempt restructure for compliance
<br/>Verify transfer compliance
</div>
</div>
| Moves the transfer to a processing directory based on selected transfer type (standard, zipped bag, unzipped bag, DSPace export or maildir). Verifies that the transfer conforms to the folder structure required for processing in Archivematica and restructures if required. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename with transfer UUID'''<div class="mw-collapsible-content">
<br/>Rename with transfer UUID
</div>
</div>
| Directly associates the transfer with its metadata by appending the transfer UUID to the transfer directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default Transfer processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default Transfer processingMCP.xml
</div>
</div>
| Adds a file named processingMCP.xml to the root of the transfer. This is a configurable xml file to pre-configure processing decisions. It can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Assign file UUIDs and checksums'''<div class="mw-collapsible-content">
<br/>Assign file UUIDs to objects
<br/>Assign checksums and file sizes to objects
</div>
</div>
| Assigns a unique universal identifier and sha-256 checksum to each file in the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer checksums'''<div class="mw-collapsible-content">
<br/>Verify metadata directory checksums
</div>
</div>
| Checks any checksum files that were placed in the ''/metadata/'' folder of the transfer prior to moving the transfer into Archivematica.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate METS.xml document'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates a basic METS file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their locations in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. A copy of the METS file is automatically added to any SIP generated from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Extract packages'''<div class="mw-collapsible-content">
<br/>Extract packages
<br/>Extract attachments
</div>
</div>
| Extracts objects from any zipped files or other packages. Extracts attachments from maildir transfers.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Scan for viruses'''<div class="mw-collapsible-content">
<br/>Scan for viruses
</div>
</div>
| Uses ClamAV to scan for viruses and other malware. If a virus is found, the transfer is automatically placed in ''/sharedDirectoryStructure/failed/'' and all processing on the transfer is stopped.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize object's file and directory names
<br/>Sanitize Transfer name
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Characterize and extract metadata'''<div class="mw-collapsible-content">
<br/>Characterize and extract metadata
<br/>Identify Files ByExtension
<br/>Load labels from metadata/file_labels.csv
</div>
</div>
| Identifies and validates formats and extracts object metadata using the File Information Tool Set (FITS). Also identifies file extensions, which are used for selecting normalization paths.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Complete transfer'''<div class="mw-collapsible-content">
<br/>Index transfer contents
<br/>Set file permissions
<br/>Move to completedTransfers directory
</div>
</div>
| Indexes transfer contents, then marks the transfer as complete.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Create SIP from Transfer'''<div class="mw-collapsible-content">
<br/>Check transfer directory for objects
<br/>Create SIP(s)
<br/>Create SIP from transfer objects
</div>
</div>
| This is the approval step that moves the transfer to the SIP packaging micro-services (Ingest).
|-
|}
</br>

=Ingest=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify SIP compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Verify SIP compliance
</div>
</div>
| Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename SIP directory with SIP UUID'''<div class="mw-collapsible-content">
<br/>Rename SIP directory with SIP UUID
</div>
</div>
| Directly associates the SIP with its metadata by appending the SIP UUID to the SIP directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default SIP processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default SIP processingMCP.xml
</div>
</div>
| Copies the processing config file added to the transfer in '''Include default Transfer processingMCP.xml''', above, to the SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Remove cache files'''<div class="mw-collapsible-content">
<br/>Remove cache files
</div>
</div>
| Removes any Thumbs.db files.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Normalize'''<div class="mw-collapsible-content">
<br/>Check for Service directory
<br/>Check for Access directory
<br/>Find options to normalize as
<br/>Create DIP directory
<br/>Normalize
<br/>Normalize access
<br/>Normalize preservation
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Create thumbnails directory
<br/>Normalize thumbnails
<br/>Verify checksums generated on ingest
<br/>Approve normalization
</div>
</div>
| Determines which normalization options are available for the SIP and presents them to the user as choices. Normalizes (i.e. generates preservation and/or access copies) based on selection. Thumbnail files are also generated during this micro-service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process submission documentation'''<div class="mw-collapsible-content">
<br/>Check for submission documentation
<br/>Copy transfer submission documentation
<br/>Move to processing directory
<br/>Set file permissions
<br/>Assign file UUIDs to submission documentation
<br/>Assign checksums and file sizes to submissionDocumentation
<br/>Extract packages in submission documentation
<br/>Sanitize file and directory names in submission documentation
<br/>Scan for viruses in submission documentation
<br/>Characterize and extract metadata on submission documentation
<br/>Identify Files ByExtension
<br/>Normalize submission documentation to preservation format
</div>
</div>
| Processes any submission documentation included in the SIP and adds it to the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare DIP'''<div class="mw-collapsible-content">
<br/>Copy thumbnails to DIP directory
<br/>Copy METS to DIP directory
<br/>Set file permissions
<br/>Generate DIP
</div>
</div>
| Creates a DIP containing access copies of the objects, thumbnails and a copy of the METS file.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
</div>
</div>
| Allows the user to choose to upload the DIP to either ICA-AtoM or CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to ICA-AtoM'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in ICA-AtoM.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to CONTENTdm'''<div class="mw-collapsible-content">
<br/>Restructure DIP for CONTENTdm upload
<br/>Select upload type (Project Client or direct upload)
<br/>Select target CONTENTdm server
<br/>Get list of collections on server
<br/>Select destination collection
<br/>Upload DIP to contentDM
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare AIP'''<div class="mw-collapsible-content">
<br/>Copy transfers metadata and logs
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Verify checksums generated on ingest
<br/>Generate METS.xml document
<br/>Index AIP contents
<br/>Prepare AIP
<br/>Select compression algorithm
<br/>Select compression level
<br/>Compress AIP
<br/>Set bag file permissions
<br/>Removed bagged files
</div>
</div>
| Creates an AIP in Bagit format. Indexes the AIP, then losslessly compresses it.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store AIP'''<div class="mw-collapsible-content">
<br/>Move to the store AIP approval directory
<br/>Store AIP
<br/>Store AIP location
<br/>Store the AIP
</div>
</div>
| Moves the AIP to ''/sharedDirectoryStructure/www/AIPsStore/'' or another specified directory. Once the AIP has been stored, a copy of it is extracted from storage to a local temp directory, where it is subjected to standard BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

Archivematica 0.10 Micro-services

2019-12-11T20:14:15Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 0.10 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

A micro-service may consist of a number of discrete tasks, or jobs. In the Archivematica 0.10 dashboard, micro-services are always shown, while jobs may be viewed by expanding the micro-service (i.e. by clicking on the grey background behind the micro-service name).

</br>

[[Image:NormPresAccess-10.png|600px|center|thumb|Arhivematica dashboard showing a micro-service and its jobs]]

</br>

The table below shows micro-services and jobs in Archivematica 0.10. Note that this is is only a list of micro-services; detailed user instructions are available in the [[User manual 0.10|user manual]].
</br>
=Transfer=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve Transfer'''<div class="mw-collapsible-content">
Set file permissions
</div>
</div>
| This is the approval step that moves the transfer into the Archivematica processing pipeline.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Set transfer type
<br/>Remove hidden files and directories
<br/>Attempt restructure for compliance
<br/>Verify transfer compliance
</div>
</div>
| Moves the transfer to a processing directory based on selected transfer type (standard, zipped bag, unzipped bag, DSPace export or maildir). Verifies that the transfer conforms to the folder structure required for processing in Archivematica and restructures if required. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename with transfer UUID'''<div class="mw-collapsible-content">
<br/>Rename with transfer UUID
</div>
</div>
| Directly associates the transfer with its metadata by appending the transfer UUID to the transfer directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default Transfer processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default Transfer processingMCP.xml
</div>
</div>
| Adds a file named processingMCP.xml to the root of the transfer. This is a configurable xml file to pre-configure processing decisions. It can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Assign file UUIDs and checksums'''<div class="mw-collapsible-content">
<br/>Assign file UUIDs to objects
<br/>Assign checksums and file sizes to objects
</div>
</div>
| Assigns a unique universal identifier and sha-256 checksum to each file in the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer checksums'''<div class="mw-collapsible-content">
<br/>Verify metadata directory checksums
</div>
</div>
| Checks any checksum files that were placed in the ''/metadata/'' folder of the transfer prior to moving the transfer into Archivematica.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate METS.xml document'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates a basic METS file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their locations in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. A copy of the METS file is automatically added to any SIP generated from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Extract packages'''<div class="mw-collapsible-content">
<br/>Extract packages
<br/>Extract attachments
</div>
</div>
| Extracts objects from any zipped files or other packages. Extracts attachments from maildir transfers.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Scan for viruses'''<div class="mw-collapsible-content">
<br/>Scan for viruses
</div>
</div>
| Uses ClamAV to scan for viruses and other malware. If a virus is found, the transfer is automatically placed in ''/sharedDirectoryStructure/failed/'' and all processing on the transfer is stopped.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Quarantine'''<div class="mw-collapsible-content">
<br/>Workflow decision - send transfer to quarantine
<br/>Move to quarantine
<br/>Remove from quarantine
</div>
</div>
| Quarantine's the transfer for a set duration, to allow virus definitions to update, before virus scan.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize object's file and directory names
<br/>Sanitize Transfer name
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Characterize and extract metadata'''<div class="mw-collapsible-content">
<br/>Characterize and extract metadata
<br/>Identify Files ByExtension
<br/>Load labels from metadata/file_labels.csv
</div>
</div>
| Identifies and validates formats and extracts object metadata using the File Information Tool Set (FITS). Also identifies file extensions, which are used for selecting normalization paths.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Complete transfer'''<div class="mw-collapsible-content">
<br/>Index transfer contents
<br/>Set file permissions
<br/>Move to completedTransfers directory
</div>
</div>
| Indexes transfer contents, then marks the transfer as complete.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Create SIP from Transfer'''<div class="mw-collapsible-content">
<br/>Check transfer directory for objects
<br/>Create SIP(s)
<br/>Create SIP from transfer objects
<br/>Send transfer to backlog
</div>
</div>
| This is the approval step that moves the transfer to the SIP packaging micro-services (Ingest).
|-
|}
</br>

=Ingest=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify SIP compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Verify SIP compliance
</div>
</div>
| Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename SIP directory with SIP UUID'''<div class="mw-collapsible-content">
<br/>Rename SIP directory with SIP UUID
</div>
</div>
| Directly associates the SIP with its metadata by appending the SIP UUID to the SIP directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default SIP processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default SIP processingMCP.xml
</div>
</div>
| Copies the processing config file added to the transfer in '''Include default Transfer processingMCP.xml''', above, to the SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Remove cache files'''<div class="mw-collapsible-content">
<br/>Remove cache files
</div>
</div>
| Removes any Thumbs.db files.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Normalize'''<div class="mw-collapsible-content">
<br/>Identify manually normalized files
<br/>Check for Service directory
<br/>Check for Access directory
<br/>Find options to normalize as
<br/>Create DIP directory
<br/>Normalize
<br/>Normalize access
<br/>Normalize preservation
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Create thumbnails directory
<br/>Normalize thumbnails
<br/>Verify checksums generated on ingest
<br/>Approve normalization
<br/>Check for manual normalized files
<br/>Move access files to DIP
<br/>Assign UUIDs to manually normalized preservation files
<br/>Assign checksums to manually normalized preservation files
<br/>Run FITS on manually normalized preservation files
<br/>Relate manually normalized preservation files to the original files
</div>
</div>
| Determines which normalization options are available for the SIP and presents them to the user as choices. Normalizes (i.e. generates preservation and/or access copies) based on selection. Thumbnail files are also generated during this micro-service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process submission documentation'''<div class="mw-collapsible-content">
<br/>Check for submission documentation
<br/>Copy transfer submission documentation
<br/>Move to processing directory
<br/>Set file permissions
<br/>Assign file UUIDs to submission documentation
<br/>Assign checksums and file sizes to submissionDocumentation
<br/>Extract packages in submission documentation
<br/>Sanitize file and directory names in submission documentation
<br/>Scan for viruses in submission documentation
<br/>Characterize and extract metadata on submission documentation
<br/>Identify Files ByExtension
<br/>Normalize submission documentation to preservation format
</div>
</div>
| Processes any submission documentation included in the SIP and adds it to the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare DIP'''<div class="mw-collapsible-content">
<br/>Copy thumbnails to DIP directory
<br/>Copy METS to DIP directory
<br/>Set file permissions
<br/>Generate DIP
</div>
</div>
| Creates a DIP containing access copies of the objects, thumbnails and a copy of the METS file.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
</div>
</div>
| Allows the user to choose to upload the DIP to either ICA-AtoM or CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to ICA-AtoM'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in ICA-AtoM.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to CONTENTdm'''<div class="mw-collapsible-content">
<br/>Restructure DIP for CONTENTdm upload
<br/>Select upload type (Project Client or direct upload)
<br/>Select target CONTENTdm server
<br/>Get list of collections on server
<br/>Select destination collection
<br/>Upload DIP to contentDM
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare AIP'''<div class="mw-collapsible-content">
<br/>Copy transfers metadata and logs
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Verify checksums generated on ingest
<br/>Generate METS.xml document
<br/>Index AIP contents
<br/>Prepare AIP
<br/>Select compression algorithm
<br/>Select compression level
<br/>Compress AIP
<br/>Set bag file permissions
<br/>Removed bagged files
</div>
</div>
| Creates an AIP in Bagit format. Indexes the AIP, then losslessly compresses it.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store AIP'''<div class="mw-collapsible-content">
<br/>Move to the store AIP approval directory
<br/>Store AIP
<br/>Store AIP location
<br/>Store the AIP
</div>
</div>
| Moves the AIP to ''/sharedDirectoryStructure/www/AIPsStore/'' or another specified directory. Once the AIP has been stored, a copy of it is extracted from storage to a local temp directory, where it is subjected to standard BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

Archivematica 1.0 Micro-services

2019-12-11T20:13:58Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 1.0 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

A micro-service may consist of a number of discrete tasks, or jobs. In the Archivematica 1.0 dashboard, micro-services are always shown, while jobs may be viewed by expanding the micro-service (i.e. by clicking on the grey background behind the micro-service name).

</br>

[[Image:Micro-services1.png|600px|center|thumb|Archivematica dashboard showing a micro-service and its jobs]]

</br>

The table below shows micro-services and jobs in Archivematica 1.0. Note that this is is only a list of micro-services; detailed user instructions are available in the [[User manual 1.0|user manual]].
</br>
=Transfer=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve Transfer'''<div class="mw-collapsible-content">
Set file permissions
</div>
</div>
| This is the approval step that moves the transfer into the Archivematica processing pipeline.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Set transfer type: (Standard, Zipped bag, Unzipped bag, DSpace, Maildir)
<br/>Remove hidden files and directories
<br/>Remove unneeded files
<br/>Attempt restructure for compliance
<br/>Verify transfer compliance
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Moves the transfer to a processing directory based on selected transfer type (standard, zipped bag, unzipped bag, DSPace export or maildir). Verifies that the transfer conforms to the folder structure required for processing in Archivematica and restructures if required. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename with transfer UUID'''<div class="mw-collapsible-content">
<br/>Rename with transfer UUID
</div>
</div>
| Directly associates the transfer with its metadata by appending the transfer UUID to the transfer directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default Transfer processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default Transfer processingMCP.xml
</div>
</div>
| Adds a file named processingMCP.xml to the root of the transfer. This is a configurable xml file to pre-configure processing decisions. It can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Assign file UUIDs and checksums'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Assign file UUIDs to objects
<br/>Assign checksums and file sizes to objects
</div>
</div>
| Assigns a unique universal identifier and sha-256 checksum to each file in the ''/objects/'' directory and sets file permission to allow for continued processing.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer checksums'''<div class="mw-collapsible-content">
<br/>Verify metadata directory checksums
</div>
</div>
| Checks any checksum files that were placed in the ''/metadata/'' folder of the transfer prior to moving the transfer into Archivematica.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate METS.xml document'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates a basic METS file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their locations in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. A copy of the METS file is automatically added to any SIP generated from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Quarantine'''<div class="mw-collapsible-content">
<br/>Workflow decision - send transfer to quarantine
<br/>Move to quarantine
<br/>Remove from quarantine
</div>
</div>
| Quarantine's the transfer for a set duration, to allow virus definitions to update, before virus scan.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Scan for viruses'''<div class="mw-collapsible-content">
<br/>Scan for viruses
</div>
</div>
| Uses ClamAV to scan for viruses and other malware. If a virus is found, the transfer is automatically placed in ''/sharedDirectoryStructure/failed/'' and all processing on the transfer is stopped.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize object's file and directory names
<br/>Sanitize Transfer name
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Identify file format'''<div class="mw-collapsible-content">
<br/>Move to select file ID tool
<br/>Select file format identification command
<br/>Determine which files to identify
<br/> Identify file format
</div>
</div>
| Identifies formats of the objects in the transfer using either FIDO or file extension based on user choice. Format types are managed in the Format Policy Registry. This micro-service can be skipped and done in Ingest instead.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Extract packages'''<div class="mw-collapsible-content">
<br/>Extract contents from compressed archives
</div>
</div>
| Extracts objects from any zipped files or other packages. Extracts attachments from maildir transfers.
|-

| <div class="toccolours mw-collapsible mw-collapsed">'''Characterize and extract metadata'''<div class="mw-collapsible-content">
<br/>Characterize and extract metadata
<br/>Load labels from metadata/file_labels.csv
<br/>Set file permissions
<br/>Check for specialized processing
</div>
</div>
| Characterizes and validates formats and extracts object metadata using the File Information Tool Set (FITS).
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Complete transfer'''<div class="mw-collapsible-content">
<br/>Index transfer contents
<br/>Move to SIP creation directory for completed transfers
</div>
</div>
| Indexes transfer contents, then marks the transfer as complete.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Create SIP from Transfer'''<div class="mw-collapsible-content">
<br/>Check transfer directory for objects
<br/>Load options to create SIPs
<br/>Create SIP(s)
<br/>Move to processing directory
<br/>Create SIP from transfer objects
<br/>Send transfer to backlog
<br/>Move to SIP creation directory for completed transfers
</div>
</div>
| This is the approval step that moves the transfer to the SIP packaging micro-services (Ingest) if user chooses to Create single SIP and continue processing. User can also choose to Send transfer to backlog at this time.
|-
|}
</br>

=Ingest=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify SIP compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Verify SIP compliance
</div>
</div>
| Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Verifies the METS from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename SIP directory with SIP UUID'''<div class="mw-collapsible-content">
<br/>Rename SIP directory with SIP UUID
<br/>Check if SIP is from Maildir Transfer
</div>
</div>
| Directly associates the SIP with its metadata by appending the SIP UUID to the SIP directory name and checks if SIP is from Maildir transfer type to determine workflow.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default SIP processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default SIP processingMCP.xml
</div>
</div>
| Copies the processing configuration file added to the transfer in '''Include default Transfer processingMCP.xml''', above, to the SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Remove cache files'''<div class="mw-collapsible-content">
<br/>Remove cache files
</div>
</div>
| Removes any thumbs.db files.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize SIP name
<br/>Set file permissions
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Normalize'''<div class="mw-collapsible-content">
<br/>Identify manually normalized files
<br/>Check for Service directory
<br/>Check for Access directory
<br/>Set remove preservation and access normalized files to renormalize link.
<br/>Grant normalization options for no pre-existing DIP
<br/>Move to workFlowDecisions-createDip directory
<br/>Find options to normalize as
<br/>Set resume link after tool selected
<br/>Move to select file ID tool
<br/>Select pre-normalize file format identification commant
<br/>Identify file format
<br/>Resume after normalization file identification tool selected
<br/>Normalize
<br/>Move to processing directory
<br/>Create DIP directory
<br/>Create thumbnails directory
<br/>Normalize thumbnails
<br/>Normalize access
<br/>Normalize preservation
<br/>Set file permissions
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Move to approve normalization directory
<br/>Approve normalization
<br/>Load post approve normalization link
<br/>Set resume link after handling any manually normalized files
<br/>Move to processing directory
<br/>Set file permissions
<br/>Check for manually normalized files
<br/>Load finished with manual normalized link
</div>
</div>
| Determines which normalization options are available for the SIP and presents them to the user as choices. Normalizes (i.e. generates preservation and/or access copies) based on selection. Thumbnail files are also generated during this micro-service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process submission documentation'''<div class="mw-collapsible-content">
<br/>Copy transfer submission documentation
<br/>Check for submission documentation
<br/>Move submission documentation into objects directory
<br/>Assign file UUIDs to submission documentation
<br/>Assign checksums and file sizes to submissionDocumentation
<br/>Sanitize file and directory names in submission documentation
<br/>Scan for viruses in submission documentation
<br/>Characterize and extract metadata on submission documentation
</div>
</div>
| Processes any submission documentation included in the SIP and adds it to the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process metadata directory'''<div class="mw-collapsible-content">
<br/>Set resume link after processing metadata directory
<br/>Move metadata to objects directory
<br/>Assign file UUIDs to metadata
<br/>Assign checksums and file sized to metadata
<br/>Sanitize file and directory names in metadata
<br/>GScan for viruses in metadata
<br/>Load finished with metadata processing link
</div>
</div>
| Processes metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare DIP'''<div class="mw-collapsible-content">
<br/>Copy thumbnails to DIP directory
<br/>Copy METS to DIP directory
<br/>Set file permissions
<br/>Generate DIP
</div>
</div>
| Creates a DIP containing access copies of the objects, thumbnails and a copy of the METS file.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
</div>
</div>
| Allows the user to choose to upload the DIP to either ICA-AtoM or CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to ICA-AtoM'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in ICA-AtoM.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to CONTENTdm'''<div class="mw-collapsible-content">
<br/>Restructure DIP for CONTENTdm upload
<br/>Select upload type (Project Client or direct upload)
<br/>Select target CONTENTdm server
<br/>Get list of collections on server
<br/>Select destination collection
<br/>Upload DIP to contentDM
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare AIP'''<div class="mw-collapsible-content">
<br/>Remove files without linking information (failed normalization artifacts, etc.)
<br/>Verify checksums generated on ingest
<br/>Copy transfers metadata and logs
<br/>Remove empty manual normalization directories
<br/>Generate METS.xml document
<br/>Index AIP contents
<br/>Prepare AIP
<br/>Move to compressionAIPDecisions directory
<br/>Select compression algorithm
<br/>Select compression level
<br/>Compress AIP
<br/>Create AIP pointer file
<br/>Set bag file permissions
<br/>Removed bagged files
</div>
</div>
| Creates an AIP in Bagit format. Creates the AIP pointer file. Indexes the AIP, then losslessly compresses it.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store AIP'''<div class="mw-collapsible-content">
<br/>Move to the store AIP approval directory
<br/>Store AIP
<br/>Retrieve AIP Storage Locations
<br/>Store AIP location
<br/>Move to processing directory
<br/>Verify AIP
<br/>Store the AIP
<br/>Index AIP
<br/>Remove processing directory
</div>
</div>
| Moves the AIP to ''/sharedDirectoryStructure/www/AIPsStore/'' or another specified directory. Once the AIP has been stored, a copy of it is extracted from storage to a local temp directory, where it is subjected to standard BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

Archivematica 1.1 Micro-services

2019-12-11T20:13:40Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > [[Micro-services]] > Archivematica 1.1 Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

A micro-service may consist of a number of discrete tasks, or jobs. In the Archivematica 1.1 dashboard, micro-services are always shown, while jobs may be viewed by expanding the micro-service (i.e. by clicking on the grey background behind the micro-service name).

</br>

[[Image:Micro-services1.png|600px|center|thumb|Archivematica dashboard showing a micro-service and its jobs]]

</br>

The table below shows micro-services and jobs in Archivematica 1.1. Note that this is is only a list of micro-services; detailed user instructions are available in the [[User manual 1.0|user manual]].
</br>
=Transfer=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve Transfer'''<div class="mw-collapsible-content">
Set file permissions
</div>
</div>
| This is the approval step that moves the transfer into the Archivematica processing pipeline.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Set transfer type: (Standard, Zipped bag, Unzipped bag, DSpace, Maildir)
<br/>Remove hidden files and directories
<br/>Remove unneeded files
<br/>Attempt restructure for compliance
<br/>Verify transfer compliance
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Moves the transfer to a processing directory based on selected transfer type (standard, zipped bag, unzipped bag, DSPace export or maildir). Verifies that the transfer conforms to the folder structure required for processing in Archivematica and restructures if required. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename with transfer UUID'''<div class="mw-collapsible-content">
<br/>Rename with transfer UUID
</div>
</div>
| Directly associates the transfer with its metadata by appending the transfer UUID to the transfer directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default Transfer processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default Transfer processingMCP.xml
</div>
</div>
| Adds a file named processingMCP.xml to the root of the transfer. This is a configurable xml file to pre-configure processing decisions. It can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Assign file UUIDs and checksums'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Assign file UUIDs to objects
<br/>Assign checksums and file sizes to objects
</div>
</div>
| Assigns a unique universal identifier and sha-256 checksum to each file in the ''/objects/'' directory and sets file permission to allow for continued processing.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer checksums'''<div class="mw-collapsible-content">
<br/>Verify metadata directory checksums
</div>
</div>
| Checks any checksum files that were placed in the ''/metadata/'' folder of the transfer prior to moving the transfer into Archivematica.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate METS.xml document'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates a basic METS file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their locations in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. A copy of the METS file is automatically added to any SIP generated from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Quarantine'''<div class="mw-collapsible-content">
<br/>Workflow decision - send transfer to quarantine
<br/>Move to quarantine
<br/>Remove from quarantine
</div>
</div>
| Quarantine's the transfer for a set duration, to allow virus definitions to update, before virus scan.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Scan for viruses'''<div class="mw-collapsible-content">
<br/>Scan for viruses
</div>
</div>
| Uses ClamAV to scan for viruses and other malware. If a virus is found, the transfer is automatically placed in ''/sharedDirectoryStructure/failed/'' and all processing on the transfer is stopped.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize object's file and directory names
<br/>Sanitize Transfer name
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Identify file format'''<div class="mw-collapsible-content">
<br/>Move to select file ID tool
<br/>Select file format identification command
<br/>Determine which files to identify
<br/> Identify file format
</div>
</div>
| Identifies formats of the objects in the transfer using either FIDO or file extension based on user choice. Format types are managed in the Format Policy Registry. This micro-service can be skipped and done in Ingest instead.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Extract packages'''<div class="mw-collapsible-content">
<br/>Move to processing directory
<br/>Move to extract packages
<br/>Extract packages? (preconfigured choice)
<br/>Delete package after extraction? (preconfigured choice)
<br/>Extract contents from compressed archives
</div>
</div>
| Extracts objects from any zipped files or other packages. Extracts attachments from maildir transfers. User can preconfigure choices about whether to extract and whether to keep one or both of extracted object contents and/or the package itself.
|-

| <div class="toccolours mw-collapsible mw-collapsed">'''Characterize and extract metadata'''<div class="mw-collapsible-content">
<br/>Characterize and extract metadata
<br/>Load labels from metadata/file_labels.csv
<br/>Set file permissions
<br/>Check for specialized processing
</div>
</div>
| Characterizes and validates formats and extracts object metadata using the File Information Tool Set (FITS).
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Complete transfer'''<div class="mw-collapsible-content">
<br/>Index transfer contents
<br/>Move to SIP creation directory for completed transfers
</div>
</div>
| Indexes transfer contents, then marks the transfer as complete.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Create SIP from Transfer'''<div class="mw-collapsible-content">
<br/>Check transfer directory for objects
<br/>Load options to create SIPs
<br/>Create SIP(s)
<br/>Move to processing directory
<br/>Create SIP from transfer objects
<br/>Send transfer to backlog
<br/>Move to SIP creation directory for completed transfers
</div>
</div>
| This is the approval step that moves the transfer to the SIP packaging micro-services (Ingest) if user chooses to Create single SIP and continue processing. User can also choose to Send transfer to backlog at this time.
|-
|}
</br>

=Ingest=
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify SIP compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Verify SIP compliance
</div>
</div>
| Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Verifies the METS from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename SIP directory with SIP UUID'''<div class="mw-collapsible-content">
<br/>Rename SIP directory with SIP UUID
<br/>Check if SIP is from Maildir Transfer
</div>
</div>
| Directly associates the SIP with its metadata by appending the SIP UUID to the SIP directory name and checks if SIP is from Maildir transfer type to determine workflow.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default SIP processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default SIP processingMCP.xml
</div>
</div>
| Copies the processing configuration file added to the transfer in '''Include default Transfer processingMCP.xml''', above, to the SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Remove cache files'''<div class="mw-collapsible-content">
<br/>Remove cache files
</div>
</div>
| Removes any thumbs.db files.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize SIP name
<br/>Set file permissions
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Normalize'''<div class="mw-collapsible-content">
<br/>Identify manually normalized files
<br/>Check for Service directory
<br/>Check for Access directory
<br/>Set remove preservation and access normalized files to renormalize link.
<br/>Grant normalization options for no pre-existing DIP
<br/>Move to workFlowDecisions-createDip directory
<br/>Find options to normalize as
<br/>Set resume link after tool selected
<br/>Move to select file ID tool
<br/>Select pre-normalize file format identification commant
<br/>Identify file format
<br/>Resume after normalization file identification tool selected
<br/>Normalize
<br/>Move to processing directory
<br/>Create DIP directory
<br/>Create thumbnails directory
<br/>Normalize thumbnails
<br/>Normalize access
<br/>Normalize preservation
<br/>Set file permissions
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Move to approve normalization directory
<br/>Approve normalization
<br/>Load post approve normalization link
<br/>Set resume link after handling any manually normalized files
<br/>Move to processing directory
<br/>Set file permissions
<br/>Check for manually normalized files
<br/>Load finished with manual normalized link
</div>
</div>
| Determines which normalization options are available for the SIP and presents them to the user as choices. Normalizes (i.e. generates preservation and/or access copies) based on selection. Thumbnail files are also generated during this micro-service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process submission documentation'''<div class="mw-collapsible-content">
<br/>Copy transfer submission documentation
<br/>Check for submission documentation
<br/>Move submission documentation into objects directory
<br/>Assign file UUIDs to submission documentation
<br/>Assign checksums and file sizes to submissionDocumentation
<br/>Sanitize file and directory names in submission documentation
<br/>Scan for viruses in submission documentation
<br/>Characterize and extract metadata on submission documentation
</div>
</div>
| Processes any submission documentation included in the SIP and adds it to the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process metadata directory'''<div class="mw-collapsible-content">
<br/>Set resume link after processing metadata directory
<br/>Move metadata to objects directory
<br/>Assign file UUIDs to metadata
<br/>Assign checksums and file sized to metadata
<br/>Sanitize file and directory names in metadata
<br/>GScan for viruses in metadata
<br/>Load finished with metadata processing link
</div>
</div>
| Processes metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare DIP'''<div class="mw-collapsible-content">
<br/>Copy thumbnails to DIP directory
<br/>Copy METS to DIP directory
<br/>Set file permissions
<br/>Generate DIP
</div>
</div>
| Creates a DIP containing access copies of the objects, thumbnails and a copy of the METS file.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
</div>
</div>
| Allows the user to choose to upload the DIP to either ICA-AtoM or CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to ICA-AtoM'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in ICA-AtoM.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to CONTENTdm'''<div class="mw-collapsible-content">
<br/>Restructure DIP for CONTENTdm upload
<br/>Select upload type (Project Client or direct upload)
<br/>Select target CONTENTdm server
<br/>Get list of collections on server
<br/>Select destination collection
<br/>Upload DIP to contentDM
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in CONTENTdm.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare AIP'''<div class="mw-collapsible-content">
<br/>Remove files without linking information (failed normalization artifacts, etc.)
<br/>Verify checksums generated on ingest
<br/>Copy transfers metadata and logs
<br/>Remove empty manual normalization directories
<br/>Generate METS.xml document
<br/>Index AIP contents
<br/>Prepare AIP
<br/>Move to compressionAIPDecisions directory
<br/>Select compression algorithm
<br/>Select compression level
<br/>Compress AIP
<br/>Create AIP pointer file
<br/>Set bag file permissions
<br/>Removed bagged files
</div>
</div>
| Creates an AIP in Bagit format. Creates the AIP pointer file. Indexes the AIP, then losslessly compresses it.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store AIP'''<div class="mw-collapsible-content">
<br/>Move to the store AIP approval directory
<br/>Store AIP
<br/>Retrieve AIP Storage Locations
<br/>Store AIP location
<br/>Move to processing directory
<br/>Verify AIP
<br/>Store the AIP
<br/>Index AIP
<br/>Remove processing directory
</div>
</div>
| Moves the AIP to ''/sharedDirectoryStructure/www/AIPsStore/'' or another specified directory. Once the AIP has been stored, a copy of it is extracted from storage to a local temp directory, where it is subjected to standard BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

Micro-services

2019-12-11T20:13:21Z

Ablewer:

[[Main Page]] > [[Documentation]] > [[Technical Architecture]] > Micro-services

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

[[File:Micro-service.png|320px|thumb|right]]

Archivematica implements a [http://www.cdlib.org/services/uc3/curation/ micro-service] approach to digital preservation. The Archivematica micro-services are granular system tasks which operate on a conceptual entity that is equivalent to an OAIS information package: Submission Information Package (SIP), Archival Information Package (AIP), Dissemination Information Package (DIP). The physical structure of an information package will include files, checksums, logs, submission documentation, XML metadata, etc..

These information packages are processed using a series of micro-services. Micro-services are provided by a combination of Archivematica Python scripts and one or more of the free, open-source [[External tools|software tools]] bundled in the Archivematica system. Each micro-service results in a success or error state and the information package is processed accordingly by the next micro-service. There are a variety of mechanisms used to connect the various micro-services together into complex, custom workflows. Resulting in a complete ingest to access system.

Archivematica implements a [[Micro-services#Archivematica_Micro-services|default ingest to access workflow]] that is [[Requirements|compliant with the ISO-OAIS]] functional model. Micro-services can be distributed to processing clusters for highly scalable configurations.

==Current Micro-services in Archivematica==

A micro-service may consist of a number of discrete tasks, or jobs. In the Archivematica dashboard, micro-services are always shown, while jobs may be viewed by expanding the micro-service (i.e. by clicking on the grey background behind the micro-service name).

</br>

[[Image:Micro-services1.png|600px|center|thumb|Archivematica dashboard showing a micro-service and its jobs]]

</br>

The table below shows micro-services and jobs in the current release of Archivematica ('''Updated July 2015 for release 1.4.1''').

</br>
===Transfer===
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve Transfer'''<div class="mw-collapsible-content">
</div>
</div>
| This is the approval step that moves the transfer into the Archivematica processing pipeline.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Set transfer type: (Standard, Zipped bag, Unzipped bag, DSpace, Maildir)
<br/>Remove hidden files and directories
<br/>Remove unneeded files
<br/>Attempt restructure for compliance
<br/>Verify transfer compliance
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Moves the transfer to a processing directory based on selected transfer type (standard, zipped bag, unzipped bag, DSPace export or maildir). Verifies that the transfer conforms to the folder structure required for processing in Archivematica and restructures if required. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename with transfer UUID'''<div class="mw-collapsible-content">
<br/>Rename with transfer UUID
</div>
</div>
| Directly associates the transfer with its metadata by appending the transfer UUID to the transfer directory name.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default Transfer processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default Transfer processingMCP.xml
</div>
</div>
| Adds a file named processingMCP.xml to the root of the transfer. This is a configurable xml file to pre-configure processing decisions. It can configure workflow options such as creating transfer backups, quarantining the transfer and selecting a SIP creation option.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Assign file UUIDs and checksums'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Assign file UUIDs to objects
<br/>Assign checksums and file sizes to objects
</div>
</div>
| Assigns a unique universal identifier and sha-256 checksum to each file in the ''/objects/'' directory and sets file permission to allow for continued processing.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer checksums'''<div class="mw-collapsible-content">
<br/>Verify metadata directory checksums
</div>
</div>
| Checks any checksum files that were placed in the ''/metadata/'' folder of the transfer prior to moving the transfer into Archivematica.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate METS.xml document'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates a basic METS file with a fileSec and structMap to record the presence of all objects in the ''/objects/'' directory and their locations in any subdirectories. Designed to capture the original order of the transfer in the event the user chooses subsequently to delete, rename or move files or break the transfer into multiple SIPs. A copy of the METS file is automatically added to any SIP generated from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Reformat metadata files'''<div class="mw-collapsible-content">
<br/>Process transfer JSON metadata
</div>
</div>
| Transforms JSON metadata included with transfer to metadata.csv
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Quarantine'''<div class="mw-collapsible-content">
<br/>Workflow decision - send transfer to quarantine
<br/>Move to quarantine
<br/>Remove from quarantine
</div>
</div>
| Quarantines the transfer for a set duration, to allow virus definitions to update, before virus scan.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Scan for viruses'''<div class="mw-collapsible-content">
<br/>Scan for viruses
</div>
</div>
| Uses ClamAV to scan for viruses and other malware. If a virus is found, the transfer is automatically placed in ''/sharedDirectoryStructure/failed/'' and all processing on the transfer is stopped.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate transfer structure report'''<div class="mw-collapsible-content">
<br/>Generate transfer structure report
<br/>Move to generate transfer tree
</div>
</div>
| Uses Tree to create transfer structure report (original order report) in txt format
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Sanitize object's file and directory names
<br/>Sanitize Transfer name
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Identify file format'''<div class="mw-collapsible-content">
<br/>Move to select file ID tool
<br/>Select file format identification command
<br/>Determine which files to identify
<br/> Identify file format
</div>
</div>
| Identifies formats of the objects in the transfer using either FIDO or file extension based on user choice. Format types are managed in the Format Policy Registry. This micro-service can be skipped and done in Ingest instead.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Extract packages'''<div class="mw-collapsible-content">
<br/>Move to processing directory
<br/>Move to extract packages
<br/>Extract packages? (preconfigured choice)
<br/>Delete package after extraction? (preconfigured choice)
<br/>Extract contents from compressed archives
</div>
</div>
| Extracts objects from any zipped files or other packages. Extracts attachments from maildir transfers. User can preconfigure choices about whether to extract and whether to keep one or both of extracted object contents and/or the package itself.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Update METS.xml document'''<div class="mw-collapsible-content">
<br/>Add processed structMap to METS.xml document
</div>
</div>
| Creates a structMap in the transfer METS to reflect structure of transfer
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Characterize and extract metadata'''<div class="mw-collapsible-content">
<br/>Characterize and extract metadata
<br/>Load labels from metadata/file_labels.csv
</div>
</div>
| Characterizes formats and extracts object metadata using File Information Tool Set (FITS), FFprobe, Exiftool and/or Mediainfo
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Validation'''<div class="mw-collapsible-content">
<br/>Validate formats
</div>
</div>
| Validates formats using JHOVE.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Examine Contents'''<div class="mw-collapsible-content">
<br/>Examine contents
</div>
</div>
| Runs Bulk Extractor on transfer contents and creates reports
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Complete transfer'''<div class="mw-collapsible-content">
<br/>Index transfer contents
<br/>Create transfer metadata XML
<br/>Move to SIP creation directory for completed transfers
</div>
</div>
| Indexes transfer contents, creates transfer METS XML, then marks the transfer as complete.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Create SIP from Transfer'''<div class="mw-collapsible-content">
<br/>Check transfer directory for objects
<br/>Updating transfer file index
<br/>Create placement in backlog PREMIS events
<br/>Move transfer to backlog
<br/>Check transfer directory for objects
<br/>Load options to create SIP
</div>
</div>
| This is the approval step that moves the transfer to the SIP packaging micro-services (Ingest) if user chooses to Create single SIP and continue processing. User can also choose to Send transfer to backlog at this time, which creates an associated PREMIS event.
|-
|}
</br>

===Ingest===
{| border="1" cellpadding="10" cellspacing="0" width=90%
|-
|- style="background-color:#cccccc;"
!style="width:30%"|'''Micro-service'''
!style="width:70%"|'''Description'''
|-
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Approve SIP creation'''<div class="mw-collapsible-content">
<br/>Approve SIP creation
<br/> Create removal from backlog PREMIS events
</div>
</div>
| Applies to SIPs that have been created from backlog. Approves creation of SIP, and creates PREMIS event for removal from backlog.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify transfer compliance'''<div class="mw-collapsible-content">
<br/>Verify mets_structmap.xml compliance
</div>
</div>
| Verifies the METS from the transfer.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify SIP compliance'''<div class="mw-collapsible-content">
<br/>Set file permissions
<br/>Move to processing directory
<br/>Verify SIP compliance
</div>
</div>
| Verifies that the SIP conforms to the folder structure required for processing in Archivematica. The structure is as follows: ''/logs/'', ''/metadata/'', ''/metadata/submissionDocumentation/'', ''/objects/''.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Rename SIP directory with SIP UUID'''<div class="mw-collapsible-content">
<br/>Rename SIP directory with SIP UUID
<br/>Check if SIP is from Maildir Transfer
</div>
</div>
| Directly associates the SIP with its metadata by appending the SIP UUID to the SIP directory name and checks if SIP is from Maildir transfer type to determine workflow.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Include default SIP processingMCP.xml'''<div class="mw-collapsible-content">
<br/>Include default SIP processingMCP.xml
</div>
</div>
| Copies the processing configuration file added to the transfer in '''Include default Transfer processingMCP.xml''', above, to the SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Remove cache files'''<div class="mw-collapsible-content">
<br/>Remove cache files
</div>
</div>
| Removes any thumbs.db files.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Clean up names'''<div class="mw-collapsible-content">
<br/>Load Dublin Core metadata from disk
<br/>Sanitize SIP name
<br/>Set file permissions
</div>
</div>
| Some file systems do not support unicode or other special characters in filenames. This micro-service removes prohibited characters and replaces them with dashes. Original filenames are preserved in the PREMIS metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Normalize'''<div class="mw-collapsible-content">
<br/>Identify manually normalized files
<br/>Check for Service directory
<br/>Check for Access directory
<br/>Set remove preservation and access normalized files to renormalize link.
<br/>Grant normalization options for no pre-existing DIP
<br/>Move to workFlowDecisions-createDip directory
<br/>Find options to normalize as
<br/>Set resume link after tool selected
<br/>Move to select file ID tool
<br/>Select pre-normalize file format identification commant
<br/>Identify file format
<br/>Resume after normalization file identification tool selected
<br/>Normalize
<br/>Move to processing directory
<br/>Create DIP directory
<br/>Create thumbnails directory
<br/>Normalize thumbnails
<br/>Normalize access
<br/>Normalize preservation
<br/>Set file permissions
<br/>Remove files without linking information (failed normalization artifacts etc.)
<br/>Move to approve normalization directory
<br/>Approve normalization
<br/>Load post approve normalization link
<br/>Set resume link after handling any manually normalized files
<br/>Move to processing directory
<br/>Set file permissions
<br/>Load finished with manual normalized link
</div>
</div>
| Determines which normalization options are available for the SIP and presents them to the user as choices. Normalizes (i.e. generates preservation and/or access copies) based on selection. Thumbnail files are also generated during this micro-service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process manually normalized files'''<div class="mw-collapsible-content">
<br/>Check for manual normalized files
</div>
</div>
| Processed files manually normalized during processing
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Add final metadata'''<div class="mw-collapsible-content">
<br/> Move to metadata reminder
<br/>Reminder: add metadata if desired
<br/>Set file permissions
</div>
</div>
| Provides the operator a reminder to add metadata through the UI if desired.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Transcribe SIP contents'''<div class="mw-collapsible-content">
<br/>Transcribe SIP contents
<br/>Transcribe
</div>
</div>
| Runs Tesseract OCR tool on any JPG or TIFF image files in SIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process submission documentation'''<div class="mw-collapsible-content">
<br/>Copy transfer submission documentation
<br/>Check for submission documentation
<br/>Move submission documentation into objects directory
<br/>Assign file UUIDs to submission documentation
<br/>Assign checksums and file sizes to submissionDocumentation
<br/>Sanitize file and directory names in submission documentation
<br/>Scan for viruses in submission documentation
<br/>Select file format identification command
<br/>Identify file format
<br/>Characterize and extract metadata on submission documentation
<br/>Remove files without linking information (failed normalization artifacts etc.)
</div>
</div>
| Processes any submission documentation included in the SIP and adds it to the ''/objects/'' directory.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Process metadata directory'''<div class="mw-collapsible-content">
<br/>Copy transfers metadata and logs
<br/>Process JSON metadata
<br/>Move metadata to objects directory
<br/>Assign file UUIDs to metadata
<br/>Assign checksums and file sizes to metadata
<br/>Sanitize file and directory names in metadata
<br/>Scan for viruses in metadata
<br/>Identify file format of metadata files
<br/>Characterize and extract metadata on metadata files
<br/>Remove empty manual normalization directories
</div>
</div>
| Processes metadata.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Verify checksums'''<div class="mw-collapsible-content">
<br/>Verify checksums generated on ingest
</div>
</div>
| Verifies checksums generated on ingest
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Generate AIP METS'''<div class="mw-collapsible-content">
<br/>Generate METS.xml document
</div>
</div>
| Generates Archivematica AIP METS.xml document
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare DIP'''<div class="mw-collapsible-content">
<br/>Copy thumbnails to DIP directory
<br/>Copy METS to DIP directory
<br/>Copy preconfigured choice XML to DIP directory
<br/>Generate DIP
<br/>Copy OCR data to DIP directory
<br/>Set file permissions
</div>
</div>
| Creates a DIP containing access copies of the objects, thumbnails and a copy of the METS file.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Prepare AIP'''<div class="mw-collapsible-content">
<br/>Check if DIP should be generated
<br/>Prepare AIP
<br/>Move to compressionAIPDecisions directory
<br/>Select compression algorithm
<br/>Select compression level
<br/>Compress AIP
<br/>Copy submission documentation
<br/>Create AIP pointer file
<br/>Set bag file permissions
<br/>Check if AIP is a file or directory
<br/>Removed bagged files
</div>
</div>
| Creates an AIP in Bagit format. Creates the AIP pointer file. Indexes the AIP, then losslessly compresses it.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
</div>
</div>
| Allows the user to choose to upload the DIP AtoM, CONTENTdm, Archivist's Toolkit. Also allows user to store DIP or reject DIP.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to AtoM'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user uploads the DIP to a selected description in AtoM.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to CONTENTdm'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Restructure DIP for CONTENTdm upload
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user creates a DIP suitable for upload to CONTENTdm using Project Client.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Upload DIP to Archivists' Toolkit'''<div class="mw-collapsible-content">
<br/>
</div>
</div>
| The user uploads the DIP metadata to Archivists' Toolkit
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store DIP'''<div class="mw-collapsible-content">
<br/>Upload DIP
<br/>Retrieve DIP Storage Locations
<br/>Store DIP location
<br/>Store DIP
<br/>Move to the uploadedDIPs directory
</div>
</div>
| The user stores the DIP in a location pre-configured in the Storage Service.
|-
| <div class="toccolours mw-collapsible mw-collapsed">'''Store AIP'''<div class="mw-collapsible-content">
<br/>Move to the store AIP approval directory
<br/>Store AIP
<br/>Retrieve AIP Storage Locations
<br/>Store AIP location
<br/>Move to processing directory
<br/>Verify AIP
<br/>Store the AIP
<br/>Index AIP
<br/>Clean up after storing AIP
<br/>Remove processing directory
</div>
</div>
| Moves the AIP to ''/sharedDirectoryStructure/www/AIPsStore/'' or another specified directory. Before the AIP has been stored, a copy of it is extracted to a local temp directory, where it is subjected to standard BagIt checks: verifyvalid, checkpayloadoxum, verifycomplete, verifypayloadmanifests, verifytagmanifests.
|-
|}

=Historical Micro-services in Archivematica Releases=

*[[Archivematica 1.1 Micro-services]]
*[[Archivematica 1.0 Micro-services]]
*[[Archivematica 0.10 Micro-services]]
*[[Archivematica 0.9 Micro-services]]
*[[Archivematica 0.8 Micro-services]]
*[[Archivematica 0.7.1 Micro-services]]

Contributors

2019-12-11T20:12:53Z

Ablewer:

[[Main Page]] > [[Community]] > [[Contributors|Contributors]]

<blockquote style="background-color:orange;">
'''Note: The documentation on this page is out of date. Please see the [https://www.archivematica.org/docs official documentation page] for the latest.'''
</blockquote>

On this page we'll try to gather up all the information we can about anyone who has contributed code to the Archivematica project. If you've shared code that has been incorporated into a public Archivematica release, we want to acknowledge your contributions! Have we missed you or someone else you know? Help us fill this page in and keep it up to date!

Interested in contributing code to the public Archivematica project? Find out how here:
*[[Contribute code|Contribute Code]]
*[[Development|Developer Resources]]

==Artefactual contributors==

Here's a list of code contributors working at Artefactual, past and present.

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Artefactual code contributors''
! Name
|-
| Joseph Perry
|-
| Jesús García Crespo
|-
| Austin Trask
|-
| Peter Van Garderen
|-
| Evelyn McLellan
|-
| Mike Cantelon
|-
| Justin Simpson
|-
| Holly Becker
|-
| Misty De Meo
|-
| Héctor Akamine
|-
| Santiago Collazo
|-
|}

==Community contributors==

Community developers who have submitted pull requests or patches for Archivematica which have been incorporated into a subsequent public release.

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Community code contributors''
! Name || Organization
|-
| David Rice || [https://mediaarea.net MediaArea]
|-
| Mark Jordan || [http://www.lib.sfu.ca/ SFU Library]
|-
| Marco Klindt || [http://www.zib.de/ The Zuse Institute Berlin]
|-
| Daniel Lamb || [http://www.discoverygarden.ca/ Discovery Garden]
|-
| Andrew Berger || [http://www.computerhistory.org/ Computer History Museum]
|-
| Kieran O'Leary || [http://www.ifi.ie/archive/ IFI Irish Film Archive]
|-
| Marco Klindt || [http://www.zib.de/ Zuse Institute Berlin]
|-
| Pieter De Praetere || [http://www.packed.be/ Packed]
|-
| Vlastimil Krejcir || [https://www.ics.muni.cz/ Masaryk University]
|-
| Michal Růžička || [http://www.ics.muni.cz/ Masaryk University]
|-
|}

==On Deck==

A list of developers who have submitted pull requests or patches for Archivematica, which have not yet been incorporated into a public release

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Up and Comers''
! Name || Organization
|-
|}
-----

* [[Community|Back to the Community landing page]]
* [[Main Page|Back to the Archivematica wiki home]]

[[Category:Community]]

Contributors

2019-11-19T13:34:09Z

Ablewer:

[[Main Page]] > [[Community]] > [[Contributors|Contributors]]

<blockquote>
'''Note: This page has not been updated since 2016. A full list of code contributors for the history of the project can be found [https://github.com/artefactual/archivematica/graphs/contributors here].'''
</blockquote>

On this page we'll try to gather up all the information we can about anyone who has contributed code to the Archivematica project. If you've shared code that has been incorporated into a public Archivematica release, we want to acknowledge your contributions! Have we missed you or someone else you know? Help us fill this page in and keep it up to date!

Interested in contributing code to the public Archivematica project? Find out how here:
*[[Contribute code|Contribute Code]]
*[[Development|Developer Resources]]

==Artefactual contributors==

Here's a list of code contributors working at Artefactual, past and present.

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Artefactual code contributors''
! Name
|-
| Joseph Perry
|-
| Jesús García Crespo
|-
| Austin Trask
|-
| Peter Van Garderen
|-
| Evelyn McLellan
|-
| Mike Cantelon
|-
| Justin Simpson
|-
| Holly Becker
|-
| Misty De Meo
|-
| Héctor Akamine
|-
| Santiago Collazo
|-
|}

==Community contributors==

Community developers who have submitted pull requests or patches for Archivematica which have been incorporated into a subsequent public release.

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Community code contributors''
! Name || Organization
|-
| David Rice || [https://mediaarea.net MediaArea]
|-
| Mark Jordan || [http://www.lib.sfu.ca/ SFU Library]
|-
| Marco Klindt || [http://www.zib.de/ The Zuse Institute Berlin]
|-
| Daniel Lamb || [http://www.discoverygarden.ca/ Discovery Garden]
|-
| Andrew Berger || [http://www.computerhistory.org/ Computer History Museum]
|-
| Kieran O'Leary || [http://www.ifi.ie/archive/ IFI Irish Film Archive]
|-
| Marco Klindt || [http://www.zib.de/ Zuse Institute Berlin]
|-
| Pieter De Praetere || [http://www.packed.be/ Packed]
|-
| Vlastimil Krejcir || [https://www.ics.muni.cz/ Masaryk University]
|-
| Michal Růžička || [http://www.ics.muni.cz/ Masaryk University]
|-
|}

==On Deck==

A list of developers who have submitted pull requests or patches for Archivematica, which have not yet been incorporated into a public release

{| class="wikitable" style="background-color:#ffffff;"
|+ style="caption-side:top; color:#e76700;"|''Up and Comers''
! Name || Organization
|-
|}
-----

* [[Community|Back to the Community landing page]]
* [[Main Page|Back to the Archivematica wiki home]]

[[Category:Community]]

Community

2019-11-18T23:54:37Z

Ablewer: /* Case studies */

[[Main Page]] > [[Community|Community]]

==Get in touch==

The [https://groups.google.com/forum/?fromgroups#!forum/archivematica Archivematica community discussion list] is an open discussion forum for any Archivematica-related topic, including (but not limited to) community organizing, requirements analysis for new and prospective users, workflow configuration, preservation planning, and many more. If you are posting about an error, please include as much information as possible. This means including the following information:
* The version of Archivematica you have installed
* The system(s) you're using (Ubuntu, CentOS, which browser, etc.)
* The content and size of your transfer(s)
* The task information (click on the cog icon on the same line as the micro-service job where the error occurred) and show arguments data output

For installation issues, include the following information:
* What version of Archivematica you are installing
* If you are upgrading or installing fresh
* If you are using something other than the recommended requirements from our installation instructions
* Stack traces or results from error logs if possible

You can also find news about the Archivematica project on Twitter at [http://twitter.com/#!/archivematica @archivematica].

==Regional user groups==

Check [[Community/Regional User Groups|Regional User Groups]] to find a group in your area. Interested in starting a group? Feel free to use the [https://groups.google.com/forum/?fromgroups#!forum/archivematica Discussion list] to find other users in your area, and request a wiki account to add your details!

==Implementations==

Archivematica has been installed for testing or production hundreds of times. If you don't see your organization here and would like to be included as part of the visible Archivematica community of implementers, request an account to edit the wiki yourself or email ''info[at]artefactual[dot]com'' with your information and we will add your institution here.

{| class="wikitable"
!colspan="1"|Institution
!colspan="1"|Status
!colspan="1"|Integrations
|-
| [http://www.library.ualberta.ca/ University of Alberta Libraries]
| In production
|
|-
| [http://www.artcenter.edu/accd/campus/archives Art Center College of Design]
| In production
| [http://accesstomemory.org AtoM]
|-
| [http://bentley.umich.edu/ Bentley Historical Library (University of Michigan)]
| Testing/development
| [http://archivesspace.org ArchivesSpace], [http://www.dspace.org DSpace]
|-
| [http://www.york.ac.uk/borthwick/ Borthwick Institute for Archives (University of York)]
| Testing/development
| PURE, RDMonitor, [http://projecthydra.org/ Hydra]
|-
| [http://diginit.library.ubc.ca/ University of British Columbia Library]
| In production
| [http://www.oclc.org/contentdm.en.html CONTENTdm], [http://www.dspace.org DSpace], [http://accesstomemory.org AtoM]
|-
| [http://cca.qc.ca Canadian Centre for Architecture]
| Testing/development
|
|-
|[http://library.columbia.edu/ Columbia University Libraries]
| In production
|
|-
| [http://www.ed.ac.uk/ University of Edinburgh]
| Testing/development
| [http://archivesspace.org ArchivesSpace], [http://www.dspace.org DSpace]
|-
| [http://www.library.hbs.edu/hc/ Harvard Business School, Baker Library Historical Collections]
| In production
|
|-
| [http://info.lib.uh.edu/ University of Houston Libraries]
| In production
|
|-
| [http://www2.hull.ac.uk/ University of Hull]
| Testing/development
| [http://projecthydra.org/ Hydra]
|-
| [http://www.moma.org/ MoMA - The Museum of Modern Art]
| In production
| [http://binder.readthedocs.org Binder], [http://arkivum.com Arkivum]
|-
| [http://rockarch.org/ Rockefeller Archive Center]
| In production
| [http://archivesspace.org ArchivesSpace]
|-
| [http://digisu.sabanciuniv.edu/cdm/lang/en_US Sabancı University Sakıp Sabancı Museum]
| In production
|
|-
| [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management]
| In production
| [http://accesstomemory.org AtoM]
|-
| [http://library.tamu.edu/ Texas A&M University Libraries]
| In production
| [https://www.tdl.org/duracloud/ DuraCloud@TDL]
|-
| [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives]
| In production
| [http://accesstomemory.org AtoM]
|-
| [http://library.yorku.ca/ York University Libraries]
| Testing/development
| [https://spotdocs.scholarsportal.info/display/ODLRC/About+the+OLRC OLRC]
|-
| [http://library.usask.ca/ University Library, University of Saskatchewan]
| Testing/development
| [http://islandora.ca Islandora]
|-
|}

==Case studies==

We'd love to receive narrative case studies from current or prospective Archivematica users. Let the community know how you decided on Archivematica, your path towards digital preservation, and your implementation trials, tribulations, and successes by adding your information to [https://github.com/archivematica/archivematica-case-studies Archivematica Case Studies].

==Contribute to the Archivematica project==

Interested in contributing to the Archivematica project? Great! The two main ways that the community can contribute are through code contributions or by filing issues.

===Code contributions===

As an open source project, all of Archivematica's code resources are available on [https://github.com/artefactual/archivematica Github], where we welcome community contributions. For more information about contributing code to the project, please read the Contributing guidelines, located in the CONTRIBUTING.md file in the Archivematica repository.

* [https://github.com/artefactual/archivematica Archivematica repository] -> CONTRIBUTING.md

Most of the code in the public Archivematica releases has been written by Artefactual staff, but there is a growing list of community contributors. Check out the list here:

* [[Contributors|Contributors]]

===Filing issues===

All issues about any part of the Archivematica project are filed on the [https://github.com/archivematica/Issues Archivematica Issues repository]. If you would like to file issues or make comments on existing issues, all you need is a Github account. If you would also like to add labels to issues and edit the Issues repo wiki you can request membership to the Issues-Committers team by filing an issue with the title ‘Request Membership’. We’ll add you to the team and you’ll be able to add labels and edit wiki pages.

* [https://github.com/archivematica/Issues Archivematica Issues repository]

==Resources==

Where possible, Artefactual tries to make all non-code resources openly available under a [https://creativecommons.org/licenses/by-sa/2.0/ CC-BY-SA] license. We strongly encourage re-use of these materials!

*[[Screencasts]]

*[[Presentations]]

==Camps==

[[Community/Camps| Archivematica Camps]] are intended to provide a space for anyone interested in or currently using Archivematica, to come together, learn about the platform and share their experiences.

Interested in organizing an Archivematica Camp in your region? Check out our [[Community/Camps/Hosting| Camp Hosting]] page!

==Logo download==

Need a logo?
* 47KB translucent Archivematica logo [[Media:ArchivematicaTranslucent.png|download]]
* 58KB solid background Archivematica logo [[Media:ArchivematicaLogoBest.png|download]]

==Stickers!==

''we see your inherent vices'' : [[:File:Archivematica-sticker-apr2014.pdf|PDF]]

[[Image:Archivematica-sticker-apr2014.png|500px|center|thumb]]

''chmod -R 777 /the/past/is/open'' : [[:File:Archivematica-sticker-july2013.pdf|PDF]]

[[Image:Archivematica-sticker-july2013.png|600px|center|thumb]]

''because 76% of time travellers agree that the future sucked'' : [[:File:Archivematica-sticker-nov2012.pdf|PDF]]

[[Image:Archivematica-sticker-nov2012.png|600px|center|thumb]]

Community/CaseStudies

2019-11-18T23:53:51Z

Ablewer: Replaced content with "This page has been moved to https://github.com/archivematica/archivematica-case-studies"

This page has been moved to https://github.com/archivematica/archivematica-case-studies

Main Page

2019-11-18T23:52:55Z

Ablewer: /* Community */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/archivematica-1.7/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[https://github.com/archivematica/archivematica-case-studies Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]

</div>

<div class="twitter">

== Twitter ==

{{#widget:Twitter Search}}

</div>

<div class="news">

</div>

</div><div style="overflow: hidden;">

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-11-18T23:49:48Z

Ablewer: /* Archivematica Camps! */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/archivematica-1.7/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[Community/CaseStudies| Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]

</div>

<div class="twitter">

== Twitter ==

{{#widget:Twitter Search}}

</div>

<div class="news">

</div>

</div><div style="overflow: hidden;">

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020.

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Main Page

2019-11-18T23:49:28Z

Ablewer: /* Archivematica Camps! */

<div style="background: #fff; float: right; padding: 1em; width: 30%">
<div class="download">

== Free Demo and Download ==
* [http://sandbox.archivematica.org Demo] - see [[Sandbox|Sandbox info]] for login
* [[Release Notes|Release notes]]
* [https://www.archivematica.org/en/docs/archivematica-1.7/admin-manual/installation-setup/installation/installation/ Installation]
* [http://www.artefactual.com/services/ Installation services]

</div>

<div class="documentation">

== [https://www.archivematica.org/ How to use Archivematica] ==
* User and administrative manuals at [http://www.archivematica.org archivematica.org]
* [https://www.artefactual.com/services/training/ Training services]

</div>

<div class="development">

== [[Development|Developer resources]] ==
*[[Development roadmap: Archivematica|Development roadmap]]
* Development [[Documentation|documentation]]
*[[Improvements|Proposed Improvements]]
*[https://projects.artefactual.com/projects/archivematica Issues list]
*[https://www.artefactual.com/partners/ Become an innovation partner]

</div>

<div class="community">

== [[Community|Community]] ==
*[https://groups.google.com/group/archivematica Discussion list]
*[[Community/CaseStudies| Case Studies]]
*[[Community|Free community resources]]
*[http://www.artefactual.com/services/archivematica/maintenance/ Get support]
*[[Contributors|Contributors]]
*[[Community/Camps|Camps]]

</div>

<div class="twitter">

== Twitter ==

{{#widget:Twitter Search}}

</div>

<div class="news">

</div>

</div><div style="overflow: hidden;">

== ''This is the Archivematica development wiki. For user and administrative manuals, as well as installation information, please visit [http://www.archivematica.org archivematica.org].'' ==

='''Archivematica gets its own issues repo'''=
Artefactual has moved towards a centralized [https://github.com/archivematica/Issues Issues repository on Github ] to track all bugs, enhancements and feature requests in the Archivematica environment.

From now on issues should be filed against the Issues repo instead of against a repo in the Artefactual organization.

= Archivematica Camps! =

Upcoming camps:

* Call for Presentations open -- [https://wiki.archivematica.org/Community/Camps/Brooklyn2020 Archivematica Con Brooklyn] The first Archivematica Con will be from April 15-17, 2020!

See all of our past camps [https://wiki.archivematica.org/Community/Camps here].

='''What is Archivematica?'''=

Archivematica is a free and open-source [[wikipedia:Digital preservation|digital preservation]] system that is designed to maintain long-term access to digital memory. Archivematica is packaged with the web-based content management system [https://www.accesstomemory.org/ AtoM] for access to your digital objects.

The [[overview]] section provides a detailed description of Archivematica's functionality and technical architecture. This screencast gives a demo of the core features in the most current release of the system.

{| width="100%" border="0" style="margin: 20px 0;" class="youtube"
| align="center" | <youtube>EjStNDXK48U</youtube>
|}

==='''Standards-based'''===

Archivematica uses a [http://en.wikipedia.org/wiki/Microservices micro-services] design pattern to provide an integrated suite of software tools that allows users to process digital objects from ingest to access in compliance with the ISO-OAIS functional model. Users monitor and control the micro-services via a web-based dashboard. Archivematica uses METS, PREMIS (events, agents, rights and restrictions), Dublin Core, the Library of Congress BagIt specification and other best practice standards and practices to provide trustworthy, authentic, reliable, and interoperable archival packages (AIPs) for storage in your preferred repository.

==='''Open source'''===

All Archivematica code is released under a GNU Affero General Public License ([http://www.gnu.org/licenses/agpl.html AGPL 3.0]) – giving you the freedom to study, modify, improve, and distribute it. We believe that an important part of preservation is transparency, and that memory institutions should be able to demonstrate at every stage what happens when they process cultural heritage materials for preservation. Archivematica [https://github.com/artefactual code] is always freely available, and our documentation is also released under a Creative Commons Share-alike license.

==='''Flexible and customizable'''===

Archivematica provides several decision points that give the user control over choices about format identification tools, printing the original order of the directories ingested, examining contents for private and personal information, extracting contents of packages and forensic images, transcribing content, and more. Users may also preconfigure most of these options for seamless ingest to archival storage and access. Archivematica offers many ingest workflows: metadata and submission documentation import, zipped and unzipped Bag ingest, digital forensic image processing, SIP arrangement, manual normalization, and dataset management.

==='''Compatible with hundreds of formats'''===

In the Format Policy Registry (FPR), Archivematica implements its default [[media type preservation plans|format policies]] based on an analysis of the [[significant characteristics]] of file formats. The FPR also offers an editable, flexible framework for format identification, package extraction, transcription and normalization for preservation and access. Your institution can update tools, rules and commands in your local FPR from the Artefactual-managed FPR server. You can also add your own, local policies to your internal FPR. The FPR is integrated with PRONOM.

==='''Advanced search and storage management'''===

You can easily search your backlog and your archival storage from within your Archivematica web-based dashboard. This means you can download stored AIPs as complete packages, individual objects, or every package in an AIC. You can also manage your storage and processing locations using the Archivematica Storage Service, including a two-step deletion process that requires justification and approval to eliminate a stored AIP.

==='''Integration with third-parties'''===

Memory institutions have dedicated voluminous resources over the past couple of decades to implement various software platforms and tools to manage digital objects. For this reason, we believe in leveraging the strength of other tools and integrating with them wherever possible. Highlights include: [https://www.accesstomemory.org/en/ AtoM], [http://www.dspace.org/ DSpace], [http://www.contentdm.org/ CONTENTdm], [http://islandora.ca/ Islandora], [http://www.lockss.org/ LOCKSS], [http://www.duracloud.org/ DuraCloud], [http://www.openstack.org/ OpenStack] and [http://www.archiviststoolkit.org/ Archivists' Toolkit]

The software applications integrated into Archivematica are each released under their own open source license. These are checked for license compatibility before they are integrated into the project. A full list of applications with their respective license is available on the [[External tools|external software tools]] page.

==='''Lead developers and partners'''===
This project is managed by [http://artefactual.com/archivematica.html Artefactual Systems]. Key funding contrbutors have included UNESCO Memory of the World's [http://portal.unesco.org/ci/en/ev.php-URL_ID=1720&URL_DO=DO_TOPIC&URL_SECTION=201.html Subcommittee on Technology], the [http://vancouver.ca/ctyclerk/archives/ City of Vancouver Archives], [http://www.library.hbs.edu/ Harvard Business School Baker Library], the [http://www.moma.org/ Museum of Modern Art (MoMA)], the [http://www.library.ualberta.ca/ University of Alberta Libraries], the [http://diginit.library.ubc.ca/ University of British Columbia Library], the [http://rockarch.org/ Rockefeller Archive Center], [http://www.sfu.ca/archives/ Simon Fraser University Archives and Records Management], [http://www.library.yale.edu/ Yale University Library], [http://www.zib.de/en/home.html Zuse-Institute Berlin], [http://www.coppul.ca/ Council of Prairie and Pacific University Libraries (COPPUL)], [http://bentley.umich.edu/ Bentley Historical Library, University of Michigan], [http://duraspace.org Duraspace], [http://libraries.mit.edu/ MIT Libraries], [http://www.ocul.on.ca/ Ontario Council of University Libraries], [https://www.llgc.org.uk/ National Library of Wales], [http://www.archivescanada.ca/ Canadian Council of Archives] and a number of other collaborators.
</div>

[[File:Artefactual_Logo.png|240px|center|link=http://www.artefactual.com/]] [[File:Cva.gif|160px]] [[File:Ubcblue_full.png|80px]] [[File:RAC-logo.png|80px]] [[File:Logo_en.gif|140px]][[File:SFULogo.jpg|150px]] [[File:UofAlogo.png|180px]][[File:LOGO_ulib_4cp_under75_png_4f05de2698.png|200px]] [[File:MoMA.png|180px]] [[File:FinalULBlues_copy.png|300px]] [[File:ZIBlogo-mediumlines.png|75px]] [[File:HarvardBaker30_image.png|250px]] [[File:Coppullogo.jpg‎]] [[File:UM-BHL-logo.png|120px]] [[File:DuraSpace_logo_horiz_300.png|260px]][[File:Mit_logo.png]] [[File:ocul_logo.png|200 px]] [[File:york_logo.png|240px]] [[File:hull_logo.png|220px]] [[File:NLW_logo1.jpg|330px]] [[File:Blue_Eng_First.png|360 px]] [[File:logo-en.png|360 px]]

__NOTOC__

Community/Camps/Geneva2019

2019-10-22T08:16:27Z

Ablewer: /* Know before you go */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Auditorium'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''IT Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''IT Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-22T06:57:46Z

Ablewer: /* Wednesday, October 23: Day Two */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Auditorium'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''IT Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''IT Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-22T06:57:29Z

Ablewer: /* Thursday, October 24: Day Three */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Auditorium'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''IT Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-22T06:57:04Z

Ablewer: /* Wednesday, October 23: Day Two */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Auditorium'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Auditorium'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''Data Centre'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-22T06:56:41Z

Ablewer: /* Tuesday, October 22: Day One - Archivematica 101 */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''Auditorium'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-16T15:58:10Z

Ablewer: /* Dates and Location */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-16T15:53:06Z

Ablewer: /* Dates and Location */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland. Check back for specific room information closer to the camp date.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a guarantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-16T15:47:09Z

Ablewer: /* Dates and Location */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland. Check back for specific room information closer to the camp date.

Access to the CERN campus is possible with a visitor's pass. All attendees should have received a reservation code when registering for the conference, and this code can be used to print badges at entrance points. In case you do not have your badge code, you must go to reception and get registered, showing your registration information for Archivematica Camp. CERN staff will be available as a gaurantor in case of issues -- the reception can call Jean-Yves Le Meur if necessary.

With an ID card and a badge or reservation code, the best is to enter at Entrance B and go to to IT Auditorium, 3rd floor, room 31-3-004. This is either a 10 minutes walk or a 7mn shuttle drive (from 300 SC to 504 Restaurant 2 of the shuttle, see [http://smb-dep.web.cern.ch/en/ShuttleService/Circuit_1 more information here] ).

For the full rules and guidelines for CERN access, see their official procedure page [http://admin-eguide-dev.web.cern.ch/en/procedure/visitors-cards-access-cern-visitors-and-conference-participants here].

Below is a map of the facilities.

[[File:Cern-map.jpg|1000px]]

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

File:Cern-map.jpg

2019-10-16T15:19:15Z

Ablewer:

Community/Camps/Geneva2019

2019-10-15T16:23:54Z

Ablewer: /* Social events */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland. Check back for specific room information closer to the camp date.

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-15T16:23:37Z

Ablewer: /* Wednesday, October 23: Day Two */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland. Check back for specific room information closer to the camp date.

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''Reception!''' At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Social events ==

=== Tuesday October 22, Small group dinners ===

We'll create a sign-up sheet containing a list of restaurants nearby. Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

=== Wednesday October 23, Reception and data center tour ===

At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].

Community/Camps/Geneva2019

2019-10-15T16:23:09Z

Ablewer: /* Tuesday, October 22: Day One - Archivematica 101 */

Without the World Wide Web, there would be no Archivematica. And without CERN, there would be no World Wide Web. So it only seems fitting that Archivematica Camp is heading to the birthplace of the web in October 2019!

Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, Archivematica Camp is intended to provide a space for anyone interested in or currently using Archivematica to come together, learn about the platform from other users, and share their experiences.

A big thanks to CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR) for co-hosting this camp!

== Dates and Location ==

'''October 22-24, 2019 - [https://home.cern/ CERN]'''

Sessions will be held at the CERN campus just outside of Geneva, Switzerland. Check back for specific room information closer to the camp date.

== Registration ==

Registration is now available through CERN's event portal: https://indico.cern.ch/event/792825/

Please note that you must continue to payment options. Registrations without payment will be considered invalid.

Early bird: €400.00, available until July 15st

Full price: €450.00, available until October 18th

Full registration gets you three full days of training, discussion, and deep dive sessions into related topics like METS visualization and preservation planning, taught by experienced Archivematica users and developers! Full registration also includes lunch and coffee breaks for all three days as well as appetizers at the group social event (To Be Announced).

==Know before you go==

'''Digital preservation knowledge expectations'''

If you've registered because you are curious about Archivematica but not sure what a SIP, DIP, or AIP is, you might find it helpful to read up on digital preservation fundamentals before Day 1. We recommend Ashley Blewer's [http://training.ashleyblewer.com/presentations/digital-preservation digital preservation] and [http://training.ashleyblewer.com/presentations/oais.html OAIS] slidedecks as good starting points to learn about digital preservation and the OAIS reference model, on which Archivematica is based. If you want to dive deeper, there are a lot of OAIS and digital preservation primers out there! A basic grounding in the fundamentals should be enough to get you started.

'''Bring a laptop'''

We have hands-on sessions planned and Archivematica pipelines ready for learning, so please bring a laptop! You may want to set up your own pipeline using vagrant and VirtualBox - this isn't required, but if you're keen then go for it. You'll find instructions to do that [https://www.archivematica.org/en/docs/archivematica-1.9/getting-started/quick-start/quick-start/#quick-start-install here] (please do this before you arrive at camp!).

'''Food'''

The morning coffee break will be catered and lunches will be provided. There are other places to find food and drink on the CERN campus as well.

'''Accessibility'''
TBD

'''Code of conduct'''

We are committed to providing a welcoming and positive experience for everyone, whether you are in a session, online, or in a social setting. This means that Archivematica Camp Geneva is governed by a [[#Code of Conduct|Code of Conduct]], which you can read at the bottom of this page.

'''Questions or concerns?'''

Please email us at info@artefactual.com with "Archivematica Camp Geneva" in the subject line and we'll get back to you as soon as possible.

== Camp Counsellors ==

From the community:

* Representative from CERN
* Representative from Docuteam GmbH
* Representative from United Nations High Commission for Refugees (UNHCR)

From Artefactual Systems:

* Ashley Blewer, AV Preservation Specialist / Systems Archivist
* Kelly Stewart, Director of Archival & Digital Preservation Services
* Justin Simpson, Managing Director

Local support for this camp is provided by CERN, Docuteam, and United Nations High Commission for Refugees (UNHCR). Thank you!

== Schedule ==

=== Tuesday, October 22: Day One - Archivematica 101 ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff;"|'''Time'''
|style="white-space: nowrap; width: 90%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30pm
|'''Welcome, announcements, and about Archivematica'''

|-
|style="white-space: nowrap;"|9:30am - 10:30pm
|'''Module 1: Archivematica in the digital preservation landscape'''
Topics covered include: where does Archivematica fit into the digital preservation landscape, what does Archivematica promise to do, what doesn't Archivematica do.

|-
|style="white-space: nowrap;"|10:30am - 10:45am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|10:45am - 12:00pm
|'''Module 2: How does Archivematica actually work?'''
Topics covered include: Archivematica's conceptual model, packages (transfers, bags, SIPs, AIPs, DIPs), microservices as implementations of preservation actions, workflows, storage spaces, how the Storage Service works, and how to get at your content.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 3: Archivematica's core functionality'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm - 5:00pm
|'''Module 3: Archivematica's core functionality, continued'''
Topics covered include: understanding Archivematica's dashboard, including the Transfer tab, Ingest tab, Administration tab, and Preservation planning tab, plus a first look at an AIP produced by Archivematica. This afternoon session includes hands-on exercises.

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"|'''Social group dinners''' [https://docs.google.com/document/d/1SfYfNvLQkwYwq3VVh1SzBEGlk25VFqdVX5cZCku5Lbc/edit# Sign up here!] Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

|}

'''Note''': participants are welcome to join the morning session, afternoon session, or both sessions as they wish. Participants may also wish to join the Camp on Day Two.
</br>

=== Wednesday, October 23: Day Two ===

{| border="1" style="border-collapse:collapse;"
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 9:30am
|colspan="2"|'''Community profile -- Dedagroup'''

|-
|style="white-space: nowrap;"|9:30am - 10:45am
|'''Module 4: Stream 1 - Understanding AIPs'''
Topics covered include how the AIP is structured and a close look at the METS file, as well as some community work to visualize METS files in a more human-friendly way.
|'''Module 4: Stream 2 - Supporting Archivematica users and their workflows'''
Topics covered include technical architecture, deployment, and working open-source.

|-
|style="white-space: nowrap;"|10:45am - 11:00am
|colspan="2"|Break

|-
|style="white-space: nowrap;"|11:00am - 12:00pm
|colspan="2"|'''Community profile -- UNHCR'''
"Keep your eyes on the information", Patricia Sleeman

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:45pm
|'''Module 5: Stream 1 - Building on core: Archivematica's specialized workflows'''
Topics covered include transfers of zipped files, disk images, metadata.csv, manual normalization, and a look at automation tools. This module includes hands-on exercises.

|'''Module 5: Stream 2 - Understanding Archivematica's logs and performance evaluation'''
Topics include monitoring, logs, the API, and automation tools.

|-
|style="white-space: nowrap;"|2:45pm - 3:00pm
|colspan="2"|Break

|-
|style="white-space: nowrap;"|3:00pm-4:00pm
|colspan="2"|'''Community profile -- CERN'''
"Benchmarking Archivematica for CERN scale", Jorik van Kemenade and Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|4:00pm - 4:45pm
|colspan="2"| '''Community profile -- DocuTeam'''

|-
|style="white-space: nowrap;"|5:00pm - 6:00pm
|colspan="2"| (Optional) Tours of the CERN data center, lead by Jean-Yves Le Meur

|-
|style="white-space: nowrap;"|6:00pm - 8:00pm
|colspan="2"| '''[https://wiki.archivematica.org/Community/Camps/Geneva2019#Wednesday_October_23.2C_Reception_and_data_center_tour Reception]! Snacks and beverages at CERN'''

|}
</br>

=== Thursday, October 24: Day Three ===

{| border="1" style="border-collapse:collapse; "
|style="white-space: nowrap; width: 10%; background-color: #93c9ff"|'''Time'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''
|style="white-space: nowrap; width: 45%; background-color: #93c9ff"|'''TBD'''

|-
|style="white-space: nowrap;"|9:00am - 10:00am
|colspan="2"|'''CERN tour'''
Groups will be led through a tour of the Antimatter Factory at CERN. You won't want to miss it!

|-
|10:15pm - 12:00pm
|'''Module 6: Stream 1 - Archivematica's non-core functionality'''
Topics covered include a look at the Backlog and Appraisal tab, AIP reingest, AIP encryption, transcription. This module includes hands-on exercises.

|'''Module 6: Stream 2 - Working with Archivematica data'''
Topics covered include accessing Archivematica’s data, other GitHub highlights, features showcase.

|-
|style="white-space: nowrap;"|12:00pm - 1:00pm
|colspan="2"|Lunch

|-
|style="white-space: nowrap;"|1:00pm - 2:00pm
|colspan="2" style="white-space: nowrap; width: 90%;"|'''Module 7: Archivematica in the community'''
Topics covered include how the code is written, collaborative digital preservation, and a look at the Archivematica roadmap.

|-
|style="white-space: nowrap;"|2:00pm - 3:00pm
|colspan="2" style="width: 90%;"|'''Module 8: Implementation roundtable'''
Discussion of various ways Archivematica can be implemented with a checklist of what you need to actually run Archivematica.
Campers are invited to share their particular Archivematica implementations, real or imagined.
Questions and participation mandatory!

|-
|style="white-space: nowrap;"|3:00pm - 3:15pm
|colspan="2" style="width: 90%;"|'''Wrap up'''
Safe travels!

|}

== Social events ==

=== Tuesday October 22, Small group dinners ===

We'll create a sign-up sheet containing a list of restaurants nearby. Campers can sign up to attend dinner at whichever restaurant piques their interest! This is a great way to meet new people and get out on the town.

=== Wednesday October 23, Reception and data center tour ===

At the end of camp on Day 2, campers will be directed towards where the reception will be held, within CERN (nearby the camping rooms). Between the end of camp at 5pm and the reception at 6pm, tours will be offered of the nearby CERN data center.

== Local arrangements ==

=== Hotels ===

<del>Participants interested in staying at the CERN Hotel should contact by email CERN.Hostel@cern.ch or call +41 22 767 4481 and they should mention they are attending Archivematica Camp 2019. The block of rooms held are Single occupancy with private bathroom, at a cost of CHF 58.00 per night. The block name is "W-Archivematica Camp 10.19". For budget code or team account requests, these fields should remain blank.</del>

CERN hostel rooms are now full.

For attendees wanting to stay in downtown Geneva, see the following hotel recommendations, see [https://smb-dep.web.cern.ch/en/content/hotels-and-apartment-hotels-local-area CERN's recommendations page].

=== Things to do in/near CERN/Geneva ===

Geneva is by no means a cheap destination, but like all destinations, there are many free and inexpensive things to do. With these tips, your wallet will be able to reemerge relatively unscathed.

=== Affordable Sit-Down Meals ===
Generally, the university area of Plainpalais is a good bet for food on the less painful end of extortionate.
Patricia’s top 4 eats – the rest are well known but could not vouch for them as much.

* 1. La Buvette des Bains; Quai du Mont-Blanc 30; Probably the best deal in town. Office workers in the know flock to this eatery on the jetty by the lake for its daily lunch specials.
* 2. Parfums de Beyrouth, Rue de Berne 18; Considered a hole-in-the-wall kind of place, but any of its assiette plates are more than enough to feed two people and are pretty tasty.
* 3. Sajeat, Rue des Alpes. Probbaly the best food in Geneva at 8Chfs it is simply a bargain. But standing up only. http://sajeat.ch/
* 4. Auberge de Saviese, Rue des Paquis 20, Geneva 1201, Switzerland
* 5. Chez ma Cousine Lissignol; Rue Lissignol 5; This place does one thing and it does it right: chicken and fries. The outdoor terrace is a great place to watch the people go by in this Old Town establishment.
* 6. Boky-FuShun, Rue des Alpes 21; Some praise its extensive Chinese menu, some say it's gross, but one thing's indisputable: It's hard to find a cheaper dinner in the city centre than here.
* 7. Carosello; Boulevard Georges-Favon 25; Enjoy good pizzas and the daily special (pizza with salad).
* 8. Manora, Rue de Cornavin 6; A self-service cafeteria on the top floor of department store Manor, it serves a wide choice of food and provides a panoramic view of the city.

=== Free Transport ===
You can actually get around free in Geneva.
==== Free Public Transit ====
Every person staying in a hotel, hostel, or camping place in Geneva is entitled to a handy little Geneva Transport Card, which gives them unlimited travel around the city and near suburbs for the entire duration of their stay. Ask for it at your hotel or hostel, and make sure you carry a passport with the card.
==== Free Airport Transfers ====
Before you leave the baggage claim area, look out for a machine that says "free ticket," right by the exit. This is no scam. Just press the button, and you'll get a ticket valid for the next 80 minutes on trains, buses and trams, completely free—enough to get you to your hotel.
==== Free Bikes ====

Renting a bike can cost you money, but there is a free alternative. Geneve Roule provides free bikes during the summer months for four hours at a time.
=== Free Wi-Fi ===
Throughout Geneva, there's free Wi-Fi, which is great news for those who are addicted to their phones. Look out for a network called "((o)) ville-geneve." The coverage is spotty, but it's totally free. There are plenty of hotspots scattered throughout the city.
The public library, with strong, free wireless signals, is located inside the Parc des Bastions. The reading room (salle de lecture) has workspace and electric plugs for your notebook.
There's also free Wi-Fi at the Geneva Airport, but you need a mobile phone. Get online first, and then follow the instructions to enter your phone number. A free access code will be sent to you as an SMS. Getting online is completely free, but some mobile carriers will charge you for receiving text messages abroad.
Many hotels, restaurants, and cafes around Geneva also advertise free Wi-Fi, but some require an existing account with an internet provider. So make sure the establishment has its own free Wi-Fi network before you plonk down and order that coffee.
Free Museums
Geneva has a number of wonderful museums that open their doors for free.

=== Free Museums ===
• Musée d'histoire des sciences de la Ville de Genève (Museum of History of Science)
De la Rive and de Saussure, you've seen their names on the streets. Now find out their significance as scientists at this museum of astronomy, geology, meteorology, and other disciplines.
• Muséum d'histoire naturelle (Natural History Museum)
Check out the variety of dioramas and other specimens.
• Espace Lullin
Take a look at rare 18th-century manuscripts that are housed inside the public library.
• Institut et Musée Voltaire
Enlightenment writer Voltaire spent some of his exile years in Geneva. His estate is now a museum dedicated to his work.

=== Not free but a must see. ===
Palais des Nations
International Red Cross and Red Crescent Museum
For various reasons – its famed neutrality, its location in the centre of Europe – Geneva is the seat of many international organisations, some of which are open to visitors. Head up to Nations to visit two of the best. The outstanding International Red Cross and Red Crescent Museum is unmissable for its moving and sometimes shocking permanent exhibition, which charts the vital humanitarian work carried out by the organisation for the past 150 years. Combine this with a guided tour of the Palais des Nations the European seat of the United Nations, for an insight into how the biggest issues facing the world today are tackled.

=== Museums With Free Permanent Collections ===
These museums open their doors for free every day, excluding temporary exhibitions.
• Maison Tavel
Artifacts and domestic objects illustrate everyday life in Geneva from the 16th to 19th century.
• Ariana Museum
Dedicated to the art of ceramic, the extensive museum presents more than 25,000 pieces on display.
• Musée d'Art et d'Histoire (Museum of Art and History)
This multidisciplinary museum draws from archeology to fine arts.
Their temporary exhibitions are also free, but only on the first Sunday of each month.
Free Outdoors Activities
Go outside and explore Geneva's stunning nature—gratis, of course.

=== Lake Geneva ===
You're never too far from picturesque Lake Geneva's water. There are 29 access points, the most popular being Bains des Paquis, where people-watching rivals swimming as the sport of choice.
For the less aquatically minded, there are also public shuttle boats, which are free with your Geneva transport card.

=== Geneva Greenery ===
Geneva is a green city, with about 20 percent of its total surface devoted to parks. In summer, the city even puts out free lawn chairs. Some excellent parks include:
• Botanical gardens: http://www.ville-ge.ch/cjb/
• Parc des Bastions: Play chess on a life-size board or listen to students strumming their guitars; in Plainpalais/University.
• Parc des Cropettes: Stretching from right behind the train station, the park features pond; in Quartier Les Grottes.
• Parc Beaulieu: Right across the street from Parc des Cropettes, this spot is especially great for kids; in Quartier Les Grottes.
• Jardin Anglais: It's a popular hangout with the famous flower clock; right on the lake.
• Parc des Eaux-Vives: This has a hilly park with gorgeous patches, along with its own beach and boat dock; in Eaux Vives.

=== Cheap Shopping ===
If you want to splurge, Geneva has no shortage of options. But if you want to save on your souvenirs, things get a little trickier. Here are a few budget shopping options.
• Marché de Plainpalais: One man's trash can be your treasure. You can find lots of old Swiss stuff here. Plaine de Plainpalais.
• Manore: Skip the fancy chocolate shops they build for tourists in the old city. This mega department store has a solid chocolate selection at surprisingly good prices. Rue de Cornavin 6.
• Boulevard Helvétique: Check out the outdoor farmers market for your Swiss produce pleasures.
• Place de la Madeleine: Purchase clothing and books here.

=== Places to eat ===

Coming soon!

==Code of Conduct==

The Archivematica community is dedicated to providing a welcoming and positive experience for everyone, whether they are in a formal session or a social setting related to an Archivematica event, or are taking part in activities online. Archivematica community participants come from all over the world and bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect. We are sensitive to the fact that the international nature of the Archivematica community means that we span many different social norms around language and behaviour and we strive to conduct ourselves in ways that are unlikely to cause offense. In the event that someone’s conduct is causing offense or distress, the Archivematica Camp has a detailed Anti-Harassment Policy, details below, which can be applied to address the problem.

The first step in dealing with any serious misconduct is to contact a member of the organizing group, or a counsellor at an Archivematica Camp (please see counsellors, above). These people will be made known before and during any Archivematica Camp event.

'''Anti-Harassment Policy'''

The Archivematica community is dedicated to providing a harassment-free conference/camp experience for everyone. If you have been harassed, please consult this protocol for conflict resolution which makes clear how we can help.

The Archivematica community has established the following policy to make it clear that we do not tolerate harassment in any form. Sexual or discriminatory language and imagery are not appropriate for any event venue, including talks, or any other communication channel used during the conference (such as social media).

Harassment includes:

* offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion;
* sexual or discriminatory images in public spaces;
* deliberate intimidation;
* stalking;
* harassing photography or recording;
* sustained disruption of talks or other events;
* inappropriate physical contact; and
* unwelcome sexual attention.

The lingua franca of Archivematica Camp is English; however, English may not be the native language of Archivematica Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among Archivematica Camp attendees. Campers are asked to please be mindful of the international character of Archivematica Camp, and to use respectful and clear language free of slang to facilitate communication.

Participants asked to stop any harassing behavior are expected to comply immediately.

If a participant engages in harassing behavior, event organizers and Archivematica representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from Archivematica Camp, or contacting a higher authority such as a representative from the offender’s institution.

If a participant raises a concern relating to actions covered by this policy in good faith, there will be no retaliation for bringing forward their concern. Threatening or taking action against someone for invoking this policy or for participating in any related investigation will be considered a violation of this policy.

Participants are expected to follow the anti-harassment policy at all Camp-related venues, Camp-related social events, and online communication channels.

We expect attendees and speakers past and present to be respectful to each other, and we will deal with any incidents that arise, including on social media.

We value your participation in the Archivematica community and your support in keeping the Archivematica community a safe, welcoming, and friendly space for fellow participants.

'''Acknowledgments'''

This policy is based on the [http://www.pasignyc.org/#code-of-conduct-section PASIG Code of Conduct], portions of which were modified from the [http://or2016.net/code-of-conduct/ Open Repositories’ code of conduct], which was itself modified from [https://www.seattleattic.com/codeofconduct Seattle Attic’s code of conduct] and the [http://adainitiative.org/what-we-do/events/ada-initiative-event-anti-harassment-policy/ Ada Initiative’s event harassment policy].

'''License'''

This document is licensed under [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons BY-SA].