Toolpack Application:tbconfig
(LM Added the -s option) |
(Improving doc for HTTPS) |
||
| Line 32: | Line 32: | ||
-s : [HTTPS] to connect using HTTPS | -s : [HTTPS] to connect using HTTPS | ||
| − | For example, if the TMG’s web server has been reconfigured to use port | + | For example, if the TMG’s web server has been reconfigured to use HTTPS on port 443 and you want to log with user my_username and password my_secret_password, tbconfig should be invoked using the following parameters: |
| − | tbconfig --port | + | tbconfig --port 443 -s HTTPS -u my_username -p my_secret_password |
Unix environment variables can be set to avoid adding those parameters every time. | Unix environment variables can be set to avoid adding those parameters every time. | ||
| − | TBCONFIG_HOST : Replaces -h | + | TBCONFIG_HOST : Replaces -h |
| − | TBCONFIG_PORT : Replaces --port | + | TBCONFIG_PORT : Replaces --port |
| − | TBCONFIG_USER : Replaces -u | + | TBCONFIG_USER : Replaces -u |
| − | TBCONFIG_PASS : Replaces –p | + | TBCONFIG_PASS : Replaces –p |
| + | TBCONFIG_SCHEME : Replaces -s | ||
== Use cases == | == Use cases == | ||
Revision as of 13:20, 7 November 2018
Contents |
Role
tbconfig is used to provision the system using the RESTful API. It supports three different modes of operations : interactive mode, shell mode and command line mode.
Interactive mode
This mode allows to explore and modify the configurations using arrow keys and simple commands. Multiple modifications can be made before they are applied to the unit. While inside the interactive mode, type the question mark (?) key to get a more detailed help.
- To launch the tool in interactive mode :
tbconfig
Shell mode
This mode allows to explore and modify the configurations using cd (change directory), ls (list files) and other simple commands. Multiple modifications can be made before they are applied to the unit. While inside the shell mode, type "help" key to get a more detailed help.
- To launch the tool in shell mode :
tbconfig --shell
Command line mode
This mode allows to export or import configurations to/from files. It also allows to instantly modify values.
- To use the tool in command line mode :
tbconfig [args]
- To get detailed commands examples :
tbconfig --help
Additional arguments
By default, tbconfig sends HTTP requests to the web server using 127.0.0.1:12358 with root/root as the username and password.
This can be changed using the following arguments:
-h : [host] Host to connect to (IP address or domain name) --port : [port] Port to use for connecting to HTTP server -u : [user] User name to use for connecting to HTTP server -p : [pass] Password to use for connecting to HTTP server -s : [HTTPS] to connect using HTTPS
For example, if the TMG’s web server has been reconfigured to use HTTPS on port 443 and you want to log with user my_username and password my_secret_password, tbconfig should be invoked using the following parameters:
tbconfig --port 443 -s HTTPS -u my_username -p my_secret_password
Unix environment variables can be set to avoid adding those parameters every time.
TBCONFIG_HOST : Replaces -h TBCONFIG_PORT : Replaces --port TBCONFIG_USER : Replaces -u TBCONFIG_PASS : Replaces –p TBCONFIG_SCHEME : Replaces -s
