This command creates a text description for a configuration context to help identify the content in the configuration file.

The no form of this command removes the description string from the context.

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they can be deleted.

The no form of this command administratively enables an entity.

This command configures an identifier for a cellular port on the node. Up to two cellular ports can be configured and each cellular port is associated with a SIM. Cellular port 1/1/1 is associated with SIM 1 and cellular port 1/1/2 is associated with SIM 2. The relationship between the ports and the SIMs cannot be changed.

This command assigns a SIM to be the active SIM.

When the system powers up or reboots, it uses the active-sim setting to determine which SIM is the active SIM. Selecting 1 or 2 makes the selected SIM permanently active. The active SIM can be manually switched by changing the active-sim setting from 1 to 2 or from 2 to 1.

Caution: Changing the active SIM from 1 to 2 or vice versa is considered a manual switchover and is service-affecting. The recovery time after making the change can range from a few seconds to up to a few minutes. Ensure that there is service on the other SIM before changing the active SIM.

If a SIM is specified but is not physically installed in the associated SIM slot, the cellular port remains operationally down. The operator must either install the SIM in the appropriate slot or change the configuration in order to bring up the service.

Selecting auto enables automatic failover in a dual SIM deployment. An automatic failover occurs when activity switches from one SIM to the other. The settings configured for the failover-criteria command determine when an automatic failover will occur.

When the auto parameter is set in a dual SIM deployment, the node must be configured with a preferred SIM. The preferred-sim command specifies whether SIM 1 or SIM 2 is used for a cellular port after a system reset.

If the active-sim value is changed from auto to 1 or from auto to 2 and the active SIM is the same as the new configuration, there is no change to service of the active SIM.

Caution: Changing the active-sim setting so that the newly active SIM is different from the currently active SIM is service-affecting. The recovery time after making this change could range from a few seconds to up to a few minutes.

If the active-sim value is changed from 1 to auto or from 2 to auto, there is no service outage. The system keeps the currently active SIM up and does not perform any switchover.

When active-sim is set to auto, operators can use the tools>perform>mda> cellular>force-sim-switch command to manually force a SIM switch.

The auto parameter can be set even if there is only one SIM installed in the system. In this case, the system keeps the currently active SIM up and does not perform any switchover.

This command configures the maximum transmit power level of the B125 radio module. The B125 power level depends on the installation height of the B125 variant antenna, and the value must be set based on the guidelines provided in the SAR-Hm and SAR-Hmc Chassis Installation Guide for B125 antenna locations.

For more information, refer to the SAR-Hm and SAR-Hmc Chassis Installation Guide.

This command configures the length of time in which the cellular MDA must establish cellular service for a SIM before the node resets. It is used in conjunction with the down-recovery-criteria command.

When configured, this option provides a hardware reset to unblock any potential hardware lockup conditions related to the cellular radio modem or to guard against persistent cycling of automatic switchovers between SIMs in a dual SIM deployment. If the cellular MDA has not successfully achieved service based on the down-recovery-criteria value set for either SIM 1 or SIM 2 within the specified length of time, the node resets.

Prior to resetting, the node will issue a log event stating that the node will reset within 60 seconds. This interval can be used to collect information for further debugging and analysis.

The no form of the command disables the down-recovery-interval, and the state of the cellular MDA is not monitored other than for dual SIM operation and criteria configured for automatic failover (see failover-criteria for more information).

This command configures criteria used to detect a problem with the cellular radio modem. It is used in conjunction with the down-recovery-interval command. The criteria are port and bgp.

When the command is set to port, the node detects if any cellular port has connected to a wireless network and is operationally up within the configured down-recovery-interval. When a port connects successfully, the down-recovery timer stops. The down-recovery timer restarts when all PDN interfaces are operationally down.

When the command is set to bgp, the node detects if any BGP session whose local-address is configured to a PDN interface name has come up within the configured down-recovery-interval. When a BGP session comes up, the down-recovery timer stops. The down-recovery timer restarts when all BGP sessions associated with PDN interfaces (associated with the configured local-address) are down.

Both port and bgp can be set concurrently as criteria.

This command configures which SIM to use when the node resets. The configuration is used in a dual SIM deployment when the active-sim command is set to auto. When the node resets, the system uses the preferred SIM to bring up the associated cellular port.

Note: Before setting the preferred SIM, the operator must ensure that the corresponding SIM is installed and configured.

