Skip to content

Installation

Pre-Requisites

ACME requires Python 3.10 or newer. Install it with your favorite package manager or as part of a virtual environment.

Installation and First Setup

Installation

There are two ways to install the ACME CSE: using pip or by doing a manual installation.

Run pip to install the ACME CSE from the Python Package Index (PyPI):

Install ACME CSE
python -m pip install acmecse

This will install the latest version of the ACME CSE and all required dependencies.

You can also upgrade to the latest version by running:

Upgrade ACME CSE
python -m pip install --upgrade acmecse

  1. Install the ACME CSE by cloning the repository, or by downloading the latest release package, unpacking it, and copying the whole distribution to a new directory.

    Clone the Repository
    git clone https://github.com/ankraft/ACME-oneM2M-CSE.git
cd ACME-oneM2M-CSE

  2. It is recommend to install the required packages by running the following command:

    Install Required Packages
    python3 -m pip install -r requirements.txt

    You may also install the packages manually, but make sure to install the exact versions as specified in the requirements.txt file.

    An alternative is to let ACME handle the installation automatically when running it for the first time (see below).

Guided Configuration

The ACME CSE can be configured by an interactive process when it is started for the first time. This process will create a configuration file that can be edited later.

  1. Run the CSE for the first time.
    You can start the CSE by simply running it from the command line:

    Run the following command from the command line from within any directory that uses the Python environment where you installed the package:

    Start ACME CSE
    acmecse

    Run the following command from the command line from within the directory where you installed the CSE:

    Start ACME CSE as a module
    python3 -m acme

    Please refer to the Running documentation for more detailed instructions how to start and run the ACME CSE.

    If you have not installed the required packages during the installation ACME will ask you to install them now. This can be done by ACME automatically, or you can do it manually (see above).

    If no configuration file is found in the base directory then an interactive configuration process is started. The configuration is saved to a configuration file. e.g. acme.ini by default.

    The base directory by default is the directory where the CSE is started from. This directory can be changed by the --base-directory (or -dir) command line argument to a different directory.

    ACME CSE Guided Configuration
    ACME CSE Guided Configuration

    After the configuration is saved, the CSE is started. with this configuration.

  2. After terminating the CSE again you can edit that configuration file and add more settings if necessary. There are a lot of individual settings to configure here. Mostly, the defaults should be sufficient, but individual settings can be applied to each of the sections.
    See the Configuration documentation for further details, and the defaults configuration file acme.ini.default.