XYGATE User Authentication Reference Manual
XYGATE
®
User Authentication
™
Reference Manual
Appendix C: XUA Macros
XYPRO Technology Corporation 302 Proprietary and Confidential
C11: XUA_INSTALL_LICENSE
This macro is supplied to allow the XUA security administrator to check on a newly
received license file and optionally load it. If you choose to load the new license, XUA
renames the current license file (at the red arrow below) out of the way and moves the
new license in.
Syntax:
XUA_INSTALL_LICENSE <new license name>
The following Example shows the examination of a license file called IP25F001 and
the prompt for installing it.
Example:
$SYSTEM XYGATEUA 6> XUA_INSTALL_LICENSE iP25f001
Xypro license check XYPRO Technology \SIMI 20091231
XYPRO Technology P25-0026 20091231 \ALL(999)
--BEGIN XYPRO SIGNATURE
PUBLIC-KEY:
LICENSE-CREATE: 20021231-084900
CUSTOMER-NAME: XYPRO Technology
CUSTOMER-NUMBER: 0026
PRODUCT: XYGATE-UA 20091231 20000101
NODE: \ALL 0999 * 00/0 *
License good
Do you want to install this license file <YES>?
FILES DUPLICATED: 1
New license installed, old license in $SYSTEM.XYGATEUA. XUA92369
$SYSTEM XYGATEUA 7>
Notice that the old license file is renamed to XUA92369 (at the red arrow above) when
the new license is installed. The old license file (now renamed) is available for fallback
purposes should there be a problem in the new license. Simply rename the two files to
place the old license back in place.
Note: If the XUA license file is expired or bad, then none of the features of
XYGATEUA will be available. It will be just like using Safeguard to logon. In
case of an invalid license, XYGATEUA will send the following message to EMS:
“The XYGATEUA license is bad or expired, XYGATEUA is reverting to only
standard Safeguard controls.”
If the license expires in less than 30-days, then XUA will audit the warning
message that the license is going to expire in less than 30-days.
Once every 24-hours, XYGATEUA checks for the license file update if XUA is
enabled in SEEP. XUA sends a message to EMS if the license file is bad or
expired. If the XYGATEUA license file expires and a new license file is installed,
then the XYGATEUA server running in SEEP will check only after 24-hours from
the time it previously checked; until then, XYGATEUA might keep sending the
warning to the EMS unless the XUA SEEP is bounced.