AtoM Camp SFU 2017

From AtoM wiki

Main Page > Community > Community/Camps > SFU 2017

We're excited to announce the first-ever AtoM Camp, cohosted by the Simon Fraser University Archives and Artefactual! Inspired by similar events like Hydra Camp, Islandora Camp and Fedora Camp, AtoM Camp is intended to provide a space for anyone interested in or currently using AtoM to come together, learn about the platform from other users, and share their experiences.

Dates & Location[edit]

March 20-22, 2017 - Harbour Centre at Simon Fraser University

515 West Hastings Street, Vancouver, B.C. V6B 5K3

SFU Harbour Centre is located in downtown Vancouver, BC and is part of SFU's Vancouver campus. It's convenient to transit and is within easy walking distance of many hotels, restaurants, and Vancouver's historic Gastown neighbourhood.

Note that there are multiple entrances for Harbour Centre - look for the SFU-branded signage and the entrance address 515 W Hastings, rather than 555 W Hastings.

We will be using Policy Room 7000, located on the 7th floor, and meeting room 2250, on the 2nd floor.

Harbor-centre-map.png

Click image for larger map

Territorial acknowledgement[edit]

We acknowledge that the land on which we will gather is the traditional territory of the Coast Salish peoples, specifically the shared traditional territories of the Sḵwxwú7mesh Úxwumixw (Squamish), Tsleil-Waututh, and xʷməθkʷəyəm (Musqueam) First Nations.

Accessibility[edit]

SFU Harbour Centre, including the rooms that we have booked for the Camp, is fully accessible to people with mobility difficulties and people who use wheelchairs with the exception of the SFU Harbour Centre Library (which we will not be using). The SFU Physical Access Guide has information about the accessibility of Harbour Centre beginning on page 210 of the PDF (page 196 on the document).

If you require any other disability accommodation, physical or otherwise, please let us know by email at info@artefactual.com.

Getting to Vancouver[edit]

Flying into Vancouver

Vancouver is served by most major and regional airlines through Vancouver International Airport (YVR).

The Canada Line of Vancouver's Skytrain system runs from the airport to downtown Vancouver. Fares from the airport cost $7.10. For more information about public transit from the airport, see YVR's website. For more information about the Skytrain, see Translink.

Taxis from YVR into the city are subject to a zone fare of $31.

Taking the train or bus to Vancouver

Vancouver's main train and bus terminal is Pacific Central Station. Vancouver is served by Via Rail, Greyhound, and other services.

Getting to Harbour Centre[edit]

Walking from the Delta Hotel

Delta Vancouver Suites, at 550 W Hastings St, is located directly across the street from Harbour Centre at 515 W Hastings St.

Transit

Harbour Centre is located a short walk from Waterfront Skytrain station in Zone 1, which is a stop for the Expo Line and the Canada Line Skytrains. It is also served by four bus routes:

  • 23 – Stanley Park / New Westminster
  • 123 – Burrard Station / New Westminster Station
  • 35/135 – SFU / Stanley Park
  • 50 – Waterfront / False Creek South, stops on Cordova Street, north side of Harbour Centre

Vancouver's transit system is called Translink. Transit tickets are available at ticket vending machines at all Skytrain stations, which accept debit, credit, and cash. You can also pay cash fare on buses. See the Translink website for fare information.

If you plan to take transit often while you are in Vancouver, you may wish to pay a deposit to receive a plastic Compass Card which can be loaded with a stored value.

Vancouver has fare zones in place, so make note of where your origin and destination stops are located.

Parking

The closest parking lots to Harbour Centre are located at 500 and 450 West Cordova St.

Registration[edit]

Professional rate: $450.00

Student rate: $350.00 (10 available)

Camp Counsellors[edit]

At all of the camps that Artefactual hosts, we seek to provide attendees with counsellors who have a wide range of experience with the software. Supplementing members of the Artefactual crew will be counsellors who have extensive experience with AtoM as users and administrators.

Tim Hutchinson

Tim Hutchinson has been an archivist at the University of Saskatchewan since 1997, and is currently the Head of University Archives & Special Collections. As the technical lead for the Saskatchewan Archival Information Network (SAIN), he has been heavily involved with AtoM since 2010, when he undertook the migration of the SAIN databases from a group of legacy systems into AtoM … before any bulk import tools were actually available in AtoM. He has also coordinated all of the University of Saskatchewan’s local and contracted development of AtoM.

Dan Gillean

Dan serves as AtoM Program Manager and provides quality assurance testing, requirements analysis, documentation, technical support and community dialogue for Artefactual’s AtoM and Archivematica projects.

Sara Allain

