AtoM Installer (for Linux)

[Guillermo Castellano Casas]

Hi there,

I have updated my AtoM GNU/Linux Installer after the release of the version 2.5. The code is 100% open source and you can check and/or download it from this GitLab repo.

The lowest AtoM version supported is 2.4. Currently it only supports Ubuntu 16.04 for AtoM 2.4 and Ubuntu 18.04 for AtoM 2.5.

I am working on an issue to add Ubuntu 16.04 support for AtoM 2.5. It would be great if you have managed to install AtoM 2.5 in other GNU/Linux distributions (Debian, CentOS, Fedora...) and you felt like sharing your install scripts in this repo!

Please read the contribution guidelines before submitting a Pull Request.

As this is my first message here, I would like to thank Artefactual Systems for providing so much help in this forum.

BR,

Guillermo

[Dan Gillean]

Wow! 

Thanks for sharing this, Guillermo! May I add this to the community resources listed on our wiki?

Regarding other distributions, it's not a script per se, but one of our sysadmins created some CentOS/ RHEL installation notes for AtoM a while back, which you can find here: 

• https://wiki.accesstomemory.org/wiki/Community/Community_resources  
  

Thanks again - I look forward to looking more closely at this!  

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

On Tue, Sep 17, 2019 at 4:40 AM Guillermo Castellano Casas <guillea...@gmail.com> wrote:

Hi there,

I have updated my AtoM GNU/Linux Installer after the release of the version 2.5. The code is 100% open source and you can check and/or download it from this GitLab repo.

The lowest AtoM version supported is 2.4. Currently it only supports Ubuntu 16.04 for AtoM 2.4 and Ubuntu 18.04 for AtoM 2.5.

I am working on an issue to add Ubuntu 16.04 support for AtoM 2.5. It would be great if you have managed to install AtoM 2.5 in other GNU/Linux distributions (Debian, CentOS, Fedora...) and you felt like sharing your install scripts in this repo!

Please red the contribution guidelines before submitting a Pull Request.

As this is my first message here, I would like to thank Artefactual Systems for providing so much help in these forums.

BR,

Guillermo

--
You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/feef4d41-8972-4c8b-ada6-042e53de90ee%40googlegroups.com.

[Guillermo Castellano Casas]

Sure!

I'll check the CentOS/RHEL installation notes and see if i can automate the process when I have some time.

Thanks and BR,

Guillermo

El martes, 17 de septiembre de 2019, 16:59:16 (UTC+2), Dan Gillean escribió:

Wow! 

Thanks for sharing this, Guillermo! May I add this to the community resources listed on our wiki?

Regarding other distributions, it's not a script per se, but one of our sysadmins created some CentOS/ RHEL installation notes for AtoM a while back, which you can find here: 

• https://wiki.accesstomemory.org/wiki/Community/Community_resources  
  

Thanks again - I look forward to looking more closely at this!  

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

On Tue, Sep 17, 2019 at 4:40 AM Guillermo Castellano Casas <guille...@gmail.com> wrote:

Hi there,

I have updated my AtoM GNU/Linux Installer after the release of the version 2.5. The code is 100% open source and you can check and/or download it from this GitLab repo.

The lowest AtoM version supported is 2.4. Currently it only supports Ubuntu 16.04 for AtoM 2.4 and Ubuntu 18.04 for AtoM 2.5.

I am working on an issue to add Ubuntu 16.04 support for AtoM 2.5. It would be great if you have managed to install AtoM 2.5 in other GNU/Linux distributions (Debian, CentOS, Fedora...) and you felt like sharing your install scripts in this repo!

Please red the contribution guidelines before submitting a Pull Request.

As this is my first message here, I would like to thank Artefactual Systems for providing so much help in these forums.

BR,

Guillermo

--
You received this message because you are subscribed to the Google Groups "AtoM Users" group.

To unsubscribe from this group and stop receiving emails from it, send an email to ica-ato...@googlegroups.com.

[José Raddaoui]

This is great Guillermo,

I took a quick look to the Bionic script and I think the only thing missing is enabling and starting the atom-worker service. You may want to enable the service in the script and add a note in the README to start the service after running the web installer, as the worker requires a connection to the database.

