Cellframe Wiki

Search

SearchSearch

4. Node Catalogs

Apr 22, 20253 min read

Linux

In the LInux OS a catalog with the Cellframe Node is located in the /opt folder.

Upon opening /cellframe-node in the /opt you will acquire the following list of folders.

bin

/opt/cellframe-node/bin This folder contains executional files for:

  • cellframe-diagtool
  • cellframe-node
  • cellframe-node-cli
  • cellframe-node-tool

cache

/opt/cellframe-node/cache This folder contains cache files

etc

/opt/cellframe-node/etc This folder contains configuration files of the node, networks and chains. It is described more detailed in the 2. Cellframe Node Configuration:

2. Cellframe Node Configuration

Cellframe Node Configuration contains information about global node settings and is divided into three parts:

  1. General Config — /opt/cellframe-node/etc/cellframe-node.cfg
  2. Network Config — /opt/cellframe-node/etc/network/NetName.cfg
  3. Chain Config — /opt/cellframe-node/etc/network/netname/chainname.cfg

Node installation above already installed node

Note

Such installation can cause some configurations modification

Chain configurations are always updated upon any node shutdown, and are sourced from the installation package. All other configurations are set according to the script /cellframe-node/share/default.setup.

This setup includes default and ensure directives:

  • default does not modify a parameter if it has been previously set by the user.
  • ensure modifies a parameter according to the script.

The procedure is as follows:

  1. Chain configuration files are initially installed to /etc.
  2. Subsequently, /cellframe-node/share/default.setup is invoked, executing the script within.
  3. The script creates configuration files from templates if they do not exist. If they do, this step is skipped.
  4. The script then iterates over specific parameters for which the ensure directive can be applied.

This process is consistent across all operating systems, with differences accounted for within the setup script.

Link to original

Link to original

python

/opt/cellframe-node/python

This catalog is designed for storing files for Python Plugins:

  • bin contains binary files

  • lib contains python libraries

sbin

/opt/cellframe-node/sbin

Contains side binary files.

share

/opt/cellframe-node/share

This catalog stores all necessary files for installation:

  • apt public keys and data for apt-repository (will be implemented in the future)

  • ca public network certificates

  • configs configuration files templates

  • doc changelog

  • logrotate configuration files of log changing

  • profile.d script for start up file in sbin folder

var

/opt/cellframe-node/var

All runtime data:

  • lib system runtime files
  1. ca (user certificates)
  2. global_db (global database)
  3. network (directory with both main and zerochain data for each enabled network)
  4. wallet (information about users wallets)

  • log log files

  • plugins plugins data

  • run system runtime files (pid-files, sockets)

Windows

In the Windows OS a catalog with the Cellframe Node is located in the DISK:\Users\Public\Documents\cellframe-node folder.

By clicking on the \cellframe-node you will acquire the following list of folders:

cache

\cellframe-node\cache This folder contains cache files

etc

\cellframe-node\etc This folder contains configuration files of the node, networks and chains. It is described more detailed in the 2. Cellframe Node Configuration:

2. Cellframe Node Configuration

Cellframe Node Configuration contains information about global node settings and is divided into three parts:

  1. General Config — /opt/cellframe-node/etc/cellframe-node.cfg
  2. Network Config — /opt/cellframe-node/etc/network/NetName.cfg
  3. Chain Config — /opt/cellframe-node/etc/network/netname/chainname.cfg

Node installation above already installed node

Note

Such installation can cause some configurations modification

Chain configurations are always updated upon any node shutdown, and are sourced from the installation package. All other configurations are set according to the script /cellframe-node/share/default.setup.

This setup includes default and ensure directives:

  • default does not modify a parameter if it has been previously set by the user.
  • ensure modifies a parameter according to the script.

The procedure is as follows:

  1. Chain configuration files are initially installed to /etc.
  2. Subsequently, /cellframe-node/share/default.setup is invoked, executing the script within.
  3. The script creates configuration files from templates if they do not exist. If they do, this step is skipped.
  4. The script then iterates over specific parameters for which the ensure directive can be applied.

This process is consistent across all operating systems, with differences accounted for within the setup script.

Link to original

Link to original

share

\cellframe-node\share

This catalog stores all necessary files for installation:

  • ca public network certificates

  • configs configuration files templates

var

\cellframe-node\var

All runtime data:

  • lib system runtime files
  1. ca (user certificates)
  2. global_db (global database)
  3. network (directory with both main and zerochain data for each enabled network)
  4. wallet (information about users wallets)
  • log log files

Mac OS

In the Mac OS a catalog with the Cellframe Node is located in the DISK-Applications-CellframeNode-Contents folder.

Contents includes 3 folders:

Resources

This folder is similar to the “cellframe-node” folder in Windows and Linux OS.

cache

This folder contains cache files

etc`

This folder contains configuration files of the node, networks and chains. It is described more detailed in the 2. Cellframe Node Configuration:

2. Cellframe Node Configuration

Cellframe Node Configuration contains information about global node settings and is divided into three parts:

  1. General Config — /opt/cellframe-node/etc/cellframe-node.cfg
  2. Network Config — /opt/cellframe-node/etc/network/NetName.cfg
  3. Chain Config — /opt/cellframe-node/etc/network/netname/chainname.cfg

Node installation above already installed node

Note

Such installation can cause some configurations modification

Chain configurations are always updated upon any node shutdown, and are sourced from the installation package. All other configurations are set according to the script /cellframe-node/share/default.setup.

This setup includes default and ensure directives:

  • default does not modify a parameter if it has been previously set by the user.
  • ensure modifies a parameter according to the script.

The procedure is as follows:

  1. Chain configuration files are initially installed to /etc.
  2. Subsequently, /cellframe-node/share/default.setup is invoked, executing the script within.
  3. The script creates configuration files from templates if they do not exist. If they do, this step is skipped.
  4. The script then iterates over specific parameters for which the ensure directive can be applied.

This process is consistent across all operating systems, with differences accounted for within the setup script.

Link to original

Link to original

share

This catalog stores all necessary files for installation:

  • ca public network certificates

  • configs configs templates

var

All runtime data:

  • lib system runtime files
  1. ca (user certificates)
  2. global_db (global database)
  3. network (directory with both main and zerochain data for each enabled network)
  4. wallet (information about users wallets)

  • log log files

  • run cellframe node pid files

MacOS

This folder contains executional files for:

  • cellframe-diagtool
  • cellframe-node
  • cellframe-node-cli
  • cellframe-node-tool

-CodeSignature

This folder contains hashes of certificates, located in share/ca folder

Graph View

Backlinks