Digitalia ARTS MUNI Technical Documentation

Setting up a new server

1. Server setup and pre installation steps:
   1. Ask CIT to set up new server, install Ubuntu 22. Optional: set up the server via Ansible, see Ansible in GitLab ICS MUNI, and servers_setup playbook, contact kic_admins@ics.muni.cz for details).
   2. Prepare Ansible environment, see Digitalia Ansible and run the playbook islandora_preinstall_playbook.yml on the server where Islandora is about to install. It is necessary to prepare a password for islandora user and copy a public key that will be used by Islandora Ansible install under islandora user via become: islandora.

      ansible-playbook --limit '<server_domain_name>' digitalia-ansible/playbooks/islandora_preinstall_setup.yml -e "islandora_password='<islandora_user_password>'" -e "ansible_ssh_public_key_file='<path_to_your_ssh_public_key_used_for_ansible_setup>'"
      

2. Islandora installation
   1. Follow the official Ansible Playbook: Deploying to a remote environment. The last two steps ansible-playbook -i inventory/production playbook.yml ... may take 20 minutes. Notice: Do not forget to add -K param to the ansible-playbook -i inventory/production playbook.yml ... to let Ansible to ask you for the become password (pasword of the islandora user).
3. Postinstallation set up
   1. Optional: set up https via ansible-playbook --limit="<server_name>" playbooks/letsencrypt.yml, see Ansible in GitLab ICS MUNI
   2. Run ansible-playbook --limit="<server_name>" playbooks/islandora_postinstall_setup.yml