This command enables the context to configure parameters for the specified SIM.

This command stores the SIM PIN in the system configuration file. This command does not change the PIN on the SIM.

Use the pin command to enter the PIN in the system configuration file from an interactive CLI session. The system prompts you to enter the PIN twice. If the two entered PINs do not match, the system rejects the configuration.

Use the pin command with a specified PIN value and the hash or hash2 keyword to load the PIN in encrypted form in the configuration file.

The no form of this command removes the PIN from the system configuration.

This command enables the context to configure the criteria that will cause an automatic SIM switchover in a dual SIM deployment.

The failover-criteria parameters are used when the active-sim command is set to auto. The parameters are configured per SIM, so each SIM can have different failover criteria. The system uses the criteria configured on the currently active SIM to determine when a switchover should occur.

This command sets the operational status of the cellular port as a failover criterion for the specified SIM.

If the operational status of the cellular port remains down for the failure-duration interval, the SIM is considered to be in a failed state and the system performs an automatic switch from the currently active SIM to the other SIM.

The no form of the command disables the port-oper-state from being used as a failover criterion.

This command sets the operational status of BGP sessions as a failover criterion for the specified SIM.

The BGP sessions monitored by the system are those that are configured with the local-address set to the PDN interface name that uses the associated SIM cellular port-id.

If the operational status of BGP sessions remain down for the failure-duration interval, the SIM is considered to be in a failed state and the system performs an automatic switch from the currently active SIM to the other SIM.

The no form of the command disables the bgp-neighbor-state from being used as a failover criterion.

This command configures the length of time before the SIM is considered to be in a failed state based on the specified failover criteria. The value is used for both configured failover criteria.

When the node detects a down state for the failure-duration time, the SIM is considered to be in a failed state and the node performs an automatic switch from the currently active SIM to the other SIM.

Note: It is recommended that the failure-duration be set to a high value so that the system does not perform frequent switches between SIMs.

This command enables the context to configure PDN parameters for the cellular port.

This command assigns a PDN profile to the cellular port. The PDN profile must be configured at the system level before this command can be used; see Cellular PDN Profile Configuration Commands for information.

The no form of this command assigns the default PDN profile to the PDN.

This command creates a PDN profile with an associated ID when used with the create keyword.

The system supports up to three PDN profiles: a default profile and two user-created profiles identified as pdn-profile 1 and pdn-profile 2.

The default PDN profile is used during the ADP-Hm process and cannot be modified.

The no form of this command deletes the PDN profile if the profile is not in use. If the profile is in use, the no form of the command cannot be executed.

This command configures the Access Point Name (APN) for the PDN profile.

The no form of this command removes the APN.

This command configures the authentication type used by the PDN profile.

The no form of this command removes authentication from the PDN profile.

This command configures the password for PAP or CHAP authentication of the PDN profile. The password must be confirmed by entering it twice.

The no version of this command removes the authentication password from the PDN profile.

This command configures the address type, either IPv4 or IPv6, that is learned by the PDN router interface during the PDN attachment process. When set to IPv4, the PDN router interface can operate in static cellular system mode, static cellular interface mode, or dynamic cellular interface mode. When set to IPv6, the PDN router interface can operate in either static cellular interface mode or dynamic cellular interface mode. For more information on the PDN router interface modes, refer to “PDN Router Interfaces” in the 7705 SAR-Hm and SAR-Hmc Main Configuration Guide.

This command configures the user name for PAP or CHAP authentication of the PDN profile.

The no form of this command removes the user name.

This command configures the duplex mode of a Fast Ethernet port when autonegotiation is disabled. If the port is configured to autonegotiate, this parameter is ignored.

The 7705 SAR-Hm only supports full-duplex mode.

This command configures which GNSS system or systems will be used by the GNSS receiver. The configuration can be modified only when the GNSS service is shut down.

This command enables the context for configuring NMEA parameters.

This command configures NMEA sentence types that are sent from the GNSS receiver over the associated IP transport service when the service is configured for NMEA streaming. The following sentence types are supported: GPGGA, GPRMC, GPVTG, and GNGNS. For information about the sentence types, refer to NMEA 0183, Standard For Interfacing Marine Electronic Devices.

At least one sentence type must be specified, up to a maximum of four. Different sentence types can be specified concurrently so that multiple sentences can be streamed per NMEA sentence interval.