Thanks a lot for sharing!

Bests,

Radda.

[Dan Gillean]

Thanks again, Guillermo! 

I've added this to our wiki here: 

• https://wiki.accesstomemory.org/wiki/Community/Community_resources/Development#AtoM_Linux_Installer_scripts  
  

Cheers, 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/909a8856-4bb8-4a0f-800b-3dd72081662a%40googlegroups.com.

[Matthew Bruton]

This is wonderful. I was just about to sit down with the manual and install all the dependencies one by one. I was not looking forward to it.

But I will give this a go. Thanks!

Dan, should I report any issue I might have on this thread, or start another one?

[Dan Gillean]

Hi Matthew, 

This is not something that Artefactual has developed or maintained, so if you find issues, I would recommend reading Guillermo's the contribution guidelines and filing an issue in his repository to let him know - though I'm sure he would appreciate feedback on this thread as well! 

Artefactual does maintain some automated deployment scripts for AtoM using Ansible, which can be found here: 

• https://github.com/artefactual/deploy-pub  
  

These assume some familiarity with using Ansible or similar deployment automation tools, and require the deployment variables to be customized before use. 

Cheers, 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

--

You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/1b105240-4387-46d2-9109-f096ab521bfc%40googlegroups.com.

[Matthew Bruton]

Just updating to say that I used the installer and it worked great! Thanks so much Guillermo.

Using putty to log into my virtual server, I was able to initiate the script and had no problems with the command line interface. I had to make sure it was operating out of the right folder but that was all.

As for the web side installation I stalled a bit at the stage for elastic search. Apparently there was insufficient memory in for the Java runtime environment. A preventative solution is to obviously make sure that you have enough memory, but I changed the memory needed as outlined in this thread: https://stackoverflow.com/questions/31677563/connection-refused-error-on-elasticsearch

Then I ran into difficulties with mysql and root privileges. I used this thread to help me: https://stackoverflow.com/questions/36864206/sqlstatehy000-1698-access-denied-for-user-rootlocalhost

See the response by Matematikisto

Anyway, after that I got through and it is now up and running!

[Dan Gillean]

Hi Matthew, 

Thanks for letting us know how it went, and sharing some of your troubleshooting strategies - I'm sure this will be helpful to others! 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

On Tuesday, September 17, 2019 at 9:40:39 AM UTC+1, Guillermo Castellano Casas wrote:

--

You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/405e5a89-7128-4223-9d2d-07f42eed6543%40googlegroups.com.

[Guillermo Castellano Casas]

Hi everyone,

I have made some improvements after reading your comments:

• Support to install AtoM 2.5 in Ubuntu 16.04.
• Separate script to enable and start the atom-worker service.

I have also added to the README file a link to the official docs in order to check the minimum hardware requirements before running the installer.

I am glad that my work is useful for you and I appreciate your kind feedback. Remember that you can open issues in the project repository and contribute to the installer if you want :).

BR,

Guillermo

[Dan Gillean]

Amazing! Thanks for sharing this, Guillermo! 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

--

You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/bcb6a863-4965-47b7-9889-199b79cd4b4b%40googlegroups.com.

[Matthew Bruton]

Dan,

Is there a way to uninstall atom and all it's dependencies so that I can run the installer again?

[Dan Gillean]

Hi Matthew, 

Unfortunately, not that I know of - you will need to manually uninstall all of the dependencies. I've previously shared some instructions for removing Elasticsearch in this thread: 

• https://groups.google.com/d/msg/ica-atom-users/Ph6tuzlTOUk/CacVfgzUBAAJ
  

However, with many of the other additional dependencies, you will probably need to do some searching online for how to properly remove them. 

Regards, 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

On Wed, Oct 2, 2019 at 7:28 AM Matthew Bruton <matthewb...@gmail.com> wrote:

Dan,

Is there a way to uninstall atom and all it's dependencies so that I can run the installer again?

--

You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/23dd0679-8d11-4058-aa0b-f4df01778a77%40googlegroups.com.

[Guillermo Castellano Casas]

Hi Dan,

While fixing a bug in the script to enable and start the atom-worker service, I have noticed a little mistake in this page of the official docs.

