Installer Command Line Reference

This is a reference document for the 128T Installer command line interface. To get started installing 128T with the Installer, see the Manual Installation Guide.

Running the Installer

To start the Installer, run the install128t command.

note

install128t must always be run as the root user, or with sudo install128t. The Installer will detect non-root usage and exit with this message:

You must run the Installer as root.

Use the -h/--help flag to display help information for the install128t command line:

install128t --help

The --version flag or the rpm command may be used to determine the Installer version:

$ install128t --version
128T Installer 3.0.0
$ rpm -q 128T-installer
128T-installer-3.0.0-1.x86_64

When the Installer is used to install 128T for the first time, it will automatically run the 128T Initializer to complete setup of 128T, unless the --install-only option is specified. See the Initializer documentation for the relevant version of 128T for details on its usage and options.

After a successful run, the install128t process will exit with a return code of 0. If any error was encountered during the operation, the return code will be non-zero.

Interactive Mode

Without any arguments, the Installer will open a wizard interface to install 128T.

install128t

Follow the on-screen prompts to complete the installation and initialization process. Step-by-step instructions for the Installer wizard can be found in the Installation Guide.

Automated Mode

For more advanced use cases, preferences may be specified on the command line to perform an operation in an automated fashion, using the -p/--preferences option.

In this mode, no wizard will be displayed, but informational messages will be printed to the console as the Installer is running.

$ cat /tmp/preferences.json
{
"install": {
"initialize": {
"node-name": "MyNode",
"node-ip": "127.0.0.1",
"node-role": "combo",
"router-name": "MyRouter"
}
}
}
$ install128t --preferences /tmp/preferences.json
Did you know?

You can specify a preferences file with -p, but you can also pass the preferences directly on the command line. For example:

install128t -p '{"download": {"128T-version": "5.0.0"}}'

The specified preferences must be valid JSON (trailing commas are not allowed), and they must conform to the Installer preferences file schema. See the full schema documentation for details.

Install from RPM

To install or upgrade 128T directly from RPM files, use the --rpm-path option to specify a directory in which the RPM files are located.

In order to use this option, both a 128T RPM and the corresponding version of the 128T manifest RPM must be in the specified directory, as shown here:

$ ls /tmp/local-install/
128T-5.0.0-1.el7.x86_64.rpm
128T-manifest-5.0.0.1.el7-1.x86_64.rpm
$ install128t --rpm-path /tmp/local-install/

The Installer will ask for confirmation before proceeding with the operation.

warning

If the specified RPM is not an upgrade to the currently installed 128T version, this option will erase and reinstall 128T! Pay attention to the confirmation prompt to ensure an upgrade will be performed (Confirm Upgrade) rather than a reinstallation (Confirm Install).

Options

OptionDescription
-d, --dry-runSkip all steps that modify the system, e.g. downloading software or rebooting the system. This can be useful to validate a preference file without executing the operation specified in it.
-l LOG_LEVEL, --log-level LOG_LEVELChange the log level the Installer runs with. Must be one of ERROR, INFO, WARNING, DEBUG.
--install-onlyIf specified, the Installer will not run the Initializer when it completes a successful installation. NOTE: Use this option with care; 128T will be unable to start until it has been initialized. See the Initializer documentation for details on how to use it to manually initialize 128T.

Subcommands

Besides using a preference file, install128t may also be used to perform other tasks directly from the command line, without using the interactive wizard interface.

tip

Any subcommand may be passed the -h/--help flag to show its usage information and available options:

install128t download --help

download

Download 128T software and save it to the local repository. After download, the software will be available for future installation and upgrades.

install128t download

The --128T-version option is used to specify a version to download:

install128t download --128T-version 5.0.0
tip

Version requirements of the same format as the preference file may be used for this option:

install128t download --128T-version ">= 4.5.1"

If no version is specified, the latest available version will be downloaded.

import

The import subcommand is used to save software from other locations to the local repository, after which it will be available for future installation and upgrades.

Automatically find and import ISO

With this option, the Installer will attempt to search the local filesystem for a 128T ISO file, mount it, and save the contents to the local repository.

install128t import --iso-hunt

Specify an ISO path

With this option, the Installer will attempt to mount and import packages from the ISO file specified.

install128t import --iso-path /root/128T-4.5.1-1.el7.v1.x86_64.iso

repo

The repo subcommand is used to enable or disable 128T software repositories used for downloading 128T. Advanced users can use this subcommand to enable pre-release software or update software access credentials.

tip

install128t repo has several subcommands of its own, each of which may be passed the -h/--help option to display usage and options, like other subcommands.

List Repositories

The repo list subcommand shows the configured 128T software repositories. The -a/--all option may be be used to show disabled repositories as well as enabled repositories.

install128t repo list

Enable Repositories

The repo enable subcommand is used to enable 128T software repositories. Multiple repositories may be specified to enable each of them. The name specified to this command should match the name in the Repository column of the install128t repo list command output.

install128t repo enable alpha beta

Disable Repositories

The repo disable subcommand is used to disable 128T software repositories.

Usage matches the repo enable command.

install128t repo disable alpha beta

Update Repository Authentication

The repo authenticate subcommand is used to configure credentials for authenticating with 128T software repositories. To use this subcommand, you must specify both a username and a token for authentication.

install128t repo authenticate --username my_user --token 'example$token'
caution

If your authentication token contains special characters, the shell may expand or interpret them. Enclose the token in single quotes (') to prevent shell expansion.

If the specified credentials are found to be invalid, the Installer will display an error message and exit, and the credentials will not be saved.

note

If the credentials cannot be checked (e.g. no Internet connection is available), the credentials will still be saved. They will be checked again, if possible, the next time the Installer is run.

Uninstalling 128T

warning

This command stops and uninstalls 128T. It will also remove 128T data files, including configuration, logs, and more. Use with caution!

The erase128t can be used to uninstall 128T. It is packaged with the Installer, but it is not a subcommand of the install128t command.

erase128t

Use -h/--help to see all available options.

OptionDescription
-y, --assume-yesSkip confirmation prompts and run as if the answer was "yes".
-c, --cleanup-onlyDo not uninstall 128T, but still delete associated data such as configuration.
-l, --keep-logsDo not remove 128T log files.
Last updated on