Skip to content

Commit

Permalink
Remove references to Binder
Browse files Browse the repository at this point in the history
  • Loading branch information
replaceafill committed May 9, 2024
1 parent c574cad commit 49d467f
Show file tree
Hide file tree
Showing 12 changed files with 35 additions and 198 deletions.
1 change: 0 additions & 1 deletion admin-manual/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ set of links to each chapter's main sections.
installation-setup/integrations/integrations
installation-setup/integrations/duracloud-setup
installation-setup/integrations/atom-setup
installation-setup/integrations/binder-setup
installation-setup/integrations/archivesspace-setup
installation-setup/integrations/handlenet-setup
maintenance/maintenance
Expand Down
42 changes: 16 additions & 26 deletions admin-manual/installation-setup/customization/dashboard-config.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ dashboard, allow you to configure application components and manage users.
* :ref:`Processing storage usage <admin-dashboard-usage>`
* :ref:`DIP upload <admin-dashboard-dip-upload>`

* :ref:`AtoM/Binder DIP upload <admin-dashboard-atom>`
* :ref:`AtoM DIP upload <admin-dashboard-atom>`
* :ref:`ArchivesSpace DIP upload <admin-dashboard-AS>`

* :ref:`PREMIS agent <admin-dashboard-premis>`
Expand Down Expand Up @@ -287,41 +287,38 @@ processing locations to make more room on their server.
DIP upload
----------

Archivematica has access integrations with three access platforms: AtoM, Binder
and ArchivesSpace.
Archivematica has access integrations with two access platforms: AtoM and
ArchivesSpace.

.. _admin-dashboard-atom:

AtoM/Binder DIP upload
^^^^^^^^^^^^^^^^^^^^^^
AtoM DIP upload
^^^^^^^^^^^^^^^

Archivematica can upload DIPs directly to an `AtoM`_ website so that the
contents can be accessed online. Using the same configuration screen, you can
also configure Archivematica to upload DIPs to `Binder`_, which is built off the
AtoM framework.
contents can be accessed online.

The AtoM/Binder DIP upload configuration page is where you specify the details
of the AtoM or Binder installation you'd like the DIPs uploaded to (and, if
of the AtoM installation you'd like the DIPs uploaded to (and, if
using Rsync to transfer the DIP files, Rsync transfer details).

Before setting these details, please ensure that you have a working AtoM or
Binder site that is properly connected to Archivematica. See :ref:`Using AtoM
2.x with Archivematica <atom-setup>` or :ref:`Using Binder with Archivematica
<binder-setup>` for more information.
Before setting these details, please ensure that you have a working AtoM
site that is properly connected to Archivematica. See :ref:`Using AtoM
2.x with Archivematica <atom-setup>` for more information.

.. image:: images/AtoMDIPConfig.*
:align: center
:width: 80%
:alt: Configuration screen for AtoM or Binder DIP uploads
:alt: Configuration screen for AtoM DIP uploads

Fields:

* **Upload URL**: the URL of the destination AtoM or Binder website.
* **Login email**: the email address used to log in to AtoM or Binder.
* **Login password**: the password used to log in to AtoM or Binder.
* **AtoM/Binder version**: the version of the destination AtoM or Binder website.
* **Upload URL**: the URL of the destination AtoM website.
* **Login email**: the email address used to log in to AtoM.
* **Login password**: the password used to log in to AtoM.
* **AtoM/Binder version**: the version of the destination AtoM website.
* **Rsync target**: if you'd like to send the DIP with Rsync before it is
deposited in AtoM or Binder, enter the destination value for rsync, e.g.
deposited in AtoM, enter the destination value for rsync, e.g.
``foobar.com:/dips``. This field is optional.
* **Rsync command**: if you've entered an Rsync target, specify the remote
shell manually, e.g. ``ssh -p 22222 -l user``. This field is optional.
Expand Down Expand Up @@ -469,12 +466,6 @@ Generic parameters:
--rsync-target="archivematica@atom-hostname:/tmp" \
--debug
Binder DIP upload
+++++++++++++++++

For more information about configuring Binder, please see the :ref:`Binder
integrations page <binder-setup>`.

