Inleiding
Dit document beschrijft hoe u delen van het XML-configuratiebestand (eXtensible Markup Language) in de E-mail security applicatie (ESA) kunt uploaden.
Voorwaarden
Vereisten
Cisco raadt kennis van de volgende onderwerpen aan:
- Xtensible Markup Language (XML)
- E-mail security applicatie (ESR)
Gebruikte componenten
Dit document is niet beperkt tot specifieke software- of hardwareversies.
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk levend is, zorg er dan voor dat u de mogelijke impact van om het even welke opdracht begrijpt.
Opmerking: Dit document bestaat uit de veronderstelling dat de te uploaden configuratie uit dezelfde AsyncOS-versie bestaat.
Configureren
Overzicht
De ESA staat u toe een configuratiebestand te importeren dat is verkregen van elk punt in de tijd of van elke andere ESA.
ESA FAQ: Hoe importeert u een configuratiebestand in een nieuw apparaat?
U kunt scenario's tegenkomen waarop het handiger is om alleen delen van de configuratie te importeren, in plaats van een volledig configuratiebestand.
- Recresies
- Functietests
- Een groot aantal items tegelijk toevoegen aan specifieke instellingen
Achtergrondinformatie
U kunt informatie op een van de drie methoden laden:
- Plaats informatie in de configuratiemap en uploaden deze.
- Upload het configuratiebestand rechtstreeks vanuit uw lokale machine.
- Plakt informatie over de configuratie direct.
Ongeacht de methode, moet u deze tags aan de bovenzijde van de configuratie toevoegen:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE config SYSTEM "config.dtd">
<config>
... your configuration information in valid XML
</config>
Het sluiten </fig> zou uw configuratieinformatie moeten volgen. De waarden in XML syntaxis worden geparseerd en gevalideerd tegen DTD in de configuratiemap op uw Cisco Content Security Appliance. Het DTD-bestand wordt een naam gegeven in configuratie.dtd. Als de validatiefouten op de opdrachtregel worden gemeld wanneer u de opdracht laden gebruikt, worden de wijzigingen niet geladen. U kunt de DTD downloaden om configuratiebestanden buiten het apparaat te valideren voordat u ze uploadt.
Configuratie
Om een subsectie van het configuratiebestand te importeren, moet de subsectie compleet en uniek zijn en de declaratiestags hierboven bevatten, evenals in <Configuration></fig>.
Complete betekent dat de volledige begin- en eindtags voor een bepaalde subsectie, zoals gedefinieerd door de DTD, zijn opgenomen. Bijvoorbeeld het uploaden of plakken van de volgende code veroorzaakt validatiefouten:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE config SYSTEM "config.dtd">
<config>
<autosupport_enabled>0</autosu
</config>
Uploaden of plakken van deze code veroorzaakt echter geen validatiefouten:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE config SYSTEM "config.dtd">
<config>
<autosupport_enabled>0</autosupport_enabled>
</config>
Uniek betekent dat het subdeel van het configuratiebestand dat geüpload of geplakt wordt, niet dubbelzinnig is voor de configuratie. Bijvoorbeeld, kan een systeem slechts één hostname hebben, zodat uploadt u deze code (inclusief de verklaringen en <span></span> tags) wordt toegestaan:
<hostname>mail4.example.com</hostname>
Er kunnen echter meerdere luisteraars worden gedefinieerd in een systeem waarbij alle verschillende toegangstabellen voor ontvangers zijn gedefinieerd. Zo kan alleen deze code worden geüpload als dubbelzinnig:
<rat>
<rat_entry>
<rat_address>ALL</rat_address>
<access>RELAY</access>
</rat_entry>
</rat>
Omdat het dubbelzinnig is, is het niet toegestaan, ook al is het volledige syntax.
Voorzichtig: Wanneer u een configuratiebestand of subsecties van een configuratiebestand uploaden of geplakt hebt, kunt u niet-geëngageerde wijzigingen verwijderen die mogelijk hangende zijn.
Lege versus weggelaten tassen
Gebruik voorzichtigheid bij het uploaden of plakken van delen van configuratiebestanden. Als u geen tag toevoegt, dan wordt de waarde ervan in de configuratie niet aangepast wanneer u een configuratiebestand laadt. Als u echter een lege tag wilt toevoegen, wordt de configuratie-instelling gewist.
Het uploaden van de volgende code verwijdert bijvoorbeeld alle luisteraars uit het systeem:
<listeners></listeners>
Voorzichtig: Wanneer u subsecties van een configuratiebestand uploaden of plakken, kunt u jezelf loskoppelen van de GUI of de CLI en grote hoeveelheden configuratiegegevens vernietigen. Schakel services niet uit met deze opdracht als u niet in staat bent om deze opnieuw aan te sluiten op het apparaat met behulp van een ander protocol, de seriële interface of de standaardinstellingen op de beheerpoort. Gebruik deze opdracht ook niet als u niet zeker weet welke configuratie syntax is zoals gedefinieerd door de DTD. Maak altijd een back-up van de configuratiegegevens voordat u een nieuw configuratiebestand laadt.
Opmerking over codering van tekenset
De coderingseigenschap van het XML configuratiebestand moet "ISO-8859-1" zijn, ongeacht de tekenset die u kunt gebruiken om het bestand offline te manipuleren. De coderingseigenschap wordt in het bestand gespecificeerd wanneer u de showfig, saveconfig, of mailconfiguratie opdracht geeft:
<?xml version="1.0" encoding="ISO-8859-1"?>
Verifiëren
Navigeer naar de pagina van de aangepaste optie of instelling.
Gerelateerde informatie