Getting Started

June 7, 2016

User Group Meeting

Chapel Hill, NC

Jason M. Coposky


Interim Executive Director

Advanced Training - Schedule and WiFi

Guest WiFi SSID "UNC-Guest" is not broadcast

 9:00am - BEGIN
 9:15am - Getting Started
 9:45am - Upgrading to iRODS 4.2
10:15am - BREAK
10:30am - PAM/SSL Configuration
12:00pm - LUNCH
 1:00pm - Composable Resources & Rule Engine Plugins
 2:15pm - BREAK
 2:30pm - Microservice & API Plugins
​ 3:45pm - BREAK
 4:00pm - High Availability
 4:30pm - Student Driven Discussion
 5:00pm - END

Beginner Training - Schedule and WiFi

Guest WiFi SSID "UNC-Guest" is not broadcast

 9:00am - BEGIN
 9:00am - Introduction
 9:45am - Planning an iRODS Deployment
10:15am - BREAK
10:30am - Installation of 4.2.0 preview
12:00pm - LUNCH
 1:00pm - iCommands and Cloud Browser
 2:15pm - BREAK
 2:30pm - Virtualization
 3:00pm - Basic Metadata
 3:45pm - BREAK
 4:00pm - Basic Rule Engine
 5:00pm - END

Little Slips of Paper & Dependencies

Logging in to your VM:

Install iRODS Build Requirements:

sudo apt-get update


sudo apt-get -y install git g++ make python-dev help2man unixodbc libfuse-dev libcurl4-gnutls-dev libbz2-dev zlib1g-dev libpam0g-dev libssl-dev libxml2-dev libkrb5-dev unixodbc-dev libjson-perl python-psutil python-jsonschema super python-exif odbc-postgresql

Acquire the Prerequisites

Clone the training repository:




Download iRODS 4.1.8:

git clone

Install and configure Postgres

ubuntu $ sudo apt-get -y install postgresql

ubuntu $ sudo su - postgres

Prepare database for iRODS use:

postgres $ psql


CREATE USER irods WITH PASSWORD 'testpassword';



postgres $ exit

Install iRODS 4.1.8

sudo dpkg -i ./irods-icat-4.1.8-ubuntu14-x86_64.deb

sudo dpkg -i ./irods-database-plugin-postgres-1.8-ubuntu14-x86_64.deb

sudo apt-get -f install

sudo /var/lib/irods/packaging/ < /var/lib/irods/tests/localhost_setup_postgres.input

Install downloaded packages:

Run setup with provided input file:

Configure the Repository and Upgrade

Note: This is for Testing Purposes Only

wget -qO - | sudo apt-key add -
echo "deb [arch=amd64] $(lsb_release -sc) main" | \
  sudo tee /etc/apt/sources.list.d/renci-irods-unstable.list
sudo apt-get update

sudo apt-get -y install irods-server irods-database-plugin-postgres

Install public key and add repository:

Upgrade from repository:

sudo service irods start

Restart iRODS:

Upgrading Large Installations

Things to consider

  • Database Snapshots
  • Attempt a graceful grid-wide shutdown ahead of time
  • Test Zones - do not upgrade blindly
  • Conformance Tests - try your edge cases
  • Federated Zones - how mixed is your deployment



Maintenance Window

  • In the Lab:
    • 10M Data Objects
    • VM with 10GB RAM, 4 VCPUs, Rotational Disk
    • Upgrade from 4.1.8 to 4.2.0 took 13 minutes
  • Estimate:
    • 100M Data Objects to take ~2-3 hours


UGM 2016 - Getting Started

By jason coposky

UGM 2016 - Getting Started

  • 1,459
Loading comments...

More from jason coposky