Related Commands
This section describes the related commands for GigaVUE-FM.
fmctl
Use the fmctl command to manage GigaVUE-FM-related configurations.
The fmctl command has the following syntax:
fmctl
image
fetch <download URI> [<filename>]
list [details] [<filename>]
install <filename> [next|location {1|2}]
boot [next|location {1|2}]
delete [force] <filename>
{move|rename} <old filename> <new filename>
show
jump-start
[options{--help|--interface <interface name>}]
set mapping <fqdn> <IP address>
{get|show} {ip|ntp|hostname|domain|fqdn}
set [ip|ip6] dhcp
set [ip|ip6] [static] <address/cidr> <gateway> <dns1>[,<dns2>[,...]
set ntp {disable|[enable] <server1>[,<server2>[,...]}
set hostname <hostname>
set domain <domain>
set fqdn <hostname> <domain>
set/get/show searchdomains [<domain1>[,<domain2>[,...]]]
set/get/show nameservers [<dns1>[,<dns2>[,...]]]
The following table describes the arguments for the fmctl command:
Argument
Description
image fetch <download URI> [<filename>]
Retrieves a saved configuration file from a remote host. Use HTTP(S), FTP, TFTP, or SCP to retrieve the file. The format for the download URL is as follows:
[protocol]://username[:password]@hostname/path/filename
For example, the following command retrieves the configuration file named myconfig from the FTP server at 192.168.1.10 using the robh account with the xray password:
fmctl image fetch ftp://robh:xray@192.168.1.10/myconfig
You can also use the <filename> argument to give the retrieved file a new name on the GigaVUE H Series node. For example, the following command retrieves myconfig and names it newconfig on the node:
fmctl image fetch scp://bbochy:catch1@192.168.1.75/myconfig newconfig
Note: You cannot retrieve a file with the same name as the currently active configuration file.
image list
Provides the list of image file names available in GigaVUE-FM.
For example:
fmctl image list
image install <filename> [next|location {1|2}]
Installs the image file.
For example, use the following command to install the image file on the next partition:
fmctl image install gigamon-gigavue-fm-5.8.00-160194-trial.img next
Use the following command to install the image file on the specified partition:
fmctl image install gigamon-gigavue-fm-5.8.00-160194-trial.img location 1
Note: Ensure that your current partition is not the same as the partition you specified for installation. Else, an error is displayed.
image boot [next|location {1|2}]
Boots the image file on the specified partition. Ensure that the partition has the installed image file.
For example, use the following command to boot the image file on the next partition:
fmctl image boot next
Use the folloaing command to boot the image file on the specified partition:
fmctl image boot location 1
Note: GigaVUE-FM reboots immediately.
image delete [force] <filename>
Deletes the named image file.
For example:
fmctl image delete myimage
image {move|rename} <old filename> <new filename>
Moves or renames the specified image file. For example, the following command renames myimage as newimage:
fmctl image rename myimage newimage
image show
Displays the last boot partition.
For example:
fmctl image show
jump-start
Runs the configuration wizard for the initial setup of GigaVUE-FM. Refer to Perform Initial Configuration.
Note: When you change the IP address of the GigaVUE-FM instance using the jump-start configuration, the internal database and the in-memory caches of the GigaVUE-FM instance are not updated. The Database continues to have the IP address of the old GigaVUE-FM, and the image upgrade using the internal server option does not work. To fix this, you must restart the GigaVUE-FM instance after upgrade.
--interface <interface name>
Allows various configurations that can be set for the management interface. This is an optional argument.
For example, use the following command to ensure that eth1 management interface uses DHCP:
fmctl --interface eth1 set ip dhcp
[options{--help|--interface <interface name>}] set mapping <fqdn> <IP address>
Maps the FQDN with the IP address of GigaVUE-FM.
For example:
fmctl --interface eth1 set mapping fm 10.10.10.1
Use the following command to remove the mapping:
fmctl --interface eth1 set mapping fm
[options{--help|--interface <interface name>}] {get|show} {ip|ntp|hostname|domain|fqdn}
Use to either fetch or display the IP address, NTP configurations, host name, domain name, or FQDN .
For example:
fmctl --interface eth1 get {ip|ntp|hostname|domain|fqdn}
fmctl --help show {ip|ntp|hostname|domain|fqdn}
[options{--help|--interface <interface name>}] set [ip|ip6] dhcp
Configures the management interface to use DHCP.
For example:
fmctl --interface eth1 set ip dhcp
[options{--help|--interface <interface name>}] set [ip|ip6] [static] <address/cidr> <gateway> <dns1>[,<dns2>[,...]
Configures the static IP address and gateway on the management interface. You can also choose to configure DNS.
For example:
fmctl --interface eth1 set ip static 10.115.46.72/21 10.115.40.1 10.10.1.20
[options{--help|--interface <interface name>}] set ntp {disable|[enable] <server1>[,<server2>[,...]}
Use to enable or disable NTP for synchronization of the system's clock.
For example, the following command disables NTP:
fmctl --interface eth1 set ntp disable
You choose to enable NTP and add NTP servers. For example, the following command enables NTP and adds a NTP server:
fmctl --interface eth1 set ntp enable 192.168.1.10
[options{--help|--interface <interface name>}] set hostname <hostname>
Configures the hostname.
For example:
fmctl --interface eth1 set hostname myfm
Note: Ensure that you log out and re-login to the GigaVUE-FM to view the changes.
[options{--help|--interface <interface name>}] set domain <domain>
Configures the domain for GigaVUE-FM.
For example:
fmctl --interface eth1 set domain gigamon.com
[options{--help|--interface <interface name>}] set fqdn <hostname> <domain>
Configures the Fully Qualified Domain Name (FQDN) for the current GigaVUE-FM.
fmctl --interface eth1 set fqdn myfm gigamon.com
[options{--help|--interface <interface name>}] set/get/show searchdomains [<domain1>[,<domain2>[,...]]]
Displays a list of domains for the current GigaVUE-FM
For example:
fmctl --interface eth1 set searchdomains
fmctl --help get | show searchdomains
[options{--help|--interface <interface name>}] set/get/show nameservers [<dns1>[,<dns2>[,...]]]
Displays a list of name servers for the current GigaVUE-FM
For example:
fmctl --interface eth1 set nameservers
fmctl --help get | show nameservers