...
In addition, there is timestamp information stored in the ACE Tokens which serves as a piece of provenance for when a file was first validated by Chronopolis.
Links
- Gitlab: https://gitlab.umiacs.umd.edu/adapt/ace
- Builds: http://adaptci01.umiacs.umd.edu/resource/ace
- API: https://ace-docs.umiacs.io/
Installation
Installation instructions are available on the ACE Wiki
Administration
Database Connection Setup
Note: ACE-AM does not currently work with the mariadb java connector
...
Code Block | ||||
---|---|---|---|---|
| ||||
<Resource name="jdbc/aceamdb" auth="Container" factory="com.zaxxer.hikari.HikariJNDIFactory" type="javax.sql.DataSource" minimumIdle="10" maximumPoolSize="32" connectionTimeout="300000" driverClassName="com.mysql.jdbc.Driver" jdbcUrl="jdbc:mysql://localhost/aceinnodb?characterEncoding=UTF-8" dataSource.user="ace" dataSource.password="-----------" /> |
Adding A Collection
Removing A Collection
When viewing a collection, select the Remove Collection
option from the drop down list of available actions. You will be prompted to acknowledge the delete, after which all files, tokens, and logging events will be removed from ACE.
On larger collections it can take time for all the monitored information to be removed, but ACE can still be browsed during this time.
Removing A File
Browse Servlet
When viewing a collection, select the Remove
will remove the File from tracking in the Collection, and the page will likely need to be refreshed to accurately display the contents of the Collection.
...
If a File has been intentionally removed from disk and needs to be removed from ACE AM, a File Audit can be run in order for it to be marked as Missing
. Once missing, the option can be selected in order to view the Report from the latest Audit. From the Report Servlet
, the missing file can be removed by using any of the Remove actions (all, selection, single). The ACE AM will then prompt for confirmation to remove the File(s) after which they will no longer be tracked by ACE AM. A File Audit
should be run after removing any files from the Report Servlet
so that the error status of the collection can be cleared.
Creating Peer User
Creating a new user is done through the Accounts
servlet which is available from the top most navigation bar in ACE AM. Supplying an account with the following properties allows a peer to log in and provide any comparison operations without allowing them to make changes to your local ACE.
Adding A Peer
Adding a site is done through the /PartnerSite page. Currently no link is available on the main ACE page - only through editing a collection's settings: Add Peers -> Add New
or the Compare Collection -> Add New
under Partner
Peer Auditing
In order to initiate an on demand peer comparison, the Compare Collection
option must be selected when viewing a collection. Then, selecting the Partner
option will bring up a list of all peer ACE AMs, which can be selected. ACE will try to find the matching collection by default, but if it is not found you must select the collection to compare to your self.
Re-Importing Tokens
Occasionally we need to re-import tokens in order to keep consistency among the network about what is being validated. This can be done either through the API or through the web UI, and this example will be going through the UI.
- Transfer the token store for your collection on to a local workstation (this is needed for the file upload)
- Tokens are transferred alongside the collection, so they should be on the same filesystem your replication client pulls into.
- Within chronopolis, the token store is normally suffixed with the date it was written, so for the collection
figshare_1074_productionfiles_2019-05-22-10-53-00
the token store will befigshare_1074_productionfiles_2019-05-22-10-53-00_2019-06-06
- Select your collection in the ACE AM interface and using the
more...
drop down menu, selectImport Tokens
- Using the Browse form option, navigate to the token store which you transferred to your local workstation and upload it to the ACE Audit Manager
- Status of the Token Import can be tracked in a few ways
- The
Import Tokens
servlet should direct to aTokenImportStatus
page, showing which tokens are processing - The
aceam.log
will display a line when a token is imported - The
Event Log
will receive new entries titledTOKEN_INGEST_UPDATE
which will all be linked to the session which is importing the Tokens
- The
Database Dump
Directions for dumping the ACE Database:
...