Configuration File Administration

configuration file administration overview the system supports multiple administrator utilities related to configuration file management the following table describes the purpose of the different utilities the following table lists the utilities for configuration file administration utility recommended usage archiving schedule periodic backups to a remote backup server you should schedule archiving for both the system configuration binary file (system cfg) and the user configuration binary file (user cfg) if necessary, you can import an archived configuration using the configuration binary file import/export feature local backup and restore create backups on the local system as a precaution when making significant configuration changes with this utility, you can quickly restore to a previous configuration binary configuration file import/export export binary configuration files to a local host (an alternative to the remote archiving server and archiving process that runs as a scheduled job) you might do this if you do not use or do not have access to an archiving server, or if you want to make use of a configuration that has not yet been archived you can export the binary system configuration file (system cfg) and the binary user configuration file (user cfg) you can use the binary file import/export feature to clone a configuration that you want to deploy more broadly, such as deploying a backup device or to a group of devices you can use "selective import" options to exclude unique network identifiers (such as ip address) that would cause problems if the configuration were to be wholly imported and activated xml configuration file import/export import or export the configuration for only the features and settings you select this enables you to take a more granular approach to mass configuration management than the binary file import/export feature for example, you might want to populate an authentication server configuration across a large number of nodes you can export just that configuration element, and when you import it in the other nodes, you do not overwrite the large number of configuration elements that you would if you had imported the user cfg file you might also find the xml file import/export feature useful when managing a single node for example, you might want to add many new users to the local authentication server, which can be faster editing the xml than using the user interface or you might want to make global changes to the configuration object naming conventions or descriptions as part of a "housekeeping" initiative this, too, might be accomplished faster editing the xml than clicking through the user interface push configuration push a partial configuration from the running configuration on the source system to the running configuration on one or more target systems this is the best option to instill common configuration elements if the devices are already deployed and currently online configuring archiving for system logs, configuration files, and snapshots you can schedule periodic archiving for system logs, system configuration files, and system snapshots periodic archiving occurs only at the scheduled time "unscheduled" archiving does not occur automatically for example, if a log file exceeds the maximum file size, the archiving process does not automatically back up the file prior to the scheduled time to prevent data loss if the archive process fails, it makes two more attempts at an interval of 30 seconds if the archiving still fails, it retries at an interval of one hour till the archiving process is successful we recommend that you schedule an archive operation during hours when traffic is light to minimize its impact on users the automatic archiving process compresses files and, if the system is busy, can degrade performance for users also, a cluster node might appear unresponsive if the system is busy with traffic and performing archiving simultaneously if you schedule an archive operation to occur during the hour that your system switches to daylight savings time (dst), the operation might not occur as scheduled for example, if your system is set to change to dst at 1 00 am, and you scheduled an archive job to occur at any time between 1 01 am and 1 59 am, then the operation does not take place because at 1 00 am the system clock is moved forward to 2 00 am, and the system never reaches the archive time for that date to configure log archiving select maintenance > archiving > archiving servers to display the configuration page archiving configuration page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t shows the configuration page for ivanti connect secure complete the configuration as described in archiving configuration page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t save the configuration archiving configuration page ivanti connect secure the following table lists the archiving configuration guidelines settings guidelines archive settings archive server specify the fully qualified domain name or ip address of the server to which to send the archive files destination directory specify the destination directory follow these recommendations for unix systems, you can specify an absolute or relative path we recommend you specify a full path for windows systems, specify a path that is relative to the ftproot directory we recommend you specify a full path do not include a drive specification for the destination directory, such as ivanti/log username specify a username that has privileges to log into the server and write to the destination directory password specify the corresponding password method select scp, ftp, aws s3, azure storage or gcp storage scp is the default method scp is a file transfer utility similar to ftp scp encrypts all data during transfer when the data reaches its destination, it is rendered in its original format scp is included in most ssh distributions and is available on all major operating system platforms aws s3 push backup configurations and archived logs to amazon aws s3 bucket for more details, refer to ivanti connect secure virtual appliance on amazon aws cloud deployment guide azure storage push backup configurations and archived logs to microsoft azure storage for more details, refer to ivanti connect secure virtual appliance on microsoft azure cloud deployment guide gcp storage push backup configurations and archived logs to gcp stroage for more details, refer to ivanti connect secure virtual appliance on microsoft azure cloud deployment guide archive schedule archive events log schedule archiving for the events log the archive file has the following format pulsesecureeventslog \[clustername|standalone] \[nodename|hostname] \[date] \[time] for example, an archive file for a cluster named gen has a filename similar to the following pulsesecureeventslog gen node1 root 20090109 1545 gz the archiving schedule configuration includes the following options use this filter select a log format filter day of week select the days of the week on which to run the archiving job every hour or a specified time the every hour option runs a job every hour on the hour for the selected days the specified time option runs a job once on the selected days clear log after archiving select this option to clear the local log file after the archiving job is successfully completed if an archive job fails, the log files are not deleted password (optional) specify a password to secure and encrypt system configuration or user account archives archive user access log schedule archiving for the user access log the archive file has the following format pulsesecureaccesslog \[clustername|standalone] \[nodename|hostname] \[date] \[time] the archiving schedule configuration includes the same options as those described for the events log archive admin access log schedule archiving for the admin access log the archive file has the following format pulsesecureadminlog \[clustername|standalone] \[nodename|hostname] \[date] \[time] the archiving schedule configuration includes the same options as those described for the events log archive client side log uploads schedule archiving for client side log uploads this option is available only on ivanti connect secure the archiving schedule configuration includes the same options as those described for the events log, except for log filter format, which is not applicable to the client side logs archive system configuration schedule archiving for the system configuration binary file (system cfg) the archive file has the following format pulsesecureconf \[clustername|standalone] \[nodename|hostname] \[date] \[time] the archiving schedule configuration includes the same day, time, and password protection options as those described for the events log archive user accounts schedule archiving for user account configuration binary file (user cfg) the archive file has the following format pulsesecureuseraccounts \[clustername|standalone] \[nodename|hostname] \[date] \[time] the archiving schedule configuration includes the same day, time, and password protection options as those described for the events log archive xml configuration schedule archiving for the xml configuration files the archiving schedule configuration includes the same day and time options as those described for the events log administrator can select the exclude large data packages in the archived configuration to exclude esap and ivanti secure access client packages from being archived archive debug log enable archiving for collected debug logs you cannot specify a day and time for archiving debug logs if you select this option, debug logs are archived periodically and cleared if the clear log after archiving option is selected archive periodic snapshots enable archiving for snapshots you cannot specify a day and time for archiving periodic snapshots if you select this option, snapshots are archived periodically using the configuration backup and restore feature you can save up to five system configuration backups and five user account backups on the local server if you exceed this limit, the system overwrites the oldest backup with the new backup if you do not want to overwrite the oldest backup, select and delete another backup instead, before you save the most current one to manage configuration file backups select maintenance > archiving > local backups to display the configuration page local backups management page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t shows the archiving configuration page for ivanti connect secure use the controls to backup or restore the configuration as described in table docid\ l7wkyx0b0ax0kejqyud6t save the configuration local backups management page ivanti connect secure the following table lists the local backups management guidelines controls guidelines system configuration save configuration create a backup of the running system configuration delete select a row in the table and click delete to delete the backup restore select a row in the table and components in the "include when restoring" column and click restore to replace the running configuration with the archived configuration user configuration save user accounts create a backup of the running user configuration delete select a row in the table and click delete to delete the backup restore select a row in the table and click restore to replace the running configuration with the archived configuration using the import/export feature for binary system configuration files this topic describes the import/export feature for binary system configuration files binary system configuration file overview the access management framework enables you to import and export the system and network settings using binary system configuration files when importing a system configuration file, you can exclude the device certificate and the server's ip address or network settings from the imported information for example, to set up multiple ivanti connect secure systems behind a load balancer, import everything except for the ip address to set up the system as a backup server, import everything except for the digital certificate and the network settings the binary system configuration file includes the following settings network settings certificates the system imports only device certificates, not the chains that correspond to the device certificates or trusted client cas cluster configuration licenses when you import a configuration file that contains licenses, the system gives precedence to any existing licenses licenses are imported only if no licenses are currently installed snmp settings sensor configuration sensor configurations are included in the system configuration file while sensor event policies are included in the user configuration file to import or export all sensor related settings, import or export both the system and user configuration files the user configuration file, not the system configuration file, includes resource profiles, resource policies, and the local user database to perform a complete backup, export both the system and user configuration files client side logs to import or export client side logs, import or export both the system and user configuration files web proxy servers ivanti connect secure only to export all web proxy related information, both the system and user configuration files are needed web caching options ivanti connect secure only rewriter filters ivanti connect secure only exporting a binary system configuration file to export a binary system configuration file select maintenance > import/export > import/export configuration to display the configuration page export binary system configuration file configuration page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t shows the configuration page for ivanti connect secure complete the configuration and export operation as described in table docid\ l7wkyx0b0ax0kejqyud6t export binary system configuration file configuration page ivanti connect secure the following table lists the export binary system configuration file configuration and action guidelines settings guidelines password for configuration file specify a password to encrypt and secure the configuration file confirm password specify the password save config as display a dialog box to save the file to your local host importing a binary system configuration file to import a binary system configuration file select maintenance > import/export > import/export configuration to display the configuration page the following figure shows the configuration page for ivanti connect secure complete the configuration and import operation as described in the following table import binary system configuration file configuration page the following table lists the import binary system configuration file configuration and action guidelines settings guidelines options import device certificate(s)? overwrite the existing device certificate(s) with the ones in the imported configuration file when importing a device certificate in to a fips device, note that you must choose a certificate that uses a fips compliant private key to ensure fips compliance, select a certificate and corresponding security world private keys were generated on a fips device other import options import everything (except device certificate(s)) import all settings except the device certificate import everything but the ip address do not overwrite the existing configuration for network interface ip addresses, netmask, default gateway, virtual interfaces, arp tables, and route tables use this option only if the exported configuration file is from a standalone node to set up multiple nodes in a cluster behind a load balancer, import everything except the ip address import everything except network settings and licenses do not allow the imported configuration to change the existing configuration for settings found in the network settings and licensing sections with this option, network configurations, licenses, cluster configurations, certificates, defined snmp settings and syslog configurations are not imported always use this option if configuration file was exported from a node that is part of a cluster to set up a backup node, import everything except network settings and digital certificates import only device certificate(s) import the device certificate(s) only you must also select the import device certificate(s) check box config file use the browse button to locate and select the file from your local host password specify the password (if applicable) import config import the configuration file using the import/export feature for binary user configuration files this topic describes the import/export feature for user configuration binary files binary user configuration file overview in general, if a menu item falls under the authentication, administration, or users menu, the item is included in the user configuration file (user cfg) the exception is sensors event policies, which are under system, but which are exported in the user configuration file in particular, the user configuration file includes the following settings sign in settings (includes sign in policies, sign in pages, all authentication servers, authentication protocol sets, and ivanti settings) authentication realms (including admin realms, user realms, and mac authentication realms) roles resource profiles ivanti connect secure only resource policies sensor event policies user accounts client side logs to export or import client side logs, export or import both the system and user configuration files exporting a binary user configuration file to export a binary user configuration file select maintenance > import/export > import/export users to display the configuration page binary export user configuration file configuration page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t shows the configuration page for ivanti connect secure complete the configuration and export operation as described in table docid\ l7wkyx0b0ax0kejqyud6t binary export user configuration file configuration page ivanti connect secure the following table lists the binary export user configuration file configuration and action guidelines settings guidelines password for configuration file (optional) specify a password to encrypt and secure the configuration file confirm password specify the password save config as display a dialog box to save the file to your local host importing a binary user configuration file to import a binary user configuration file select maintenance > import/export > import/export users to display the configuration page the following figure shows the configuration page for ivanti connect secure complete the configuration and import operation as described in the following table import user configuration binary file configuration page the following table lists the import binary user configuration file configuration and action guidelines settings guidelines browse locate and select the file from your local host password specify the password (if applicable) import config import the configuration file using the import/export feature for xml configuration files this topic describes the import/export feature for xml configuration files xml configuration file overview the system maintains its configuration in a structured xml file this enables the system to support an alternative to the complete configurations that are exported and imported with the configuration binary files you can use the export/import configuration xml pages to export and import selected configuration elements you might find the feature useful when performing the following tasks adding to the configurations of peer nodes, for example, adding a large number of users modifying multiple instances of a single setting, for example, an authentication server name deleting settings, for example, deleting authentication servers that are no longer used creating a configuration template to use for setting up new nodes tracking configuration changes by comparing differences on periodic exports vlan settings can be imported only via system config or via xml import user config will not hold the vlan config details guidelines and limitations the following table summarizes the guidelines and limitations for using the xml import/export feature the following table lists the xml import/export guidelines and limitations category guidelines and limitations general the following guidelines and limitations apply you can import and export configuration files only between systems running the same software version if xml configuration to be imported contains one or more ivanti secure access client packages, we recommend to split the configuration to import only ivanti secure access client packages first considering one ivanti secure access client package per import and then import the remaining configurations you might find it useful to use a text editor to modify configuration elements that ought to be distinguished, such as configuration object names and descriptions never modify the names of the nic identifiers the system relies on knowing that each appliance has two interface cards, known as nic0 and nic1 immediately after importing an active directory authentication server configuration, you must edit the configuration to change the computer object name unexpected problems might arise if two systems join an active directory domain using the same computer object name licenses the following rules apply to exported and imported licenses you cannot edit the license data that is exported it is encrypted an xml import of licenses is valid only if the system does not currently have a license installed if a license is installed already, any imported licenses are dropped if you still intend to import a license, you must perform a factory reset before you perform the import operation if you import a license after deleting a temporary license, the imported license is dropped because you might still be able to reactivate the deleted license the import operation preserves any licensing data clusters the following guidelines apply to importing a configuration file for nodes that belong to a cluster when you perform an import operation on a cluster, all of the cluster nodes must be enabled and running if you attempt to import a configuration into a cluster in which a node is not running, the import operation might hang or your import results might be unpredictable the xml configuration that you import must contain the same set of nodes as the original cluster the signature used to synchronize the cluster when the nodes are reenabled is derived from the ip addresses of the cluster nodes therefore, the remaining nodes cannot rejoin the cluster if the imported configuration yields a different signature when import occurs, the imported configuration file overwrites the node specific cluster configuration network settings of the remaining nodes if you change the node specific network settings, make sure you do not make the remaining nodes unreachable after you have exported the file, do not modify settings that could render the primary node unreachable, such as changes to network settings after you have exported the file, do not modify the xml to change the node name, ip address, or ip netmask after you have exported the file, do not modify virtual port settings or add new virtual port settings exporting an xml configuration file to export an xml configuration file select maintenance > import/export > export xml to display the configuration page export xml file configuration page ivanti connect secure docid\ l7wkyx0b0ax0kejqyud6t shows the configuration page for ivanti connect secure complete the configuration and export operation as described in table docid\ l7wkyx0b0ax0kejqyud6t export xml file configuration page ivanti connect secure the following table lists the exporting an xml configuration file settings and guidelines settings guidelines schema files schema files download the xml schema definition ( xsd) files that describe the xml select settings and export expand all expand the display of all settings groups select all select all settings for all groups export export the selected configuration data to an xml file settings system expand this group and select settings found under the system menu do not select the dmi agent unless technical support instructs you to do so sign in expand this group and select settings found under the sign in menu endpoint security expand this group and select settings found under the endpoint security menu esap packages are encrypted when exported authentication realms expand this group and select authentication realm settings, including user realms and mac address authentication realms roles expand this group and select settings found under the roles menu resource profiles ivanti connect secure only expand this group and select settings found under the resource profiles menu resource policies expand this group and select settings resource policies settings ivanti secure access client expand this group and select settings found under the client menu local user accounts expand this group and select local authentication server settings maintenance expand this group and select settings found under the maintenance menu export settings? export to export the selected configuration data to an xml file enter config file password and confirm password must adhere to the password policy as per default administrators auth server page a confirmation prompt is displayed if user proceeds without password for secure export, it is recommended to use password authentication importing an xml configuration file to import an xml configuration file select maintenance > import/export > import xml to display the configuration page figure underneath shows the configuration page for ivanti connect secure complete the configuration and import operation as described in table docid\ l7wkyx0b0ax0kejqyud6t import xml file configuration page the following table lists the import xml file configuration and action guidelines settings guidelines schema files schema files download the xml schema definition ( xsd) files that describe the xml import xml data file locate and select the xml file import to import the file enter the password only if required(password protected) the import xml results page is displayed if the exported xml do not have any secure elements, the passwords given during export or import do not play any role consequently, without secure elements, the import will succeed even if incorrect or no passwords are provided this page contains information about the imported network settings, roles, resource policies, and other settings if there are errors in the xml, the import operation stops and rolls back the configuration to the previous state error messages are displayed on the import xml results page example using the configuration xml file import/export feature to add multiple users this example shows how to use the configuration xml file import/export feature the example is illustrative there are additional ways to use export files assume you have just added a new device to the network, and you want to add your 2,000 users to the system instead of adding them one at a time in the admin console, you want to perform a mass import you can export the user accounts, extract the relevant xml that defines users, replicate each element as needed, and then import them in this situation, your configuration should include the option to force the users to change their passwords the first time they log in to the system in this procedure, you only see examples for user 1, user 2, and user 2000 all other users are included in your import file you set the passwords to numbered instances of the word password, such as password1, password2, and so on all users in this example are assigned to the same auth server, although you can specify any combination of auth servers that are valid on your system to add multiple new users select maintenance > import/export > export xml follow the instructions to export local user accounts save the exported file as users xml open the users xml file copy and paste the user container element repeatedly until you have added the necessary number of users although the example shows only three new users, you might add hundreds of new users to the file update the appropriate data in each user container element as shown in "example updating the user container” save the users xml file select maintenance > import/export > xml import/export > import click browse to locate and select your users xml file enter the password , only if file is password protected click import example updating the user container \<configuration xmlns="http //xml juniper net/ive sa/6 2r1" xmlns\ xsi="http //www w3 org/2001/xmlschema instance"> \<authentication> \<auth servers> \<auth server> \<local> \<users> \<user> \<username>user1\</username> \<fullname>user1\</fullname> \<password cleartext>password1 \</password cleartext> \<one time use>false\</one time use> \<enabled>true\</enabled> \<change password at signin>true \</change password at signin> \</user> \<user> \<username>user2\</username> \<fullname>user2\</fullname> \<password cleartext>password2 \</password cleartext> \<one time use>false\</one time use> \<enabled>true\</enabled> \<change password at signin>true \</change password at signin> \</user> \<name>system local\</name> \</auth server> \</auth servers> \</authentication> \</configuration> guidelines for modifying configuration xml files this topic provides guidelines for modifying an exported configuration file preparing to modify a configuration xml file the following practices might be useful when you export and import xml configuration elements define your goals for a particular task what object or objects do you need to add, update, or delete? do you need to complete all modifications in one operation, or can you modify the configuration in separate operations? is your process a one time operation, or do you need to perform the same operation multiple times? are you updating an active system or are you using one configuration as a template for configuring systems that have not yet been brought online? document the intended changes to the configuration objects make a list of objects to be added, updated, or deleted for objects to add or update, list specific attribute data list pages or tabs from the admin console that correspond to the objects and attributes you intend to change make a binary system snapshot or a binary configuration backup immediately before you perform the import make a plan to verify that the completed configuration meets your goals view the admin access log to make sure the export and import operations succeeded perform a random check of the modified items make sure items were added, updated, or deleted as you expected make sure you are able to view configuration details in both the admin console and xml file while you work on the modifications, typically in the following sequence use the admin console to correlate the configuration data with the data in the xml file use the xml file to locate and modify the configuration data use the admin console to verify the successful import use an xml editor the exported xml files have a standard structure once you become familiar with the structure, you can navigate the files easily the files can become large, so you might find it more efficient to use a commercial or open source xml editor xml editors often separate the editable data from the structural display this separation reduces or eliminates the risk of accidentally modifying an xml element rather than its data understanding the xml export file when you export a configuration file, the system saves the configuration as an xml file the data in the exported file is based on the selections you make when you configure the export operation the file contains all of the required xml processing instructions and namespace declarations, which must be included exactly as defined the following table provides some basic information and guidelines to help you understand the structured xml used in the export file the following table lists the structured xml files basic information and guidelines topic guideline xml schema definition ( xsd) file the export is based on an xml schema the schema is a separate file that defines the metadata, and that serves as a model or a template for the exported file use the xml schema file to identify the structure and sequence of configuration objects identify optional and required elements, allowable values, default values, and other attributes of the configuration objects you can download the xml schema definition ( xsd) file in either of the following ways from the xml import/export pages by clicking a link from the url where the files are stored on the system (you do not need to sign in) to access the xsd file, access the following url https //\<ip or hostname>/dana na/xml/config xsd elements an element is a discrete xml unit that defines an object or part of an object the element typically consists of a pair of tags that may or may not surround string data tags are surrounded by angle brackets (< >) namespaces namespaces allow you to use the same words or labels in your code from different contexts or xml vocabularies prefixing elements with namespace qualifiers allow the xml file to include references to different objects that originate in different xml vocabularies and that share the same name if you do not prefix elements with namespace qualifiers, the namespace is the default xml namespace, and you refer to element type names in that namespace without a prefix a namespace declaration looks like the following example \<configuration xmlns="http //xml juniper net/ive sa/6 2r1" xmlns\ xsi="http //www w3 org/2001/xmlschema instance"> when you see namespace identifiers in your xml files, you do not need to be concerned about them, as long as you do not delete or modify the identifiers element sequence you should avoid changing the sequence of elements in the xml file, whenever possible although the schema does not enforce sequence in all cases, you gain no benefit from changing the order of elements from the order in which they appear in the exported file, and, in some cases, you might invalidate the xml structure by changing element sequence every xml tag fits into one of the following xml tag types start tag defines the beginning of an element the start tag consists of an open angle bracket (<), a name, zero or more attributes, and a close angle bracket (>) every start tag must be followed by an end tag at some point in the document end tag defines the end of an element the end tag consists of an open angle bracket and a forward slash (\</), followed by the same name defined in its corresponding start tag, and ends with a close angle bracket (>) empty tag the empty tag is denoted in two forms if a tag pair has no data between them, the tag pair is considered an empty tag officially, according to the xml specification, an empty tag looks something like this <\<empty tag example/>> in this form, the empty tag consists of an open angle bracket (<), followed by an element name, a slash and a close angle bracket (/>) when you see an empty tag in your configuration files, it signifies an element that the schema requires to be included in the xml file, but whose data is optional start tags can contain attributes, and tag pairs (elements) can contain additional elements the following example shows an xml file for the users object in this example, you see only the administrator configuration settings \<configuration xmlns="http //xml juniper net/ive sa/6 2r1" xmlns\ xsi="http //www w3 org/2001/xmlschema instance"> \<authentication> \<auth servers> \<auth server> \<local> \<users> \<user> \<username>admin\</username> \<fullname>platform administrator\</fullname> \<password encrypted>3u+u\</password encrypted> \<one time use>false\</one time use> \<enabled>true\</enabled> \<change password at signin>false\</change password at signin> \</user> \</users> \</local> \<name>administrators\</name> \</auth server> you make changes to the string data that is displayed between start and end tags for example, using the preceding example, you can add to or change the following elements \<username> admin \</username> \<fullname> platform administrator \</fullname> \<password cleartext> password \</password cleartext> \<change password at signin> false \</change password at signin> \<name> administrators \</name> the preceding sample displays the password element's data as encrypted data you can modify the password if you change the element to password cleartext if you modify the password, the password value is visible until it is imported back into the system once imported, the system encrypts the password if you enter passwords for new users in cleartext format, the passwords are visible in the file, therefore, you might consider setting the change password at next login option to true because passwords are encrypted by default, they are fully portable from one system to another use the password cleartext element and enter a text password when changing passwords through the xml file if you change a user for a given authentication server or an authentication server for a given user, you are creating a different user, not updating an existing user or authentication server user and authentication server together logically define a unique user comparing configuration settings and values shown in the user interface with the ones in the xml file the elements in the xml file are closely related to the objects and their options as you see them in the admin console the element names in the xml instance file correlate closely with the displayed object and option names for example, select users > user roles > \[role] > general > session options the admin console renders the possible values for a roaming session as an option button group, consisting of the values enabled limit to subnet disabled the following snippet from the exported configuration file shows the session options for the users role on the bolded line, the roaming session option is disabled \<session options>\<sessionoptions> \<maxtimeout>60\</maxtimeout> \<roamingnetmask /> \<roaming>disabled\</roaming> \<persistentsession>false\</persistentsession> \</sessionoptions> in the schema file, you can locate the allowable values for the roaming session option \<attribute roaming\ start> \<xsd\ element name="roaming" minoccurs="0"> \<xsd\ enumeration value="enabled"> \<xsd\ enumeration value="limit to subnet"> \<xsd\ enumeration value="disabled"> \</xsd\ element> \<attribute roaming\ end> to change the value for the roaming session from disabled to limit to subnet , replace disabled with limit to subnet this example shows that the admin console often provides all of the allowable values, displayed either in an option button group, as check boxes, as list boxes, or as other types of user interface components the xml file displays only the current state of your configuration the schema file displays all of the actual values for the configuration options that are supported understanding referential integrity constraints the system configuration objects are part of a data model that is enforced through the use of referential integrity constraints you cannot change these constraints, but you should understand them before you attempt to delete objects that maintain dependencies to other objects if you violate the referential integrity constraints, your import operation fails in the following figure the boxes represent object types and the arrows represent dependent relationships between the object types arrows point from dependent objects to objects object referential integrity constraints the system does not allow you to delete an object on which another object depends conversely, when you add an object, you must add any other objects on which that object depends sign in urls depend upon realms and sign in pages realms depend upon both authentication servers and roles policies depend upon roles users depend upon authentication servers consider the following scenarios based on the preceding figure if you add sign in urls, you must add realms, sign in pages, roles, and authentication servers you need to add an authentication server and at least one role to support the realm, and you must add the realm and the sign in page to support the new sign in url if you add a user, you must be able to assign it to an authentication server if there is no authentication server on the target node yet, you must add one in the xml file if you add a policy, you must be able to assign it to a role if there is no role on the target system, you must add one in the xml file if you delete an authentication server, you might strand realms and users, therefore, you need to make sure no realms or users depend on the authentication server before you attempt to delete it if you delete a role, you might strand policies and realms to delete a role, you must first delete any policy that depends upon the role, or reassign associated policies to another role also, to delete a role, you must first delete or reassign any realm that depends upon that role if you delete a sign in page, you might strand one or more sign in urls to delete a sign in page, you must first delete any associated sign in urls or reassign them to other sign in pages referential integrity checks are performed only during xml import using operation attributes operation attributes define the positioning or action of xml data within the schema if you do not specify an operation attribute, the modified data is merged by default xml data with an operation attribute has the following format \<object1 xc\ operation="operator for object1 and its children unless new operator is defined"> … \<object2> … \<object3 xc\ operation="operator for object3"> … \</object3> … \</object2> … \</object1> the operation attribute is applied to all children objects unless a different operation attribute is defined in children objects the following operation attributes are supported merge the configuration data identified by the element that contains this attribute is merged with the configuration at the corresponding level in the configuration datastore identified by the target parameter this is the default behavior replace the configuration data identified by the element that contains this attribute replaces any related configuration in the configuration datastore identified by the target parameter only the configuration actually present in the configuration parameter is affected create the configuration data identified by the element that contains this attribute is added to the configuration if and only if the configuration data does not already exist on the device delete the configuration data identified by the element that contains this attribute is deleted in the configuration datastore identified by the target parameter insert before changes the position of a configuration element in an ordered set insert after changes the position of a configuration element in an ordered set rename changes the name of one or more of a configuration object's identifiers if you are merging a list of objects to an existing list of objects in the configuration store, the results of the merged list might be unexpected during a merge operation the order of the objects in the new list is not maintained if you are importing a list of objects and would like to preserve the order of the new list, you should use the replace operation attribute you can also use insert before or insert after to ensure that you produce the hierarchy that you intended operation attributes are applied to elements recursively unless new operators are also defined within lower level elements there are limitations on the legal operator that can be used in child elements without conflict with the parent operator the following table displays the legal operator relationships between parent and child elements the following table lists the legal operator attribute relationships child > v parent create merge replace delete insert before insert after rename none ok ok ok ok ok ok ok create ok ok error error ok ok error merge ok ok ok ok ok ok ok replace error ok ok error ok ok error delete error ok error ok error error error insert before ok ok ok ok ok ok ok insert after ok ok ok ok ok ok ok rename ok ok ok ok ok ok ok the following examples demonstrate the import operation example 1 set the mtu to 1500 on an interface named "ethernet0/0" in the running configuration \<interface> \<name>ethernet0/0\</name> \<mtu>1500\</mtu> \</interface> example 2 add an interface named "ethernet0/0" to the running configuration, replacing any previous interface with that name \<interface xc\ operation="replace"> \<name>ethernet0/0\</name> \<mtu>1500\</mtu> \<address> \<name>192 0 2 4\</name> \<prefix length>24\</prefix length> \</address> \</interface> note the default import modes have the following equivalent attributes on the root object of the configuration tree standard import is always a merge operation quick import is a create operation full import is a replace operation using the push configuration feature this topic describes the push configuration feature push configuration overview the push configuration feature supports simple configuration management across an enterprise without requiring you to deploy the systems as a cluster you push a partial configuration from the running configuration on the source system to the running configuration on one or more target systems it is not desirable to push some groups of settings to a running configuration, so the following groups of settings are not supported network configurations licenses cluster configurations certificates snmp settings syslog server settings push configuration targets guidelines and limitations the following table lists the push configuration guidelines and limitations category guidelines and limitations general the following guidelines and limitations apply you can push a configuration to systems running the same software version (same build number) or higher software version the source device pushes data over the management port (if configured) or the internal port the target device can receive data over the internal or external port or management port you can push to a single target or to multiple targets for example, if you install several new systems, you can push a common configuration to set their initial configuration when a configuration push job begins on a target, no warning is displayed, and the administrators are automatically logged out to avoid potential conflicts for selected configuration push, if the configuration to be pushed contains one or more ivanti secure access client packages, we recommend you push the ivanti secure access client packages first considering one ivanti secure access client package per push and then push the remaining configurations when the job has completed on a target, the target device restarts its services brief interrupts might occur while the service restarts you must push to targets when they are idle or when you can accommodate brief interruptions immediately after pushing an active directory authentication server configuration, you must edit the configuration to change the computer object name unexpected problems might arise if two systems join an active directory domain using the same computer object name you must delete the failed push jobs before performing a new push when performing an entire configuration push, with changes to settings such as security settings, the target web server might get restarted during configuration import as a result, the source might experience a lost connection you can resume the job from the source at a later point to see the result of the import licenses the push configuration job does not push licenses or licensing settings clusters you can push a configuration to multiple targets, as long as targets are not part of the same cluster you must not perform the clustering operations such as adding a cluster, deleting a cluster, and so on when performing a push configuration if such events occur, then unsuccessful jobs will be aborted, and the backup files will be deleted you can push a configuration to multiple targets, as long as targets are not part of the same cluster you must not use vips during push configuration instead you must use the internal ip or the management ip of one of the nodes to create the target you must delete the backed up configuration on the target node(s) as soon as possible to free up the disk space configuring targets in previous ics releases, the push configuration did not validate the target server certificate unless the "validate target server certificate" option was explicitly enabled by the ics administrator this could result in ics connecting to an untrusted target, posing security risks the update in this version addresses this issue by securing this behavior by default push configuration behavioral changes push config fails if mfa is enabled on the admin account of the target ics server there is change in default behavior of push configuration the change is as follows a fresh installation of the ics will enable "validate target server certificate" by default during an upgrade, ics will enable the "validate target server certificate" checkbox, overriding its previous state if unchecked a log message will note this change during a config import, ics will enable the "validate target server certificate" checkbox, overriding any previous unchecked state a log message will indicate if this override occurs api and xml import workflows will remain unchanged the push configuration feature will not work if the target server certificate validation fails ivanti recommends all customers use trusted certificates on their ics servers if you need more time to install valid digital certificates, you can override the option by disable the "validate target server certificate" checkbox after an upgrade, fresh installation, or configuration import however, this is a temporary fix as this option will be deprecated in a future release the push configuration target list and source device settings page ivanti connect secure figure shows the configuration page for ivanti connect secure complete the configuration for the source options as described in table docid\ l7wkyx0b0ax0kejqyud6t click new target to display the configuration page for targets figure docid\ l7wkyx0b0ax0kejqyud6t shows the configuration page for ivanti connect secure complete the configuration as described in table docid\ l7wkyx0b0ax0kejqyud6t save the configuration push configuration target list and source device settings page ivanti connect secure the following table lists the push configuration target source device configuration options settings guidelines allow this system to be a target select this option to allow the system to accept configuration pushed from another system this option must be selected on targets, but does not have to be selected on the source system shared secret key shared secret is configured for each source/target pair at time of creation of push config target the key generated randomly at source and exchanged at time of push job will act as password for the push config operations if shared key is configured on both source/target, then this shared key and randomly generated key combined will behave as password enter a shared secret key to be configured at target in push config target validate target server certificate select this option on the source system to validate the target system server certificate before pushing the configuration save changes click this button if you have changed the source device configuration options described above delete select a row in the table and click delete to remove the target from the list you cannot delete a target if it has push configuration results associated with that target push configuration targets configuration page the following table lists the push configuration targets configuration guidelines settings guidelines name specify a name to identify the target within the system target names cannot be edited after they have been saved sign in url specify the url for the administrator sign in page sign in urls cannot be edited after they have been saved admin username specify an account on the target system that the push configuration job can use to sign in and make changes to the configuration the job can make wide ranging configuration changes, so the user must have full administrative privileges in other words, the user must belong to the administrators role password specify the corresponding password auth realm specify the administrator authentication realm on the target system the access management framework must be configured so that the job process (run as the username specified above) can sign in without any human interaction for example, you cannot have dynamic credentials or multiple roles that are not merged, as these both require manual interaction we recommend that you create an administrator account on each target that can be used exclusively for push configuration configure the administrator realm so that the realm policy and role mapping rules do not result in prompts requiring human interaction for example, the user must be able to log in with static password authentication or two factor tokens that do not use challenge response type authentication for example, certificates, soft id, and defender authentication are not supported shared secret key specify a shared secret key to be configured at source in push config target configuring push settings to configure the settings to be pushed select maintenance > push config > push configuration to display the configuration page the following push configuration selected settings page figure shows the configuration page for ivanti connect secure complete the configuration and push configuration operation as described in table push configuration selected settings and action guidelines push configuration selected settings page push configuration selected settings page the following table lists the push configuration selected settings and action guidelines settings guidelines select settings and export what to push select selected configuration or entire configuration if you select selected configuration, the page displays controls to select settings groups if you select entire configuration, all settings from the source system are pushed, except for the following network configurations licenses cluster configurations certificates snmp settings syslog server settings push configuration targets expand all click this button to expand the display of all settings for all groups select all click this button to select all settings for all groups settings system expand this group and select settings found under the system menu you cannot push host specific network settings to a target if you want to copy these settings to another system, use the configuration xml file import/export feature sign in expand this group and select settings found under the sign in menu endpoint security expand this group and select settings found under the endpoint security menu esap packages are encrypted when exported authentication realms expand this group and select authentication realm settings, including user realms and mac address authentication realms roles expand this group and select settings found under the roles menu resource profiles connect secure only expand this group and select settings resource profiles settings resource policies expand this group and select settings resource policies settings ivanti secure access client expand this group and select settings found under the secure menu local user accounts expand this group and select local authentication server settings maintenance expand this group and select settings found under the maintenance menu push configuration available targets / selected targets use the add and remove buttons to select the targets overwrite duplicate settings select this option to overwrite settings on the target that have the same name as settings being pushed if you do not select this option, the push configuration job copies only configuration objects that have names different from the configuration objects on the target allow rollback to previous configuration select this option to revert to a previous configuration state, effectively rolling back configuration changes if you select this option, the local configurations on the target node will be backed up before importing the configurations you can also undo the push configuration if you want to discard the changes and revert back to the previous state we recommend you delete the backed up configuration if the import is successful if the target configuration is large the rollback of configurations can take several minutes to complete description enter the description for the job the job description is limited to 100 characters schedule import on target select this option to allow a delayed import on the target node if you select this option, the selection applies to all the targets in the job the import schedule is measured in hh\ mm (hours, minutes) format the schedule is specified according to source's timezone push configuration click this button to push the selected configuration data to the specified targets you can pause the push for a target during the push process if errors occur during the push process, the job stops, and the configuration for the target is not imported however, you can resume the failed push jobs error messages are displayed on the results page if you have specified multiple targets and a push configuration job to a target fails, the job continues to the next target until specified targets are updated (or fail) the results page displays the status and any problems encountered during the process viewing configuration push results purpose the source system saves and displays the push configuration results in the results tab action to view push configuration job results select maintenance > push config > results to display the results page the push configuration results page figure shows the results page for ivanti connect secure the push configuration results page auto refreshes for every 30 seconds examine the results to verify success or learn the reasons the push job failed click the job name to display additional information about the job select a job and click delete to remove it from the results page push configuration results page the following table describes the information displayed on the results page and the various management tasks you can perform the following table lists the push configuration results gui element guidelines disk usage details displays the disk space available for push configuration and the disk space consumed by all the push jobs in the device the disk space consumed by individual push jobs are also mentioned across each push job under the disk usage column when total disk space consumed reaches the total disk space push jobs may fail and you can see the results column to see the failure message you need to monitor the disk space consumed by push configuration to avoid push failures related to disk space limits description column displays the type of the push configuration disk usage column displays the disk space used by the job results column displays the status of the transfer and result of post push action it also displays the status of the push such as login, export, transfer, backup, import and so on the status result message shows the type of data that is getting transferred for a paused or failed target, the information on the current state of the job when it is paused, or failure reasons if any is displayed this column also shows the progress of data transfer using a bar chart for selected push additional configuration data (additional configuration data refers to configuration that is transferred only if it is modified or not available on the target) includes esap package, ivanti secure access client package, vdi configurations, terminal services, host checker files, custom sign in pages and notifications, and applet files for complete configuration push additional data includes esap and ivanti secure access client packages post push action displays the options that the user can perform after the push such as roll back and delete backup it also displays the post push actions such as rollback done, backup deleted, rollback failed, performing rollback, deleting back up and so on resume select this option to resume a paused or a failed push undo select this option to rollback to previous configuration that was backed up note that you can perform this operation only when the push is successful and allow rollback to previous configuration is selected this option is available only if the backup is not deleted or undo is not done yet abort select this option to cancel an entire push job or push to particular target within a job an aborted push cannot be resumed pause select this option to temporarily pause the push operation to a specified target delete backup select this option to delete the backup configuration on the specified target note that this option is available only when the users selects the allow rollback to previous configuration option during the push job viewing configuration push history purpose the source/target system saves and displays up to 5 push history results per target/source in the history tab when the history table reaches 5 entries, the system removes the oldest result data when the next push configuration job is started action to view push configuration push history select maintenance > push config > history to display the history page the following figure shows the history page for ivanti connect secure examine the history to verify success or learn the reasons the push job failed the history page displays rollback history however the failure reason is not displayed you can check the failure reason in the details page for each job it also displays the timestamp history information of successful, failed push jobs, or if a configuration is undone select the source name/target name and click delete history to remove it from the history page push configuration history page