38 #ifndef OPENAPI_STACKING_H_INCLUDED
39 #define OPENAPI_STACKING_H_INCLUDED
138 OPEN_RUN_CFG_NO_BACKUP
158 OPEN_STARTUP_AUTO_COLD
161 #define OPEN_UNITMGR_ROOTFS_VER_SIZE 33
162 #define OPEN_UNITMGR_ROOTFS_VER_LENGTH 32
163 #define OPEN_UNITMGR_ROOTFS_SNAPSHOT_FILE "/mnt/fastpath/upper1.tgz"
164 #define OPEN_UNITMGR_ROOTFS_SNAPSHOT_VER_FILE "/mnt/fastpath/upper1.md5"
165 #define OPEN_CDA_FILE_NAME_LENGTH 128
166 #define OPEN_UNITMGR_ROOTFS_COMPAT_FILE "/etc/bootstrap-distro-compat"
167 #define OPEN_UNITMGR_ROOTFS_SNAPSHOT_FILE_NAME_LENGTH 64
168 #define OPEN_UNITMGR_ROOTFS_SNAPSHOT_VERSION_FILE_NAME_LENGTH 64
169 #define OPEN_UNITMGR_LEGACY_ROOTFS_COMPAT_STRING "1"
170 #define OPEN_UNITMGR_ROOTFS_COMPAT_STRING_LENGTH 32
171 #define OPEN_MAX_UNITS_PER_STACK 12
172 #define OPEN_ALL_UNITS (OPEN_MAX_UNITS_PER_STACK + 1)
178 uint32_t avgTimeOffset;
179 uint32_t minTimeOffset;
180 uint32_t maxTimeOffset;
181 uint32_t curTimeOffset;
474 uint32_t *unitTypeIndex);
494 uint32_t unitTypeIndex,
552 uint32_t *lastAttemptStatus);
572 uint32_t *templateId);
631 uint32_t unitTypeIndex,
653 uint32_t unitTypeIndex,
654 uint32_t *nextUnitTypeIndex,
679 uint32_t unitTypeIndex,
718 uint32_t targetUnit);
777 uint32_t *configUnit,
778 uint32_t *standbyUnit,
797 uint32_t standbyUnit,
1044 uint32_t *cardIdConfig,
1045 uint32_t *cardIdInsert);
1408 uint32_t *unitTypeIdIndex);
1426 uint32_t unitTypeIdIndex,
1446 uint32_t unitTypeIdIndex,
1447 uint32_t *defaultTemplateId);
1465 uint32_t unitTypeIdIndex,
1466 uint32_t *unitMgmtPref);
1483 uint32_t *firstUnit);
1725 uint32_t newUnitNumber);
1914 uint32_t sampleSize);
2073 uint32_t *hashMode);
open_error_t openapiStmTemplateDescriptionGet(openapiClientHandle_t *client_handle, uint32_t templateId, open_buffdesc *templateDescr)
Gets description of specified template id.
OPEN_USMDB_UNITMGR_MGMT_FLAG_t
Management Flag.
open_error_t openapiSpmFpsStackingConfigSpeedGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t port, OPEN_STACK_SPEED_t *stackPortSpeed)
Get stacking speed configuration for a front-panel stack port.
open_error_t openapiUnitMgrDebianRootfsStatusGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_UNIT_MGR_ROOTFS_STATUS_t *status)
Get the unit's stored Debian rootfs sync status.
open_error_t openapiUnitMgrDebianRootfsOperVerSet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *version)
Given a unit, set the Debian Rootfs changes snapshot version currently in use.
open_error_t openapiUnitMgrSupportedModelGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIdIndex, open_buffdesc *unitModel)
Get the supported unit model identifier for unit index.
open_error_t openapiUnitMgrUnitNumberChange(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t newUnitNumber)
Changes a unit's number.
open_error_t openapiUnitMgrNsfSupportGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_BOOL_t *nsfSupport)
Get this unit's nonstop forwarding support.
open_error_t openapiUnitMgrUnitMaxGet(openapiClientHandle_t *client_handle, uint32_t *unit)
Gets the maximum stacking unit number (largest possible number of units in the stack).
open_error_t openapiUnitMgrStackFirmwareSyncMemberStatusGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_UNIT_MGR_SFS_SWITCH_STATUS_t *firmwareSyncStatus)
Get stack firmware synchronization status of member unit.
open_error_t openapiSlotPowerModeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_CONTROL_t *powerMode)
Given a unit and slot number, gets power mode of slot.
open_error_t openapiUnitMgrSerialNumberGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *serialNumber)
Given a unit, gets the unit's serial number.
OPEN_USMDB_UNITMGR_MGMTPREF_t
Unit's Management Preference.
open_error_t openapiUnitMgrAdminMgmtPrefSet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_USMDB_UNITMGR_MGMTPREF_t adminPref)
Set the admin management preference.
open_error_t openapiUnitMgrSupportedDescriptionGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIndex, open_buffdesc *unitDescr)
Get unit description that corresponds to the index provided.
open_error_t openapiUnitMgrStackFirmwareSyncStatusGet(openapiClientHandle_t *client_handle, OPEN_UNIT_MGR_SFS_SWITCH_STATUS_t *firmwareSyncStatus)
Get stack firmware synchronization status.
open_error_t openapiSpmFpsConfigQosModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t fpsQosMode)
Set QOS configuration for all front-panel stacking ports stack port.
open_error_t openapiUnitMgrUnitTransfer(openapiClientHandle_t *client_handle, uint32_t targetUnit)
Transfers the management function from the current unit to another.
open_error_t openapiUnitMgrStackConfigReset(openapiClientHandle_t *client_handle, uint32_t unit)
Reset stack config on a unit/stack.
open_error_t openapiUnitMgrSupportedStmDefaultTemplateIdGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIdIndex, uint32_t *defaultTemplateId)
Get default template id for selected unit type index.
OPEN_SFS_LAST_ATTEMPT_STATUS_t
Stack Firmware Synchronization Last Attempt Status.
open_error_t openapiSpmFpsConfigStackingModeSet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t port, OPEN_BOOL_t stackPortMode)
Set stacking mode configuration for a front-panel stack port.
Running configuration on backup is the same as on mgmt unit.
open_error_t openapiUnitMgrStackFirmwareSyncAllowDowngradeModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t mode)
Set stack firmware synchronization downgrade mode.
Copy of running configuration is in progress.
open_error_t openapiUnitMgrStartupReasonGet(openapiClientHandle_t *client_handle, OPEN_LAST_STARTUP_REASON_t *reason)
Get the reason for the last restart.
open_error_t openapiUnitMgrEraseFactoryDefaults(openapiClientHandle_t *client_handle)
Erase the factory-defaults file on other connected units.
open_error_t openapiUnitMgrStackMemberGetFirst(openapiClientHandle_t *client_handle, uint32_t *firstUnit)
Get the first member of the current stack.
open_error_t openapiUnitMgrUserDescriptionSet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *descr)
Set unit user description.
open_error_t
OPEN uses these enumerators to indicate the error codes.
open_error_t openapiSlotSupportedPowerdownGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_BOOL_t *isPowerdown)
Given a unit and slot number, verify whether it powerdown indicator.
open_error_t openapiUnitMgrStackFirmwareSyncMemberLastAttemptStatusGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t *lastAttemptStatus)
Get stack firmware synchronization last attempt status.
open_error_t openapiUnitMgrSupportedUnitIdNextGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIndex, uint32_t *nextUnitTypeIndex, uint32_t *unitType)
Get unit type identifier that corresponds to the next index.
open_error_t openapiStackTrunkHashModeSet(openapiClientHandle_t *client_handle, uint32_t hashMode)
Set hash mode configuration for all HG trunks.
open_error_t openapiUnitMgrDetectCodeVerRunningGet(openapiClientHandle_t *client_handle, uint32_t unit, open_revision_data_t *codeVersion)
Given a unit, gets the unit's running version of code.
open_error_t openapiCardTypeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t *cardIdConfig, uint32_t *cardIdInsert)
Given a unit and slot number, gets configured card type and inserted card type.
No backup unit has been elected.
open_error_t openapiUnitMgrRunCfgStatusString(openapiClientHandle_t *client_handle, OPEN_RUN_CFG_STATUS_t runCfgStatus, open_buffdesc *statusStr)
Convert a run config status to a string.
openUnitStatusSampleMode_t
OPEN_LAST_STARTUP_REASON_t
open_error_t openapiUnitMgrUnitStatusInfoGet(openapiClientHandle_t *client_handle, uint32_t unit, openUnitStatusUnitInfo_t *unit_info)
Get the status information of specified unit.
open_error_t openapiSpmIsPortStackCapable(openapiClientHandle_t *client_handle, uint32_t intIfNum, OPEN_BOOL_t *capable)
To determine if a given port is stack capable.
open_error_t openapiStackIsTrunkHashModeConfigurable(openapiClientHandle_t *client_handle, uint32_t hashMode, OPEN_BOOL_t *valid)
To check if the hash mode is configurable.
open_error_t openapiUnitMgrDebianRootfsVerSet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *version)
Given a unit, set the Debian Rootfs changes snapshot version stored.
open_error_t openapiSlotAdminModeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_CONTROL_t *adminMode)
Given a unit and slot number, gets admin mode of slot.
open_error_t openapiSpmFpsStackingConfigSpeedSet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t port, OPEN_STACK_SPEED_t stackPortSpeed)
Set stacking speed configuration for a front-panel stack port.
open_error_t openapiSlotSupportedPluggableGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_BOOL_t *isPluggable)
Given a unit and slot number, verify whether it has pluggable indicator.
open_error_t openapiUnitMgrDebianRootfsFileNameGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *filename)
Get the Debian Rootfs changes snapshot file name.
open_error_t openapiSlotIsFullGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_BOOL_t *isFull)
Given a unit and slot number, verify whether the slot exists in the unit.
Samplemode cumulative summing.
open_error_t openapiUnitMgrNsfAdminGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *nsf)
Get the administrative status of nonstop forwarding.
open_error_t openapiCardSupportedCardDescriptionGet(openapiClientHandle_t *client_handle, uint32_t cardId, open_buffdesc *bufd)
Given card index, gets card description.
open_error_t openapiSlotGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_BOOL_t *isValid)
Given a unit and slot number, verify whether the slot exists in the unit.
open_error_t openapiSlotAdminModeSet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_CONTROL_t adminMode)
Given a unit, slot number and admin mode, configures it on device.
open_error_t openapiUnitMgrStandbySet(openapiClientHandle_t *client_handle, uint32_t standbyUnit, OPEN_BOOL_t standbyAdminMode)
Sets the unit as standby in the stack.
open_error_t openapiUnitMgrUnitTypeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t *unitType, uint32_t *unitTypeIndex)
Given a unit, gets the unit's type and index.
open_error_t openapiUnitMgrStackFirmwareSyncModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t mode)
Set stack firmware synchronication mode.
open_error_t openapiFailoverInitiate(openapiClientHandle_t *client_handle)
Initiate a warm failover to the backup unit.
open_error_t openapiUnitMgrMgmtUnitStatusGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_USMDB_UNITMGR_MGMT_FLAG_t *mgmtStatus)
Given a unit, gets the unit's management status.
open_error_t openapiUnitMgrUnitStatusGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_USMDB_UNITMGR_STATUS_t *status)
Given a unit, gets the unit's status.
open_error_t openapiSpmFpsConfigQosModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *fpsQosMode)
Get QOS configuration for all front-panel stacking ports stack port.
open_error_t openapiUnitMgrPreconfigModelIdGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *modelId)
Given a unit, gets the unit's model identifier string assigned by HPC(Hardware Platform Control) ...
open_error_t openapiCdaTransferFile(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *srcFileName, open_buffdesc *dstFileName)
Given a unit and filename, transfer file from current unit to the specified unit. ...
open_error_t openapiUnitMgrServiceTagGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *serviceTag)
Given a unit, gets the service tag.
open_error_t openapiUnitMgrUnitStatusClear(openapiClientHandle_t *client_handle, uint32_t unit)
Clear the sampling information of unit status.
open_error_t openapiUnitMgrDebianRootfsVerGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *version)
Given a unit, get the Debian Rootfs changes snapshot version stored.
open_error_t openapiUnitMgrStandbyGet(openapiClientHandle_t *client_handle, uint32_t *configUnit, uint32_t *standbyUnit, OPEN_BOOL_t *standbyAdminMode)
Gets the configured and standby unit number and admin mode in the stack.
open_error_t openapiUnitMgrEraseStartupConfig(openapiClientHandle_t *client_handle)
Erase the startup-config file on other connected units.
OPEN_CONTROL_t
OPEN uses these enumerators to indicate enable or disable for a given config or status parameter...
open_error_t openapiUnitMgrModelIdentifierGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *modelId, open_buffdesc *preconfigModelId)
Given a unit, gets the unit's model identifier string assigned by HPC and pre-configured model identi...
Min Bootcode Version Not Present.
open_error_t openapiSlotPowerModeSet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, OPEN_CONTROL_t powerMode)
Given a unit, slot number and power mode, configures it on device.
open_error_t openapiCardSupportedCardModelIdGet(openapiClientHandle_t *client_handle, uint32_t cardId, open_buffdesc *bufd)
Given card index, gets model Identifier.
open_error_t openapiUnitMgrUnitIsValid(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_BOOL_t *isValid)
Given a unit, verify that it's within the valid range.
OPEN_BOOL_t
OPEN uses these enumerators to indicate true or false for a given config or status parameter...
open_error_t openapiUnitMgrStackFirmwareSyncTrapModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t mode)
Set stack firmware synchronication trap mode.
open_error_t openapiUnitMgrNsfAdminSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t nsf)
Administratively enable or disable nonstop forwarding.
open_error_t openapiUnitMgrSupportedLocalUnitIndexGet(openapiClientHandle_t *client_handle, uint32_t *unitTypeIdIndex)
Get the unit index of the local unit.
open_error_t openapiStackTrunkHashModeGet(openapiClientHandle_t *client_handle, uint32_t *hashMode)
Get the hash mode configuration for all HG trunks.
open_error_t openapiUnitMgrDebianRootfsVersionFileNameGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *filename)
Get the Debian Rootfs changes snapshot version file name.
open_error_t openapiSpmStackPortCountersClear(openapiClientHandle_t *client_handle)
Clear stack counters for all stack ports.
open_error_t openapiStmUnitActiveTemplateIdGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t *templateId)
Gets active template id of the stack unit.
open_error_t openapiUnitMgrStartupReasonStrGet(openapiClientHandle_t *client_handle, OPEN_LAST_STARTUP_REASON_t reason, open_buffdesc *reasonStr)
Convert a startup reason to a string.
open_error_t openapiUnitMgrUserDescriptionGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *descr)
Get unit user description.
open_error_t openapiUnitMgrUnitDelete(openapiClientHandle_t *client_handle, uint32_t unit)
Remove a unit only if it is not an active member of the stack.
open_error_t openapiUnitDbEntrySlotsGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t *count, open_buffdesc *bufd)
Given a unit number, it retrieves all slot information from the unit descriptor database.
open_error_t openapiUnitMgrUnitIdKeyGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *key)
Get the unit system identifier key.
OPEN_UNIT_MGR_ROOTFS_STATUS_t
open_error_t openapixUnitMgrRunCfgStatusGet(openapiClientHandle_t *client_handle, OPEN_RUN_CFG_STATUS_t *status)
Get the status of copying the running config to the backup unit.
open_error_t openapiUnitMgrEraseDhcpClientConfigFile(openapiClientHandle_t *client_handle, OPEN_BOOL_t all, open_buffdesc *fileName)
Erase the DHCP client configuration file on the stand-by unit.
open_error_t openapiUnitMgrStackFirmwareSyncModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *mode)
Get stack firmware synchronication mode.
open_error_t openapiUnitMgrSampleModeSet(openapiClientHandle_t *client_handle, openUnitStatusSampleMode_t sampleMode, uint32_t sampleSize)
Set the mode of sample collection, size of sample.
The system switched from the active manager to the backup manager and was unable to maintain nonstop ...
Running configuration has not yet been copied to the backup unit.
open_error_t openapiUnitMgrDebianRootfsOperVerGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *version)
Given a unit, get the Debian Rootfs changes snapshot version currently in use.
open_error_t openapiUnitMgrNextConfigCopyTime(openapiClientHandle_t *client_handle, uint32_t *wait)
Get how long before the running config will next be copied to the backup unit, if a copy is scheduled...
open_error_t openapiUnitMgrUnitUpTimeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t *upTime)
Given a unit, gets the unit's up time in seconds.
open_error_t openapiUnitMgrDetectCodeVerFlashGet(openapiClientHandle_t *client_handle, uint32_t unit, open_revision_data_t *codeVersion)
Given a unit, gets the unit's version of code in flash.
open_error_t openapiSpmFpsConfigStackingModeGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t port, OPEN_BOOL_t *stackPortMode)
Get stacking mode configuration for a front-panel stack port.
open_error_t openapiUnitMgrUnitCreate(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t unitTypeIndex, OPEN_BOOL_t synchMode)
Create a new unit record for unit.
open_error_t openapiUnitMgrMgmtPrefGet(openapiClientHandle_t *client_handle, uint32_t unit, OPEN_USMDB_UNITMGR_MGMTPREF_t *hwPref, OPEN_USMDB_UNITMGR_MGMTPREF_t *adminPref)
Given a unit, gets the unit's hardware and admin management preference.
The administrator issued the "initiate failover" command for the stand-by manager to take over...
open_error_t openapiUnitMgrSupportedUnitIdGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIndex, uint32_t *unitType)
Get unit type identifier that corresponds to the index provided.
open_error_t openapiUnitMgrStackFirmwareSyncAllowDowngradeModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *mode)
Get stack firmware synchronization downgrade mode.
open_error_t openapiUnitMgrStackFirmwareSyncTrapModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *mode)
Get stack firmware synchronication trap mode.
The primary management unit restarted because of a failure, and the system executed a nonstop forward...
open_error_t openapiUnitMgrResetUnit(openapiClientHandle_t *client_handle, uint32_t unit)
Given a unit, reboot the corresponding switch.
OPEN_USMDB_UNITMGR_STATUS_t
Stacking Unit Status.
open_error_t openapiUnitMgrConfigAgeOnBackup(openapiClientHandle_t *client_handle, uint32_t *age)
Get the age of the configuration on the backup unit.
OPEN_UNIT_MGR_SFS_SWITCH_STATUS_t
Stack Firmware Synchronization Status.
open_error_t openapiSpmFpsStackingRunningSpeedGet(openapiClientHandle_t *client_handle, uint32_t unit, uint32_t slot, uint32_t port, OPEN_STACK_SPEED_t *stackPortSpeed)
Get stacking running speed configuration for a front-panel stack port.
open_error_t openapiUnitMgrStackMemberGetNext(openapiClientHandle_t *client_handle, uint32_t startUnit, uint32_t *nextUnit)
Given a unit, gets the next member of the current stack.
open_error_t openapiUnitMgrNumberGet(openapiClientHandle_t *client_handle, uint32_t *unit)
Get the manager's unit number.
open_error_t openapiUnitMgrSupportedMgmtPrefGet(openapiClientHandle_t *client_handle, uint32_t unitTypeIdIndex, uint32_t *unitMgmtPref)
Get the management preference of the unit index.