This command configures the intervals at which NMEA sentences are retrieved from the GNSS receiver and sent over the associated IP transport service configured for NMEA streaming.

This command enables or disables NMEA streaming from the GNSS receiver. The no form of the command enables NMEA streaming. Using the shutdown command disables NMEA streaming.

The node uses an IP transport service to send NMEA sentences from the GNSS receiver to remote hosts. For information about enabling IP transport for NMEA sentences, refer to the 7705 SAR-Hm and SAR-Hmc Main Configuration Guide, “GNSS NMEA Data IP Transport Service”.

This command enables or disables the GNSS service on the GNSS receiver. Enabling the GNSS receiver causes MDA 1/1 to reset under the following conditions:

The no form of the command enables the GNSS service. Using the shutdown command disables the GNSS receiver and resets the position fix and associated information.

This command enables the context to configure parameters for an RS-232 serial port on the node.

This command enables the context to configure RS-232 parameters for a serial port.

This command configures the number of data bits used to transmit a character. The value for this command cannot be 8 if the value for parity is anything other than no parity (that is, anything other than none) and the value for stop-bits is 2.

This command enables access to the context to configure the input and output leads that carry control signals. Control signals provide the handshaking for call setup, teardown, and synchronization.

This command enables access to the context to configure the input control leads.

This command configures the Data Terminal Ready (DTR) or Data Set Ready (DSR) input control lead. For a DCE device, the input signal is DTR. For a DTE device, the input signal is DSR.

This command configures the Request To Send (RTS) or Data Carrier Detect (DCD) input control lead. For a DCE device, the input signal is RTS. For a DTE device, the input signal is DCD.

This command enables access to the context to monitor the input control leads. When monitoring is enabled on a control lead, the node polls the status of the control lead every second. Any change in state of the control lead causes an alarm to be raised. This functionality provides an indication to the operator of a problem in the DTE-to-DCE path; for example, it can indicate that the far-end device is disconnected.

Monitoring is enabled on a per-lead basis.

This command enables monitoring on the Data Terminal Ready (DTR) or Data Set Ready (DSR) input control lead. For a DCE device, the input control lead is DTR. For a DTE device, the input control lead is DSR.

This command enables monitoring on the Request To Send (RTS) or Data Carrier Detect (DCD) input control lead. For a DCE device, the input control lead is RTS. For a DTE device, the input control lead is DCD.

This command enables access to the context to configure the output control leads.

This command configures the Clear To Send (CTS) or Analog Loopback (ALB) output control lead. For a DCE device, the output signal is CTS. For a DTE device, the output signal is ALB.

This command configures the Data Carrier Detect (DCD) or Request To Send (RTS) output control lead. For a DCE device, the output signal is DCD. For a DTE device, the output signal is RTS.

This command configures the Ring Indicator (RI) or Remote Digital Loopback (RDL) output control lead. For a DCE device, the output signal is RI. For a DTE device, the output signal is RDL.

This command configures the serial link dampening timers in 100s of milliseconds, which guards against reporting excessive interface transitions. Once implemented, subsequent transitions of the interface from one state to another are not advertised to upper layer protocols until the configured timer has expired.

This command puts the specified interface into a loopback mode. The corresponding interface must be in a shutdown state in order for the loopback mode to be enabled.

In the serial context, it is possible to configure a a bidirectional loopback E. A bidirectional loopback is a circuit loopback that loops traffic from the line back to the line. Bidirectional loopback E takes place on the data device side of the adapter card, and is closer to the line.

This command is not saved in the system configuration between boots.

The no form of this command disables the loopback on the interface.

This command configures the parity bit in a character. Parity is an error detection method that adds an extra bit to each character, based on the number of 0s or 1s in the character.

The value for this command must be no parity (that is, none) if the character-length value is 8 and the stop-bits value is 2.

The no form of this command disables the parity bit in a character.

This command configures the speed of the interface. The speed also determines the DS0 timeslots assigned to the channel group.

This command configures the number of stop bits used to signify the end of a character.

This command cannot have a value of 2 if the character-length value is 8 and the parity value is anything other than no parity (that is, anything other than none).

This command enables the context to configure WLAN radio commands.

This command configures the country code for the WLAN radio. Because the values configured for the channel and bandwidth commands depend on the country-code configuration, the country code must be configured before any other MDA parameters. The country-code must be configured in order to enable the radio; otherwise, executing a no shutdown command returns an error.