.. _admin-dashboard-AS:

ArchivesSpace DIP upload
Expand Down Expand Up @@ -918,6 +909,5 @@ This tab displays the version of Archivematica you're using.
.. _PBKDF2: https://en.wikipedia.org/wiki/PBKDF2
.. _How Django stores passwords: https://django.readthedocs.io/en/1.4.X/topics/auth.html#how-django-stores-passwords
.. _automation tools: https://github.com/artefactual/automation-tools
.. _Binder: https://binder.readthedocs.io/en/latest/contents.html
.. _Transifex: https://www.transifex.com/artefactual/archivematica/
.. _PID webservice being used by IISH: https://github.com/IISH/PID-webservice
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Configure DIP upload
--------------------

Once you have a working AtoM installation, enter the appropriate credentials and
information on Archivematica's Administration tab. See :ref:`AtoM/Binder DIP
information on Archivematica's Administration tab. See :ref:`AtoM DIP
upload <admin-dashboard-atom>` for more information about the fields and their
values.

Expand Down
52 changes: 0 additions & 52 deletions admin-manual/installation-setup/integrations/binder-setup.rst

This file was deleted.

24 changes: 0 additions & 24 deletions admin-manual/installation-setup/integrations/integrations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ listed below.
* :ref:`AtoM integration <atom-integration>`
* :ref:`ArchivesSpace integration <archivesspace-integration>`
* :ref:`Avalon Media System integration <avalon-media-system-integration>`
* :ref:`Binder integration <binder-integration>`
* :ref:`Duracloud integration <duracloud-integration>`
* :ref:`Swift integration <swift-integration>`
* :ref:`Islandora integration <islandora-integration>`
Expand Down Expand Up @@ -54,28 +53,6 @@ systems can be found in the `Avalon Media System Technical Documentation`_. This
workflow includes integration with Archivematica's `validation API endpoint` and
`Automation-Tools`_ DIP creation script.

.. _binder-integration:

Binder integration
------------------

`Binder`_ is an open-source web application for supporting the care, management,
and preservation of complex digital collections such as time-based media and
born-digital artworks. It provides users with a central interface through which
they can access, view and manage the rich technical metadata contained in
Archival Information Packages (AIPs) held by the repository, as well as managing
and describing the relationships between the components of a collections object,
its constituent digital objects, and the various external dependencies required
to preserve and display the collection over the long-term.

See :ref:`Using Binder with Archivematica <binder-setup>`.

.. note::

Binder is dependent on `TMS`_, a proprietary collections management software
primarily used in museum and gallery settings. Binder cannot currently work
without TMS.

.. _duracloud-integration:

Duracloud
Expand Down Expand Up @@ -162,6 +139,5 @@ For instructions to configure a Dataverse integration, see
.. _`Arkivum`: https://arkivum.com/
.. _`Arkivum Perpetua`: https://arkivum.com/heritage-higher-education-and-corporate-archives/
.. _`Handle.Net`: https://www.handle.net/index.html
.. _`Binder`: https://binder.readthedocs.io/en/latest/contents.html
.. _`TMS`: https://www.gallerysystems.com/products-and-services/tms-suite/tms/
.. _`validation API endpoint`: https://wiki.archivematica.org/Archivematica_API#Validate
1 change: 0 additions & 1 deletion index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,6 @@ The Access tab displays DIPs which have been sent to AtoM.
* :ref:`General description <access>`
* :ref:`Access systems <access-default>`
* :ref:`Upload a DIP to AtoM <upload-atom>`
* :ref:`Upload a DIP to Binder <upload-binder>`
* :ref:`Upload a DIP to ArchivesSpace <upload-as>`
* :ref:`Upload a DIP to ContentDM <contentdm>`
* :ref:`Store DIP <store-dip>`
Expand Down
83 changes: 6 additions & 77 deletions user-manual/access/access.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ directory. If this data is no longer needed, the uploadedDIPs directory can be
cleared out. See :ref:`Processing storage usage <dashboard-usage>` for more
information.

Archivematica's Access tab displays DIPs that have been uploaded to AtoM or
Binder. It does not display DIPs that have been sent to other access systems,
Archivematica's Access tab displays DIPs that have been uploaded to AtoM.
It does not display DIPs that have been sent to other access systems,
like ArchivesSpace.

*On this page:*
Expand All @@ -27,7 +27,6 @@ like ArchivesSpace.

* :ref:`Metadata-only upload to AtoM <upload-metadata-atom>`

* :ref:`Upload a DIP to Binder <upload-binder>`
* :ref:`Upload a DIP to ArchivesSpace <upload-as>`
* :ref:`Store DIP <store-dip>`
* :ref:`Review and download DIPs <review-dip>`
Expand All @@ -53,8 +52,8 @@ a thumbnail for each digital object.
A content management tool called `AtoM`_ is Archivematica's default access
system. AtoM is a web-based, open source application for standards-based
archival description and access in a multilingual, multi-repository
environment. Access integration workflows also exist for `ArchivesSpace`_,
`CONTENTdm`_, and `Binder`_.
environment. Access integration workflows also exist for `ArchivesSpace`_ and
`CONTENTdm`_.

.. _upload-atom:

Expand Down Expand Up @@ -224,75 +223,6 @@ object and AIP UUIDs, format name, format version, format registry and key.
:width: 90%
:alt: AtoM description showing uploaded item with digital object metadata

.. _upload-binder:

Upload a DIP to Binder
----------------------

To upload DIPs to your Binder instance, you must enter your Binder information
and credentials in the Administration tab. See :ref:`AtoM/Binder DIP upload
<admin-dashboard-atom>` for more information.

.. important::

You must create the target resource in Binder **before** uploading the DIP.
You will need to indicate the resource's identifier in order to send the DIP
to the appropriate place during DIP upload.

For artwork records, the access system identifier is listed as the ``Object
ID`` in the TMS metadata. For a supporting technology record, the access
system identifier is the ``ID`` value that is automatically generated by
Binder, not the Dublin Core metadata identifier that you can add when you
create the record.

DIPs can be uploaded to an artwork record or a supporting technology record in
Binder.

There are two ways to provide the target resource to Archivematica. The first is
by providing the identifier during the Upload DIP microservice.

1. Process your transfer. You must select ``Normalize for preservation and
access`` or ``Normalize for access`` at the Normalization microservice. When
you reach the Upload DIP microservice, select "Upload DIP to AtoM/Binder"
from the drop-down menu.

2. A dialogue box will appear. Enter the identifier for the resource in the
dialogue box, preceded by either ``ar:`` for an artwork record or ``tr:`` for
a supporting technology record. For example, if the identifier for an artwork
record is "2", enter ``ar:2``. If the identifier for a supporting technology
record is "5779", enter ``tr:5779``.

.. image:: images/binder-dip-upload.*
:align: center
:width: 60%
:alt: Image shows a popup window where a user can enter identifier for the resource in Binder

3. Click the blue "Upload" button. The DIP will be uploaded to Binder and
connected to the appropriate resource.

In a more automated environment, you can add the identifier to the **Access
system ID** box when you are setting up your transfer. Archivematica will
automatically grab this value when it reaches the Upload DIP microservice.

1. Create a new transfer. In the ``Access system ID`` box, enter the identifier
for the resource, preceded by either ``ar:`` for an artwork record or ``tr:``
for a supporting technology record. For example, if the identifier for an
artwork record is "2", enter ``ar:2``.

.. image:: images/binder-access-system-id.*
:align: center
:width: 60%
:alt: Image shows new transfer with a Binder identifier defined as the access system ID

2. Process your transfer. You must select ``Normalize for preservation and
access`` or ``Normalize for access`` at the Normalization microservice. When
you reach the Upload DIP microservice, select "Upload DIP to AtoM/Binder"
from the drop-down menu (or set this as the preconfigured choice in the
processing configuration).

3. Check the target description in AtoM. The digital object(s) should be
displayed as child objects of the record.

.. _upload-as:

Upload a DIP to ArchivesSpace
Expand Down Expand Up @@ -390,7 +320,7 @@ All DIPs that have been stored are available for download through the
:ref:`Packages tab in the Storage Service <storageservice:packages-tab>`. This
is the default method for downloading DIPs.

If you have used the Upload DIP functionality to send your DIP to AtoM/Binder,
If you have used the Upload DIP functionality to send your DIP to AtoM,
ArchivesSpace, or CONTENTdm, you will have the option to review the DIP from the
Archivematica user interface. When the Upload DIP microservice is complete, a
"review" link will appear:
Expand Down Expand Up @@ -418,7 +348,7 @@ Access tab
----------

By clicking the Access tab in the Dashboard, you can see a table showing all
DIPs upload to AtoM or Binder including the URL, the associated AIP, the upload
DIPs upload to AtoM including the URL, the associated AIP, the upload
date and status, and the option to delete from the Access tab. Note that this
link will delete the record of the DIP in the Access tab, not the actual DIP.

Expand All @@ -430,5 +360,4 @@ to other access systems or DIPs that have been stored.
.. _`AtoM`: https://www.accesstomemory.org
.. _`ArchivesSpace`: https://archivesspace.org/
.. _`CONTENTdm`: https://www.oclc.org/en/contentdm.html
.. _`Binder`: https://binder.readthedocs.io/en/latest/contents.html
.. _`AtoM glossary`: https://www.accesstomemory.org/docs/latest/user-manual/glossary/glossary/
Binary file not shown.
Binary file removed user-manual/access/images/binder-dip-upload.png
Binary file not shown.
17 changes: 7 additions & 10 deletions user-manual/administer/dashboard-admin.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ integrations and users.
* :ref:`Processing storage usage <dashboard-usage>`
* :ref:`DIP upload <dashboard-dip-upload>`

* :ref:`AtoM/Binder DIP upload <dashboard-atom>`
* :ref:`AtoM DIP upload <dashboard-atom>`
* :ref:`ArchivesSpace DIP upload <dashboard-AS>`

* :ref:`PREMIS agent <dashboard-premis>`
Expand Down Expand Up @@ -650,22 +650,20 @@ directories to save space on the server.
DIP upload
----------

Archivematica has access integrations with three access platforms: AtoM, Binder,
Archivematica has access integrations with two access platforms: AtoM
and ArchivesSpace. For more information on Archivematica
integrations, please see the :ref:`Integrations <integrations>` page.

.. _dashboard-atom:

AtoM/Binder DIP upload
^^^^^^^^^^^^^^^^^^^^^^
AtoM DIP upload
^^^^^^^^^^^^^^^

Archivematica can upload DIPs directly to an `AtoM`_ website so that the
contents can be accessed online. Using the same configuration screen, you can
also configure Archivematica to upload DIPs to `Binder`_, which is built off the
AtoM framework.
contents can be accessed online.

For more information on configuring the AtoM/Binder DIP upload parameters and
the servers, please see the :ref:`AtoM/Binder DIP upload <admin-dashboard-atom>`
For more information on configuring the AtoM DIP upload parameters and
the servers, please see the :ref:`AtoM DIP upload <admin-dashboard-atom>`
configuration instructions.

**Levels of description**
Expand Down Expand Up @@ -807,6 +805,5 @@ This tab displays the version of Archivematica you're using.
.. _LZMA: https://www.7-zip.org/sdk.html
.. _Parallel bzip2 (pbzip2): https://launchpad.net/pbzip2/
.. _gzip: https://launchpad.net/gzip
.. _Binder: https://binder.readthedocs.io/en/latest/contents.html
.. _Transifex: https://www.transifex.com/artefactual/archivematica/
.. _Bulk Extractor: https://github.com/simsong/bulk_extractor/wiki
2 changes: 1 addition & 1 deletion user-manual/ingest/ingest.rst
Original file line number Diff line number Diff line change
Expand Up @@ -585,7 +585,7 @@ the Archivematica interface. To configure AIP storage locations, see the
Upload DIP
----------

Archivematica supports DIP uploads to AtoM, Binder, ArchivesSpace, and
Archivematica supports DIP uploads to AtoM, ArchivesSpace, and
CONTENTdm. For information about uploading DIPs to your access system, see
:ref:`Access <access>`.

Expand Down
Loading

0 comments on commit 49d467f

Please sign in to comment.