Groups keyboard shortcuts have been updated
Dismiss
See shortcuts

Step-by-step setting of ezid platform

85 views
Skip to first unread message

Adama

unread,
Aug 17, 2024, 4:42:45 PM8/17/24
to ARKs
Dear all,
We would like to build a platform for assigning and resolving ARK. I would like to install an ezid server preferably on an ubuntu server or through docker/portainer. I am looking for a reproducible step-by-step turorial or akind.
Maybe you saw something like that. Can you help me with that?
Best regards
Adama

Greg Janée

unread,
Aug 19, 2024, 1:40:39 PM8/19/24
to ARKs
Hello Adam, I forwarded your question to the EZID service manager at CDL and he replied, "The complexity and specificity of its codebase, in addition to its infrastructure requirements, means that it is not terribly well-suited to the more basic use case of getting started with minting and resolving ARKs."  Unfortunately, it sounds like what you seek does not exist.  -Greg

Greg Janée

unread,
Aug 19, 2024, 1:42:40 PM8/19/24
to ARKs
*Adama* -- sorry for mangling your name

Nathan Tallman

unread,
Aug 19, 2024, 2:03:35 PM8/19/24
to arks-...@googlegroups.com
You may find something suitable on the Resources page, though. There are links to several standalone and plugin ARK implementations for minting, binding, and resolving. https://arks.org/resources/#plug-ins-and-software



--
You received this message because you are subscribed to the Google Groups ARKs group. To post to this group, send email to arks-...@googlegroups.com. To unsubscribe from this group, send email to arks-forum+...@googlegroups.com. For more options, visit this group at https://groups.google.com/d/forum/arks-forum?hl=en
---
You received this message because you are subscribed to the Google Groups "ARKs" group.
To unsubscribe from this group and stop receiving emails from it, send an email to arks-forum+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/arks-forum/adeedc80-72d4-4762-953c-a75a21c196e9n%40googlegroups.com.

John Kunze

unread,
Aug 19, 2024, 2:38:10 PM8/19/24
to arks-...@googlegroups.com
Yes, indeed. In particular,  Arklet-Frick has been generating lots of interest lately and is getting tested by WACREN (there will be a blog post soon about that).

Here's the blurb from the resources page that Nathan mentioned. Arklet-Frick: the Frick Collection’s adaptation of the Internet Archive’s arklet tool, with improved security and bugfixes, as well as bulk operations, suffix passthrough, shoulder rules, extensive metadata, ?info and ?json endpoints, and more.

Adama

unread,
Aug 23, 2024, 5:33:18 AM8/23/24
to arks-...@googlegroups.com
Hello Greg, Nathan and John,
It is fine. No problem with the name. Thank you very much for your reply and the precision about the ezid server. I thought that minting would be more straightforward with such a server compared to the alternatives proposed on the ark.org website.

In fact, I was able to install a pulled version of Arklet-Frick (https://github.com/squidgetx/arklet) on a brand new ubuntu server that can correctly resolve and assign a NAAN and shoulder. But the steps of using the REST API for minting were not clear for me and showed errors. I used an online tool (https://reqbin.com/post-online) to do the POST request online but resulted in failure. This could be a permission issue as the install folder is in the home folder but I don't know how to change or even uninstall it in order to restart the process in a shared or more accessible folder.

If anyone can advise about the usage of this arklet-frick pull or about the steps to follow for minting, would be greatly appreciated. Indeed a blog about that would great as well.
Best regards
Adama

Donny Winston

unread,
Aug 23, 2024, 7:52:15 AM8/23/24
to ARKs
John and I ran a workshop on June 3rd during which I presented on a toy deployment of a modified arklet-frick, but my slides were mere minimalist prompts to myself, and I don't think the workshop was recorded. I was able to dig up some example `curl` commands I used, which I've pasted below. The first command is a minting request. I hope this helps. But hmm, perhaps I should record a short video or something.

Best,
Donny

```bash
curl -X POST "${ARK_API_URL}/mint" -H "Authorization: ${ARK_API_KEY}" -d '{"naan": "57802", "shoulder": "/fk2", "url": "https://example.org"}' 

curl -I "${ARK_API_URL}/ark:57802/fk2rfgvbtbv6"  

curl "${ARK_API_URL}/ark:57802/fk2rfgvbtbv6?info"  

curl "${ARK_API_URL}/ark:57802/fk2rfgvbtbv6?json"  

curl -X PUT "${ARK_API_URL}/update" -H "Authorization: ${ARK_API_KEY}" -d '{"ark": "ark:57802/fk2rfgvbtbv6", "url": "https://next.example.org"}'  

curl -L "${ARK_API_URL}/ark:57802/fk2rfgvbtbv6"
```

--
Donny Winston, PhD (he/him/his)
Polyneme LLC
New York, NY

Adama

unread,
Aug 23, 2024, 9:30:27 AM8/23/24
to arks-...@googlegroups.com
Hi Donny,
Thank you for these examples I will try. This is an excellent starting point. But as you said a short video would be really helpful. I guess other metadata would be after the option -d {...}. Did you try the bulk minting from xls, txt or xml files also?
Thank you for this great input.
Best wishes
Adama

Adama

unread,
Aug 23, 2024, 1:47:20 PM8/23/24
to arks-...@googlegroups.com
Dear Donny,
I used your command and replaced the API_URL, target url, naan and shoulder but it didn't seem to work. When I tried the first command line alone, the following result appeared but nothing seems to change when I have a look in the admin panel.
image.png
Is there a command to list the minted ark associated to a given naan and shoulder?
Thanks
Adama

On Fri, Aug 23, 2024 at 1:52 PM Donny Winston <do...@polyneme.xyz> wrote:

Adama

unread,
Aug 23, 2024, 1:53:16 PM8/23/24
to arks-...@googlegroups.com
here is an error after the minteing command
image.png
Maybe this can help understand better the issue

Donny Winston

unread,
Aug 23, 2024, 4:48:02 PM8/23/24
to ARKs
We’re getting into the weeds now, but I encountered this error and decided it was a bug in the code, so I committed a fix in my fork (https://github.com/polyneme/arklet-frick) that I used for the workshop. You’re welcome to use (or cherry-pick changes from) my fork.

Adama

unread,
Aug 25, 2024, 9:58:52 AM8/25/24
to ARKs
Great Donny. Thank you for this excellent reply. Indeed, by applying your fixes to the install based on squidgetx/arklet, the minting and resolving are both working well. It remains to implement the bulk minting through csv file. Do you have curl command to list the ark of a given naan or shoulder?
Best
Adama
Reply all
Reply to author
Forward
0 new messages