Getting Started

June 7, 2016

User Group Meeting

Chapel Hill, NC

Jason M. Coposky

@jason_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:

wget ftp://ftp.renci.org/pub/irods/releases/4.1.8/ubuntu14/irods-icat-4.1.8-ubuntu14-x86_64.deb

 

wget ftp://ftp.renci.org/pub/irods/releases/4.1.8/ubuntu14/irods-database-plugin-postgres-1.8-ubuntu14-x86_64.deb

Download iRODS 4.1.8:

git clone https://github.com/irods/irods_training

Install and configure Postgres

ubuntu $ sudo apt-get -y install postgresql

ubuntu $ sudo su - postgres

Prepare database for iRODS use:

postgres $ psql

CREATE DATABASE "ICAT";

CREATE USER irods WITH PASSWORD 'testpassword';

GRANT ALL PRIVILEGES ON DATABASE "ICAT" to irods;

\q

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/setup_irods.sh < /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 - https://unstable.irods.org/irods-unstable-signing-key.asc | sudo apt-key add -
echo "deb [arch=amd64] https://unstable.irods.org/apt/ $(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

Questions?

UGM 2016 - Getting Started

By jason coposky

UGM 2016 - Getting Started

  • 1,829