The docs provide the same instructions for Ubuntu 16.04 and 18.04, but in the /usr/lib/systemd/system/atom-worker.service file we should assign a different command to ExecStart if we are working in Ubuntu 16.04, as it uses PHP 7.0 instead of PHP 7.2. I would suggest to add a note telling the user to pick the right PHP version.

Thanks and BR,

Guillermo

You received this message because you are subscribed to a topic in the Google Groups "AtoM Users" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/ica-atom-users/xy4Fha_OUe4/unsubscribe.
To unsubscribe from this group and all its topics, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CAC1FhZ%2BZgpGgmdG-JA6H92pRNkBxp%3DVoHVmZwtPEg897Lvz5Xw%40mail.gmail.com.

[Karl Goetz]

There isn't an uninstall option but the following will help get you on the right path:

- work backward through the install documentation
(https://www.accesstomemory.org/en/docs/2.5/admin-manual/installation/linux/ubuntu-bionic/) `apt remove`ing everything you `apt
install`ed
- install debfoster and or deborphan then run them. Please be smart if you decide to do this; they'll happily uninstall recommended system
packages if you ask them to.
- `rm -rv` any further configuration file/s and folder/s listed in the documentation.

kgoetz@minister:~$ apt show debfoster
[...]
Description: Install only wanted Debian packages
debfoster is a wrapper program for apt and dpkg. When first run, it
will ask you which of the installed packages you want to keep
installed.
.
After that, it maintains a list of packages that you want to have
installed on your system. It uses this list to detect packages that
have been installed only because other packages depended on them. If
one of these dependencies changes, debfoster will take notice, and
ask if you want to remove the old package.
.
This helps you to maintain a clean Debian install, without old
(mainly library) packages lying around that aren't used any more.

kgoetz@minister:~$ apt show deborphan
[...]
Description: program that can find unused packages, e.g. libraries
deborphan finds "orphaned" packages on your system. It determines which
packages have no other packages depending on their installation and shows
you a list of these packages. It is most useful when finding libraries,
but it can be used on packages in all sections.
.
This package also includes orphaner, a text menu frontend to deborphan.
Please install the recommended packages dialog, gettext-base and apt when
you want a working and fully featured orphaner.


All that said if you are planning to do repeated tests I suggest making a disposable VM for the purpose then
- create vm
- snapshot
- run script
- restore snapshot


thanks,

--
Karl Goetz
Technical Services Officer - eResearch, Information Technology Services
University of Tasmania & Tasmanian Partnership for Advanced Computing

Mail: University of Tasmania, Private Bag 69, Hobart, Tasmania 7001
Delivery: TT Flynn Street, Sandy Bay, Tasmania 7005



University of Tasmania Electronic Communications Policy (December, 2014).
This email is confidential, and is for the intended recipient only. Access, disclosure, copying, distribution, or reliance on any of it by anyone outside the intended recipient organisation is prohibited and may be a criminal offence. Please delete if obtained in error and email confirmation to the sender. The views expressed in this email are not necessarily the views of the University of Tasmania, unless clearly intended otherwise.

[Dan Gillean]

Thanks for the tips, Karl!

Guillermo, thank you for pointing that out. I have filed the following ticket for us to review and update the documentation: 

• https://github.com/artefactual/atom-docs/issues/127  
  

We'll try to get that done soon. 

Cheers, 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CA%2B9XYp_XwJ-i%2BqJoMjVzR5sUJLgu9is9w3uDoxS8YS1X98rNRg%40mail.gmail.com.

[Guillermo Castellano Casas]

Hi there,

I just wanted to let you know that I have updated the installer and now it is possible to use it to install the latest version of AtoM (2.6) in Ubuntu 18.04.

Have a nice day!

BR,

Guillermo

[Dan Gillean]

Thanks for sharing, Guillermo! 

I've updated the entry on our wiki to reflect your changes: 

• https://wiki.accesstomemory.org/wiki/Community/Community_resources/Development#AtoM_Linux_Installer_scripts
  

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
604-527-2056

@accesstomemory

he / him

To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/a4c0f9c0-b5cc-43d2-bf7a-68f3eb37f094n%40googlegroups.com.