UCLALibrary/uclalib_role_fedora4

Ansible role to install and configure the Fedora repository application on a RHEL system using MySQL for the back-end

UCLALib Ansible Role: Fedora 4

Ansible role to install and configure the Fedora repository application on a RHEL system using MySQL for the back-end.

Deploy a bare-bones installation/configuration of a Fedora 4 repository server.

This role supports Fedora 4.7.X releases only.

Deployment documentation is for this version is available at Deploying Fedora 4 Complete Guide.

Official GitHub repository:

• https://github.com/fcrepo4-exts/fcrepo-webapp-plus
• https://github.com/fcrepo4/fcrepo4

Requirements

Please take note of the following assumptions:

• the Fedora repository server uses Red Hat Enterprise Linux as the OS
• a MySQL database server is available with the database created and user account/privileges established
• project-specific variables for this role should be defined in a host_vars or group_vars file

Role Variables

Variables with default values that do not need to be defined in the project-specific vars, but can be adjusted if necessary:

• fedora_url - defines the URL to obtain the Fedora WAR file
• fedora_base_dir - defines the location of Fedora Tomcat installation directory
• fedora_tomcat_user - defines the tomcat user fedora will run as
• fedora_min_mem - defines the fedora/tomcat minimum memory allocation
• Fedora_max_mem - defines the fedora/tomcat maximum memory allocation
• fedora_data_dir - defines the location of the Fedora data directory
• fedora_config_dir - defines the path to the external fedora configuration directory
• fedora_log_dir - defines the path to the fedora log directory

Project-specific variables that do need to be defined in host_vars or group_vars:

• fedora_version - defines the version of Fedora to use (e.g. 4.0.0, 4.5.0, etc.)
• fedora_db_user - defines the user fedora will use to connect to the database
• fedora_db_password - defines the password fedora will use to connect to the database
• fedora_db_host - defines the FQDN of the database server
• fedora_db_port - defines the network port for connecting to the database
• fedora_db_name - defines the name of the fedora database
• fedora_admin_user - defines the Fedora admin username
• fedora_admin_password - defines the Fedora admin password
• fedora_server_fqdn - defines the fully qualified domain name of the Fedora repository server

Fedora Download URL Note

The default value for the fedora_url variable is:

https://github.com/fcrepo4/fcrepo4/releases/download/fcrepo-{{ fedora_version }}/fcrepo-webapp-{{ fedora_version }}.war

If you are affiliated with UCLA, you have the option of overriding this default url value with:

http://pkgs.library.ucla.edu/fedora/fcrepo-webapp-{{ fedora_version }}.war

Versions of Fedora available via the UCLA URL are:

• 4.7.5
• 4.7.6

Dependencies

The following roles must be run on the Fedora repository server prior to executing this role:

• uclalib_role_rhel7repos
• uclalib_role_epel
• uclalib_role_uclalibrepo
• uclalib_role_java
• uclalib_role_apache
• uclalib_role_tomcat

Sample Variable Definition Formats

---

- name: uclalib_fedoratest.yml
  become: yes
  become_method: sudo
  hosts: all
  user: ansible
  vars:
    project_name: fedoraproject
    env_name: test
    tomcat_applications:
      - app_name: fedora
        shut_port: 8008
        conn_port: 8081
        rproxy_path: fcrepo

  roles:
    - { role: uclalib_role_rhel7repos }
    - { role: uclalib_role_epel }
    - { role: uclalib_role_uclalibrepo }
    - { role: uclalib_role_java, oracle_java_version: '1.8.0_181' }
    - { role: uclalib_role_apache }
    - { role: uclalib_role_tomcat }
    - { role: uclalib_role_fedora4, fedora_version: '4.7.5' }