Sara started working at Artefactual on both the AtoM and Archivematica projects in 2016, providing requirements analysis, user documentation, QA testing and community support. Prior to her work at Artefactual Sara worked in academic libraries as - depending on the day - an archivist and/or a librarian, tackling wide-ranging subjects like data migration, Islandora implementation, digitization management, and library communications. She firmly believes that the best way to learn is to dive in headfirst - because there probably aren't any sharks in the water. Right?

Schedule[edit]

The schedule is a work in progress. Depending on the make-up of the campers, sessions might range from AtoM 101 for absolute beginners to command line tools to systems administration. We look forward to welcoming campers with a wide range of experience with AtoM!

Potential topics[edit]

The registration form allows campers to select some topics of interest from a pre-set list, which includes topics that we think will be of interest:

  • AtoM 101 - beginner's guide to AtoM (or a helpful refresher if it's been a while!)
  • Importing and exporting archival descriptions using CSV templates.
  • Performing common tasks on the command line (importing, updating records, etc.).
  • Customizing the front end through the web interface (menus, static pages, etc.).
  • Maintenance and troubleshooting (sysadmins).
  • Maintenance and troubleshooting (front-end users).
  • Creating custom AtoM themes.
  • Installation and deployment.
  • Developing new features.
  • Contributing to the AtoM documentation.
  • Future of AtoM and/or project governance.

Is there something you think we're missing from the list? When you register, there will be a field to suggest any other topics you want us to cover. If there's a critical mass of people who want to discuss a particular topic, we'll cover it! During the camp, we'll also leave lots of space to adjust the schedule to give time to specific topics as they come up.

Day One[edit]

