Skip to content

Installation

adam-kosseck edited this page Nov 7, 2022 · 4 revisions

cepces can be installed manually by obtaining the source and installing, or by adding a repository for any of the supported distributions. This page describes the different strategies.

Manual Installation

To install the application manually, follow these steps:

  1. Obtain the latest source tarball from the releases page.

  2. Extract the source and change your working directory into the extracted source directory (e.g. cepces-X.Y.Z).

  3. Install development requirements:

     # dnf install -y krb5-devel gcc platform-python-devel
    
  4. Upgrade Pip (if required)

     # python3 -m pip install --upgrade pip
    
  5. Install all the Python requirements:

     # python3 -m pip install -r requirements.txt --user
    
  6. Install cepces:

     # python3 setup.py install
    

cepces should now be installed on your system. The Python library should be in the system's default package location, with the following extra files outside:

  • /usr/local/etc/cepces/cepces.conf.dist
  • /usr/local/etc/cepces/logging.conf.dist
  • /usr/local/libexec/certmonger

Add the provider to certmonger:

    # getcert add-ca -c cepces -e /usr/local/libexec/certmonger

Please consult the Configuration page for information on how to proceed.

Installing on Enterprise Linux 8

The application is provided through the Extra Packages for Enterprise Linux (EPEL) repository, this requirement can be satisfied by installing the package epel-release-latest-8:

# dnf install -y epel-release-latest-8

Once EPEL is present, install the cepces package and dependencies:

# dnf install -y cepces cepces-selinux cepces-certmonger certmonger

cepces should now be installed on your system. Please consult the Configuration page for information on how to proceed.

Installing on other Operating Systems

The copr RPM and DEB repositories are not actively maintained, and the packages found here are quite out of date. The instructions below are still relevant, however it is recommended to perform a manual install on these Operating Systems.

Installing on Enterprise Linux 7

The application is provided through a copr repository for Enterprise Linux 7. It requires Extra Packages for Enterprise Linux (EPEL) for some dependencies. In the case of CentOS 7, this requirement can easily be satisfied by installing the package epel-release.

# yum install epel-release

Once EPEL is present, obtain the cepces repository from ufven/cepces:

# curl https://copr.fedorainfracloud.org/coprs/ufven/cepces/repo/epel-7/ufven-cepces-epel-7.repo \
>/etc/yum.repos.d/ufven-cepces-epel-7.repo

With both the EPEL and copr repositories enabled, install the cepces package:

# yum install cepces

cepces should now be installed on your system. Please consult the Configuration page for information on how to proceed.

Installing on Fedora 24

The application is provided through a copr repository for Fedora 24. Enable the repository in one of two ways:

  1. Quick Enable using dnf:

         # dnf copr enable ufven/cepces
    
  2. or, download it manually:

         # curl https://copr.fedorainfracloud.org/coprs/ufven/cepces/repo/fedora-24/ufven-cepces-fedora-24.repo \
         >/etc/yum.repos.d/ufven-cepces-epel-7.repo
    

With the copr repository enabled, install the cepces package:

# yum install cepces

cepces should now be installed on your system. Please consult the Configuration page for information on how to proceed.

Installing on Ubuntu 16.04 (Xenial Xerus)

The application is provided through a PPA repository for Ubuntu. Enable the repository with the following command sequence:

$ sudo add-apt-repository ppa:ufven/cepces
$ sudo apt-get update

With the PPA enabled, install the cepces package:

$ sudo apt-get install cepces

cepces should now be installed on your system. Please consult the Configuration page for information on how to proceed.

Installing on openSUSE Tumbleweed

The application is provided through the default repositories on Tumbleweed.

$ sudo zypper in cepces