The no form of the command removes the specified country code from the WLAN radio, and resets the MDA AP frequency-band, channel, and bandwidth commands to their default values. The no form can only be executed when the WLAN radio is shutdown.

This command enables the context to configure WLAN radio AP parameters.

This command sets the frequency band for the access point configured under the WLAN radio MDA.

This command sets the channel of the WLAN radio. The channel-id values that are available for this command depend on the configured country-code and frequency-band. See the Appendix for information about the available values.

When the WLAN radio channel is set to auto, the node scans the frequency bands supported by the configured county-code for the most appropriate channel.

This command sets the channel bandwidth of the WLAN radio.

This command sets the beacon interval for WLAN radio access points. The interval is the frequency with which an AP broadcasts a packet in order to synchronize with the wireless network. This command is configured at the MDA level and is used by all APs for their associated beacon.

.

In the config>card>mda>wlan-radio context, this command shuts down the WLAN radio. When the radio is turned off, a configured AP becomes operationally down. The no form of this command enables the WLAN radio, and any configured WLAN ports that are operationally down can begin operating.

In the config>card>mda context, this command shuts down the WLAN MDA and puts the WLAN radio into reset mode. Any WLAN ports configured under the MDA become operationally down. The no form of this command brings the WLAN radio out of reset

This command configures a WLAN port. The WLAN port identifier for the WLAN MDA is fixed and represents an access point (AP).

This command administratively disables the specified WLAN port. When disabled, the port does not change, reset, or remove any configuration settings or statistics. The operational state of the port is also disabled.

When the WLAN port on the node is shut down, the following occurs:

The no form of this command administratively enables the specified port.

This command creates a text description for a configuration context to help identify the content in the configuration file.

The no form of this command removes any description string from the context.

This command enables the context to configure WLAN port parameters.

This command configures the network service set identifier (SSID). Only one network SSID can be configured on a port. The network SSID can be changed only when the WLAN AP port is shutdown.

The no form of this command removes the network and all the configurations within the network context.

This command configures the network security type for the specified WLAN interface.

When no security type is set, the WLAN interface is considered to be open. When the security type is set to wpa2-psk, the WPA2 PSK pass phrase must be configured. When the security type is set to wpa2-enterprise, the radius-plcy command under the access-point context must be configured in order to authenticate clients connecting to the WLAN access point.

The no form of the command disables security and the WLAN interface is considered to be open.

This command sets the WPA2 encryption type when network WLAN security is configured as either wpa2-psk or wpa2-enterprise.

When WLAN security is set to either wpa2-psk or wpa2-enterprise, the encryption type defaults to aes.

The no form of the command removes the configured encryption type.

This command configures the WPA2-PSK pass phrase when network WLAN security is configured as wpa2-psk. The pass phrase is a pre-shared secret pass phrase that is used to connect potential clients to the AP.

The no form of the command clears the pass phrase. The default setting is the string passphrase.

This command enables the context to configure WLAN port AP parameters.

This command enables the context to configure Dot1X parameters for the specified WLAN port AP.

This command configures a RADIUS policy for the specified WLAN access point to use when network WLAN security is set to wpa2-enterprise.

The RADIUS policy name must have already been configured under the config>system>security>dot1x context before executing this command. For information about configuring a RADIUS policy name in the config>system>security>dot1x context, refer to the “Dot1X Commands” section of the 7450 ESS, 7750 SR, 7950 XRS, and VSR System Management Guide

The no form of the command clears the radius policy name from the WLAN AP.

This command configures the re-authentication period when network LAN security for a WLAN AP is set to wpa2-enterprise. Clients that are connected to the WLAN AP must re-authenticate after the re-authentication period expires.

This command enables WLAN access points to broadcast the network SSID.

The no form of the command disables the broadcast of the network SSID.

This command configures the maximum number of clients that can connect to the WLAN AP concurrently.

This command configures the timeout period for inactive clients. If a client does not send or receive data over the WLAN connection within the specified period, then the client is disconnected from the WLAN AP.

This command disables the DHCP relay function for the specified AP.

The no form of the command enables the DHCP relay function on the AP. When a DHCP request is received by a client trying to connect to the AP, the node inserts option-82 with specific information needed to connect to the WLAN gateway. If an option-82 sub-option is already present in the DHCP request, then it is replaced with the version expected by the WLAN gateway.