Time Earl and Jennie Lohn Floor Policy Room 7000 Westcoast Energy Executive Meeting Room 2250
9:00am - 9:30am Arrival and sign-in
9:30am - 9:45am Welcome: Introductions, code of conduct, agenda overview, etc.
9:45am - 11:00am AtoM 101, part 1: This session is intended to ensure that everyone is on the same page and has a basic understanding of AtoM. We'll talk about the history of the project and run through a demonstration of basic functionality. If you're an experienced AtoM user, we would love it if you could help out your neighbours! Get to know AtoM's codebase: An introduction for developers and systems administrators covering symfony, developer resources, standard practices, and other information.
11:00am - 11:15am Break
11:15am - 12:00pm Vagrant installation and configuration: Intended for archivists (don't let the words installation and configuration scare you!), this session will focus on ensuring that everyone has a working AtoM instance on their laptop, which will be used throughout the camp for hands-on work. Installation and upgrading: This session will cover recommended installation parameters, gotchas and tips for installing on other systems, using Ansible for deployment, managing upgrades, and multi-site management.
12:00pm - 1:00pm Lunch
1:00pm - 1:15pm Agenda adjusting
1:15pm - 2:30pm AtoM 101, part 2: This session will give campers some hands-on practice with their new AtoM instance. More experienced users will have the opportunity to ask questions about issues they have with their instance. This is also a good chance for interested devs and sysadmins to gain front-end experience with the application (helpful for troubleshooting!). Creating custom themes: This session will incorporate an introduction to relevant theming files, registering a plugin, home page customizations, and also give devs a chance to create basic themes.
2:30pm - 3:30pm Import and export through the user interface: Continuing on the theme of hands-on training, this session will show campers how to construct and import archival descriptions, authority records, taxonomies, and other data types using CSV and SKOS templates. This session will also touch on new functionality - updating records en masse through the user interface! MySQL queries: Campers will get an overview of AtoM's data model and start constructing simple queries for reporting and data cleanup, among other uses, using PHPmyAdmin and other tools.
3:30pm - 3:45pm Break
3:45pm - 4:45pm Basic CLI tasks: This session will give everyone a grounding on using the command line for basic maintenance, user management, troubleshooting, and data import/export. Even if you don't use the command line firsthand, this session will be helpful for understanding the functionality provided by AtoM's CLI.
4:45pm - 5:00pm Wrap-up
5:00pm - late Evening social event: small sign-up group dinners

Day Two[edit]

Time Earl and Jennie Lohn Floor Policy Room 7000 Westcoast Energy Executive Meeting Room 2250
9:30am - 9:45am Morning announcements
9:45am - 11:00am Implementation tours: This session is a chance for users of all stripes to show off their current implementations - or to discuss future implementations! If you're interested in discussing how AtoM works (or might work) in your institution, come prepared with a 5-10 minute informal presentation and/or your questions.
11:00am - 11:15am Break
11:15am - 12:15pm Customizing the front end through the web interface: This session will cover how to manage menus, static pages, labels, themes, and other front-end customizations - no coding required. Campers will again use their personal AtoM instances to get hands-on experience configuring their own sites. Feature development: Thinking of developing a new feature or customization for AtoM? This session will expand upon the code overview session and introduce best practices for developing features - and sharing them back with the community. A look at plugin registration, major modules, functions and classes, as well as how Artefactual performs code review and public code management, including things to consider when planning a development project and submitting code to the public AtoM branch.
12:15pm - 1:15pm Lunch
1:15pm - 1:30pm Agenda adjusting
1:30pm - 2:30pm Managing access: During this session, campers will focus on creating and managing users and groups, editing group permissions, and implementing PREMIS rights rules. We'll also talk about managing multi-tenanted AtoM instances. Workflows with Archivematica: Campers interested in integrating their AtoM instance with Archivematica can learn about DIP upload, passing descriptive and rights metadata from Archivematica to AtoM, and future enhancements to Archivematica's AtoM integration.
Dev/sysadmin clinic: An informal opportunity for devs and sysadmins to discuss any issues, suggestions, ideas, or wild speculations with the experts.
2:30pm - 2:45pm Break
2:45pm - 4:45pm Future of AtoM/project governance: This session is intended to be partly a showcase of what's coming up in AtoM development as well as a chance to collaboratively discuss where the AtoM project - and the AtoM community - is headed.
4:45pm - 5:00pm Wrap-up
6:00pm - late Evening social event: group mixer at Salt Tasting Room

Day Three[edit]

Time Earl and Jennie Lohn Floor Policy Room 7000 Westcoast Energy Executive Meeting Room 2250
9:30am - 9:45am Morning announcements
9:45am - 10:45am Contributing to documentation: From typos to improved feature descriptions, we love when the AtoM community improves the docs! This session will act as an introduction to AtoM's documentation - how they're organized, how they're maintained, how we use Sphinx, and, of course, how to contribute to the docs. We'll cover some basic git/Github information as well. Free space: Room 2250 is booked for AtoM Camp for the duration of Wednesday, March 22. Want to work through some AtoM problems? Interested in convening a small group to discuss another topic? Go forth and self-organize!
10:45am - 11:45pm Data migrations: Leaving a thorny topic for last, this session will be an overview of potential approaches to data migration. We'll go over known challenges, how to map to standards, data cleanup using OpenRefine, scripting transformations, and AtoM's import formats.
11:45am - 12:00pm Agenda adjusting
12:00pm - 1:00pm Lunch
1:00pm - 2:00pm Lightning sessions and open discussion: A final free-for-all discussion!
2:00pm - 2:15pm Closing

Social events[edit]

Monday, March 20th

Small sign-up group dinners - sign up here: https://docs.google.com/document/d/1SFGmPSyhD4H66PtkATt1LFKMnGfP35me49S1_kLKTcI/edit?usp=sharing

Tuesday, March 21st

AtoM community mixer at Salt Tasting Room.

Accommodations & Things To Do[edit]

Downtown Vancouver has many hotels located within an easy walk or transit ride of SFU Harbour Centre.

We have secured a corporate booking rate at the Delta Vancouver Suites, located at 550 W Hastings St. The booking code for the Delta is included in the email confirmation you received after registration. To use this code, go to the Delta Vancouver Suites website, select your dates, and then click on Special Rates and enter the code under Corporate/promo code.

If you are a CAUBO member, you can also use your CAUBO promo code at the Delta. More information is available on the CAUBO website.

Things to Do in Vancouver[edit]

Code of Conduct[edit]

The AtoM 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 AtoM event, or are taking part in activities online. AtoM 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 AtoM 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 AtoM 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 AtoM Camp (please see counsellors, below). These people will be made known before and during any AtoM Camp event.

Anti-Harassment Policy

The AtoM 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 AtoM 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 AtoM Camp is English; however, English may not be the native language of AtoM Camp participants. Further, cultural norms around what may be considered obscene and offensive communication will vary among AtoM Camp attendees. Campers are asked to please be mindful of the international character of AtoM 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 AtoM representatives (or their designees) may take any action they deem appropriate, including warning the offender, expulsion from the AtoM 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 AtoM community and your support in keeping the AtoM community a safe, welcoming, and friendly space for fellow participants.

Acknowledgments

This policy is based on the PASIG Code of Conduct, portions of which were modified from the Open Repositories’ code of conduct, which was itself modified from Seattle Attic’s code of conduct and the Ada Initiative’s event harassment policy.

License

This document is licensed under Creative Commons BY-SA.

Contact[edit]

Questions? Concerns? Please get in touch with us at info@artefactual.com.