fixes across the board

Signed-off-by: Fotis Georgatos <fotis@cern.ch>
split installation methods; add that & search ref in index

Signed-off-by: Fotis Georgatos <fotis@cern.ch>