Linux custom and single-user installation

Installing RADKit

Danger

Do not install or execute RADKit as the root user. This is a general security best practice for any application.

Single-user installation is recommended for evaluation purposes, or when you do not have root access, or for experts requiring a very customized RADKit setup.

First log in as a non-root user, then execute the following command, replacing <VERSION> with the RADKit version that you are installing:

$ sh ./cisco_radkit_<VERSION>_linux_x86_64.sh -- --no-systemd

and follow the prompts until completion, then read on to learn how to finalize your installation and start using RADKit.

Software directory layout

The single-user installation directory for RADKit is $HOME/.local/radkit, which is relative to the current user’s home directory. After the installation has completed, the following directory layout will be present:

$HOME/.local
└── radkit
    └── bin                       # Symlinks to the RADKit CLI for the current version
    └── versions
        └── <VERSION>             # All program files for this version of RADKit
            └── python
                └── ...
            └── uninstall         # Uninstaller for this version of RADKit

Note

Experts can customize the installation directory by passing the -- --installation-path option to the installer (note the double-double-dash). For example:

$ sh ./cisco_radkit_<VERSION>_linux_x86_64.sh -- --no-systemd --installation-path /path/to/software/install

Adjusting the PATH

Since RADKit 1.7.0, the Linux installer no longer creates symbolic links for the RADKit CLI tools in a standard location that is already in the system PATH. Instead, it now creates the symlinks in a dedicated, RADKit-specific directory and the user is responsible for adding that directory to their PATH environment variable, for example:

# Add this to the environment, profile or rc file of your favorite shell
$ export PATH; PATH="$PATH:$HOME/.local/radkit/bin"

Once this is done, the different RADKit components can be started through the CLI:

  • radkit-client

  • radkit-control

  • radkit-interactive

  • radkit-network-console

  • radkit-service

Warning

radkit-service-gui and radkit-medic-gui are currently not supported on Linux.

Starting RADKit Service

To start RADKit Service, issue the following command:

$ radkit-service run

Data directory layout

On first start, RADKit creates another directory structure to store its data, referred to as the RADKit directory. This is located in $HOME/.radkit by default. The exact contents of the RADKit directory depend on which components have been run and which actions were taken, but the general layout is:

$HOME/.radkit
└── client          # Client data files
└── control         # Control data files
└── identities      # Client & Service credentials for Cloud
└── logs            # Client & Service application logs
└── service         # Service data files
└── session_logs    # Client & Service session logs

Note

Experts can customize the RADKit data directory by passing the additional parameter --radkit-directory option to radkit-service before the action keyword. For example:

$ radkit-service --radkit-directory /path/to/radkit/data run

The Service can now be bootstrapped (please return to the main Linux installer page under Bootstrapping RADKit Service for instructions).