README-el7.md

*(This documentation has been moved from its previous location in 
https://twiki.cern.ch/twiki/bin/view/LCG/CentOS7DependencyRPM,
which is no longer maintained.)*

# **HEP_OSlibs meta-package for CentOS7 and CC7 (HEP_OSlibs for el7)**

HEP_OSlibs is a meta-package that captures the Linux OS dependencies 
of the software of the four LHC experiments.

This [README-el7.md](README-el7.md)
is the documentation page for HEP_OSlibs
on CentOS7, CC7 and other el7 RedHat systems.
- It describes HEP_OSlibs releases 7.3.x and above for el7,
  built using the gitlab-based workflow developed in October 2017
  and further modified in January 2021.
- It is maintained in the [el7](/../el7)
  branch of this project on gitlab.cern.ch.
- For a general overview of HEP_OSlibs on all supported platforms,
  please refer to the generic [master/README.md](/../master/README.md)
  file in the master branch.

## Git tags and rpm NVR (Name-Version-Release)

RPM filenames for HEP_OSlibs on RedHat
use the Name-Version-Package (NVR) format,
as described by the [RPM packaging guide](http://rpm-guide.readthedocs.io/en/latest/rpm-guide.html#what-is-a-spec-file)
and the [Fedora versioning guidelines](https://docs.fedoraproject.org/en-US/packaging-guidelines/Versioning).
- On el7, the Name of the meta-package is HEP_OSlibs.
  There is no longer a suffix indicating the O/S as on el6,
  where the name of the meta-package was HEP_OSlibs_SL6.
- Changes in the contents (i.e. the dependencies) of the meta-package
  are reflected in changes of the "upstream" RPM Version
  (e.g. from 7.1.9 to 7.1.10).
- The RPM Release is initially equal to 1%{?dist},
  as recommended by the [Fedora versioning guidelines](https://docs.fedoraproject.org/en-US/packaging-guidelines/Versioning);
  this value may then be incremented for new builds of the same Version.
    <br/>&nbsp; -
    Note that previous releases of the meta-package 
    built before the introduction of the gitlab-based workflow
    in October 2017 had an RPM Release equal to 0%{?dist}.
    <br/>&nbsp; -
    The RPM ["%{?dist}"](https://docs.fedoraproject.org/en-US/packaging-guidelines/DistTag) tag
    is equal to ".el7.cern" on CC7, with a trailing ".cern"
    (as can be seen by `rpm -E "%{?dist}"`).

Each new release of the meta-package
is assigned a new tag in this gitlab project.
- On el7, the gitlab tag is obtained
  by removing the trailing ".cern" from the RPM "Version-Release" identifier. 
  All gitlab tags for el7 thus end with ".el7".
- As an example, the gitlab tag for the latest release
  HEP_OSlibs-7.3.1-2.el7.x86_64.rpm is 7.3.1-2.el7.
- You may **browse here all [tags](/../tags?search=el7)
  of HEP_OSlibs for el7**,
  including tags for the legacy release series 7.0 and 7.1.

## CentOS7 vs CC7

The meta-package is designed
to be installed on CentOS7/CC7.

Packages may be specifically requested for CentOS7,
but the meta-rpm is only tested on CC7, not on CentOS7.

## 32-bit and 64-bit dependencies

The meta-package is designed to be installed
on CentOS7/CC7 64-bit (x86_64).

Currently (as of release 7.1.10), **only a 64-bit meta-rpm
with 64-bit package dependencies is built on el7.**
Installing this meta-package will only pull in 64-bit dependencies.
On CentOS7, all LHC experiments run their software in 64-bit mode only.

## Current release: 7.3.1-2.el7
<!-- Throughout this file, all occurrences of "7.3.1-2.el7" are
automatically replaced with the latest tag by the pkg.sh script -->

The latest stable release of HEP_OSlibs for el7
is [7.3.1-2.el7](/../7.3.1-2.el7).

<!-- KOJIBUILDID = buildID=49985 -- DO NOT DELETE! -->
This release was built via koji
(see http://koji.cern.ch/koji/buildinfo?buildID=49985).

<!-- *NB: (pre-)release candidates with tags x.y.z-0.prc\* or x.y.z-0.rc\*
are for internal use only and will not be made available for installation
through the WLCG repository, in spite of what may be written below.* -->

*Ongoing work on other release candidates currently in QA is described in the
[el7/QA-el7.md](/../el7/QA-el7.md) page.*

### Installation

The 64-bit meta-package for the latest release
7.3.1-2.el7 of HEP_OSlibs for el7 is available **only**
from the [WLCG](http://linuxsoft.cern.ch/wlcg/centos7/x86_64/)
repository at CERN.

As of release 7.3.0, the WLCG repository
is meant to be used for installing HEP_OSlibs for el7
both on CC7 systems at CERN (including lxplus7)
and on CentOS7 or CC7 systems at external Grid sites.

The GPG key of the WLCG repository is needed because
the HEP_OSlibs meta-rpm's in this repository are signed with this key,
as described [here](http://linuxsoft.cern.ch/wlcg/__README__).

The easiest way to install HEP_OSlibs from the WLCG repository consists
in first installing the [wlcg-repo rpm](https://linuxsoft.cern.ch/wlcg/centos7/x86_64/wlcg-repo-1.0.0-1.el7.noarch.rpm)
describing the wlcg repository and then installing HEP_OSlibs, as follows:
```bash
  yum install https://linuxsoft.cern.ch/wlcg/centos7/x86_64/wlcg-repo-1.0.0-1.el7.noarch.rpm
  yum install HEP_OSlibs
```

Installing the wlcg-repo rpm creates a repo file and a GPG key, 
typically in `/etc/yum.repos.d/wlcg-centos7.repo`
and `/etc/pki/rpm-gpg/RPM-GPG-KEY-wlcg`.

### Contents

The direct dependencies for the latest
release 7.3.1-2.el7 of HEP_OSlibs for el7
are declared in the corresponding rpm spec file,
which is available in gitlab:
- the rpm spec file used to build the package: <br/>
  see [HEP_OSlibs.spec](/../7.3.1-2.el7/HEP_OSlibs.spec)

Lists of direct and indirect dependencies have also been prepared
while testing the meta-package in the gitlab CI,
on a system running a minimal Docker image of `cern/cc7-base`.

The following six package lists for this release are available in gitlab:
- HEP_OSlibs direct dependencies, as a list
  (from `rpm -qpR`): <br/>
  see [HEP_OSlibs.x86_64.dependencies-direct.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.dependencies-direct.txt)
- HEP_OSlibs installed dependencies, as a list
  (from `rpm -qa`, before and after installation): <br/>
  see [HEP_OSlibs.x86_64.dependencies-installed.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.dependencies-installed.txt)
- HEP_OSlibs installed dependencies, as a list, with sizes in bytes
  (from `rpm -qa`, before and after installation): <br/>
  see [HEP_OSlibs.x86_64.dependencies-installed-size.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.dependencies-installed-size.txt)
- HEP_OSlibs installed dependencies, as a list, with version number
  (from `rpm -qa`, before and after installation): <br/>
  see [HEP_OSlibs.x86_64.dependencies-installed-nvra.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.dependencies-installed-nvra.txt)
- list of all packages present after HEP_OSlibs installation,
  with version number (from `rpm -qa`, after installation): <br/>
  see [HEP_OSlibs.x86_64.all-installed-nvra.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.all-installed-nvra.txt)
- HEP_OSlibs recursive dependencies, as a list
  (from `repoquery --tree-requires`): <br/>
  see [HEP_OSlibs.x86_64.dependencies-recursive-flat.txt](/../7.3.1-2.el7/dependencies/HEP_OSlibs.x86_64.dependencies-recursive-flat.txt)

<!-- GITURL = https://gitlab.cern.ch/linuxsupport/rpms/HEP_OSlibs -- DO NOT DELETE! -->
The six package lists mentioned above,
and additional information including the following files,
are also available for download as gitlab CI
[artifacts](https://gitlab.cern.ch/linuxsupport/rpms/HEP_OSlibs/builds/artifacts/7.3.1-2.el7-testing/browse/build?job=deploy_job):
- HEP_OSlibs installation log: <br/>
  download [HEP_OSlibs.x86_64.installation-log.txt](https://gitlab.cern.ch/linuxsupport/rpms/HEP_OSlibs/builds/artifacts/7.3.1-2.el7-testing/raw/build/HEP_OSlibs.x86_64.installation-log.txt?job=deploy_job)
- HEP_OSlibs recursive dependencies, as a tree
  (from `repoquery --tree-requires`): <br/>
  download [HEP_OSlibs.x86_64.dependencies-recursive-tree.txt](https://gitlab.cern.ch/linuxsupport/rpms/HEP_OSlibs/builds/artifacts/7.3.1-2.el7-testing/raw/build/HEP_OSlibs.x86_64.dependencies-recursive-tree.txt?job=deploy_job)

### Changelog
<!-- CHANGELOG = HEP_OSlibs.spec#L231 -- DO NOT DELETE! -->

Read the changelog for release 7.3.1-2.el7 in the
[HEP_OSlibs.spec](/../7.3.1-2.el7/HEP_OSlibs.spec#L231)
file.

## Updates (for developers)

To create a new release of HEP_OSlibs for el7,
read the description of the new [workflow](/../el7/workflow.md)
based on koji and gitlab CI jobs.

## Contact

Please contact the [heposlibs-dev](mailto:heposlibs-dev@cern.ch)
mailing list if you have change requests for this meta-package. 

All updates to this meta-package will be communicated
via the heposlibs-users mailing list
([register](https://e-groups.cern.ch/e-groups/Egroup.do?egroupId=10106256)).

## License

Copyright 2009-2021 CERN. 
Licensed under [LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.txt)
or (at your option) any later version.
See [COPYRIGHT.txt](COPYRIGHT.txt) for more details.