- readscriptIn a console session, the command readscript generates a text dump of
all commands and parameters that are required for the configuration of
the LANCOM in its current state. In the simplest case, the LANCOM
lists only commands that are relevant to those parameters that no longer
have the factory settings.
Syntax: readscript [-n][-d][-c] [-m] [PATH]
Note: Supervisor rights are necessary to execute this command.
Example: For a LANCOM that is set up only for Internet-by-call via
ISDN, the command readscript will produce the following console output
(assuming that there are no further restrictions):
From this example it is possible to
recognize the behavior or the script that was generated with the command
readscript.
- First of all the parameters with values different from the default settings
are displayed.
- The values in the tables are deleted (del *) and
replaced with the current values in the configuration (add *).
- Only those table entries or values which cannot be left empty are
directly changed with the Set command.
Note: The table lines or strings containing passwords are displayed in plain
text as this is the format required by the Telnet user interface.
This script can be used to program other LANCOMs with exactly the
same configuration as the original device.
As these scripts can be very long in some cases, it is possible to
generate scripts that focus only on parts of the configuration. To do
this, you first change to the directory with the configuration that is
to be recorded (e.g. cd set/ip-router/firewall for the
firewall settings) and then execute the readscript command.
Alternatively, enter the path directly with the readscript
command as a path parameter (e.g. readscript set/ip-router/firewall).
In both cases, only the firewall settings that have been changed will
be recorded in the script.
The following options can be used with the readscript command:
- -d (default): The commands for modifying parameters
that are set to the factory settings will be listed as well. These long
scripts are useful for transferring configurations between different
types of devices or between devices with different firmware versions
as the factory settings can vary.
- -n (numeric): This suffix causes the paths to be
output in the numeric form of the SNMP description instead of plain text.
This also facilitates the transfer of scripts between devices with different
firmware versions as the path names may change but the SNMP tree generally
does not.
- -c (comment): In combination with -d
and -n, this parameter generates additional comments
which make the script easier to read. For the parameter -d,
every command combination that sets a default value is marked with #
default value. With -n, each numeric path is
supplemented with its plain text equivalent.
- -m (minimize): This parameter removes any gaps in
the script, so making it more compact.
- #The # character followed by a space at the start of a line are the first
characters of a comment. Subsequent characters to the end of the line
will be ignored.
Note: The space after the # is obligatory.
- del *This command deletes the table in the branch of the menu tree defined
with Path.
Syntax: del [PATH]*
- defaultThis command enables individual parameters, tables or entire menu trees
to be reset to their factory settings.
Syntax: default [-r] [PATH]
This command returns the parameters addressed by the PATH
to their factory settings. If PATH indicates a branch
of the menu tree, then the option -r (recursive) must
be entered.
Note: Supervisor rights are necessary to execute this command.
- beginscriptThe command beginscript switches a console session
into script mode. In this state, commands entered are not transferred
directly to the LANCOM's configuration RAM but initially to the device's
script memory. The commands will only be transferred to and started in
the configuration RAM via a script session by executing the command exit.
Note: Supervisor rights are necessary to execute this command.
- show script
The command show script displays the content of the most
recently executed script and an overview of the currently running scripts.
The names displayed in this output can be used to interruption scripts
early.
Note: Supervisor rights are necessary
to execute this command.
- killscriptThe command killscript deletes the content of a script session that
has not yet been executed. The script session is selected by its name.
Note: Supervisor rights are necessary to execute this command.
- flash Yes/NoWhen configuring a device with scripts, any add-, set- or del- command
can lead to an (unintentional) update of the configuration in flash;
to prevent this, the update to flash function can be deactivated. After
concluding the configuration, this function can be activated again with
flash Yes. Changes in the RAM configuration are then
written to flash. The status flash Yes/No is stored
globally.
Note: Supervisor rights are necessary to execute this command.
- sleepThe sleep command allows the processing of configuration commands to
be delayed for a certain time period or to be scheduled for a certain
time.
Syntax: sleep [-u] value[suffix]
Permissible suffixes are s, m, or
h for seconds, minutes, or hours; if no suffix is defined,
the units are milliseconds.
With the option switch -u, the sleep command accepts
times in the format MM/DD/YYYY hh:mm:ss (English) or
in the format TT.MM.JJJJ hh:mm:ss (German).
Note: Times will only be accepted if the system time has been set.
The sleep function is useful for a time-delayed reboot when testing
an altered configuration or for a scheduled firmware update for large-scale
roll-outs with multiple devices.
Note: Supervisor rights are necessary to execute this command.