UCSM Configuration Backup/Restore (Import) on UCS Platform Emulator 3.1(1ePE1)

[dsoper]

Here is a brief introduction to the new 3.1(1ePE1) UCS Platform Emulator showing how to perform backup and restore(import) of the current UCSM configuration.  Backup/restore of the configuration is a good practice in general and is necessary with the new Platform Emulator since UCSM configuration state is lost on Platform Emulator resets.

The UCSM GUI, CLI, PowerTool for UCS, and/or the PythonSDK can be used to perform backup/restore operations.  This video uses the PythonSDK, which is in beta and currently available on GitHub.

Backup operations in the video are done with backup_ucs().  Here's a code snippet:

from ucsmsdk import ucshandle

from ucsmsdk.utils.ucsbackup import backup_ucs

<snip>

        handle = ucshandle.UcsHandle(settings.ip, settings.user, settings.pw, secure=settings.secure)

        handle.login()

        fname = raw_input('Enter filename for backup (current directory): ')

        backup_ucs(handle, backup_type="config-all", file_dir="./", file_name=fname)

Restore (import) operations are done with import_ucs_backup():

from ucsmsdk import ucshandle

from ucsmsdk.utils.ucsbackup import import_ucs_backup

<snip>

        handle = ucshandle.UcsHandle(settings.ip, settings.user, settings.pw, secure=settings.secure)

        handle.login()

        fname = raw_input('Enter filename for import (current directory): ')

        import_ucs_backup(handle, file_dir="./", file_name=fname)

ucspe_backup_restore.mp4

Video Player is loading.

Play Video

Play

Mute

Current Time 0:00

/

Duration 0:00

Loaded: 0%

0:00

Stream Type LIVE

Seek to live, currently behind liveLIVE

Remaining Time -0:00

1x

Playback Rate

Chapters

• Chapters

Descriptions

• descriptions off, selected

Captions

• captions settings, opens captions settings dialog
• captions off, selected

Audio Track

Picture-in-PictureFullscreen

This is a modal window.

Beginning of dialog window. Escape will cancel and close the window.

Text

ColorWhiteBlackRedGreenBlueYellowMagentaCyanTransparencyOpaqueSemi-Transparent

Background

ColorBlackWhiteRedGreenBlueYellowMagentaCyanTransparencyOpaqueSemi-TransparentTransparent

Window

ColorBlackWhiteRedGreenBlueYellowMagentaCyanTransparencyTransparentSemi-TransparentOpaque

Font Size

50%75%100%125%150%175%200%300%400%

Text Edge Style

NoneRaisedDepressedUniformDropshadow

Font Family

Proportional Sans-SerifMonospace Sans-SerifProportional SerifMonospace SerifCasualScriptSmall Caps

Reset restore all settings to the default valuesDone

Close Modal Dialog

End of dialog window.

Close Modal Dialog

This is a modal window. This modal can be closed by pressing the Escape key or activating the close button.

118640screenshotLg.jpg

screenshotLg.jpg

118639screenshotLg.jpg

[dpdatastrat]

Why is the video so blurry expanded? Can you share the command to run using the ucsbackup.py file since the video is either too tiny to watch (visible text) or too blurry?

[dsoper]

Hi Dominic,

Sorry about the poor video quality.  You can backup and import configs in the UCSM GUI, or using the script above the command line is the following:

python ucsbackup.py

Note that for the above command line to work, you will want to edit this line:

handle = ucshandle.UcsHandle(settings.ip, settings.user, settings.pw, secure=settings.secure)

to use the ip, username, and password of your emulator instance.  Here's an example:

handle = ucshandle.UcsHandle('10.0.1.100', 'ucspe', 'ucspe', secure=True)

Let me know of other questions.

[CiscoAP]

Great Script and procedure.  It works great.

Thanks for posting it!

Thank you.

[dschelt]

# I had to make some changes running RHEL 8.2 and Python3

# First, python directory did not exist. I had to make symlink:

sudo ln -s /usr/bin/python3.6 /usr/bin/python

#pip3 instead of pip

pip3 install ucsmsdk

To Backup:

python

from ucsmsdk import ucshandle

from ucsmsdk.utils.ucsbackup import backup_ucs

#replace n.n.n.n with your UCSPE VIP

handle = ucshandle.UcsHandle('n.n.n.n', 'ucspe', 'ucspe', secure=True)

handle.login()

# raw_input was depreciated

fname = input('Enter filename for backup (current directory): ')

#Enter filename at the prompt..

backup_ucs(handle, backup_type="config-all", file_dir="./", file_name=fname)

To restore:

python

from ucsmsdk import ucshandle

from ucsmsdk.utils.ucsbackup import import_ucs_backup

handle = ucshandle.UcsHandle('n.n.n.n', 'ucspe', 'ucspe', secure=True)

handle.login()

fname = input('Enter filename for import (current directory): ')

#Enter filename at the prompt..

import_ucs_backup(handle, file_dir="./", file_name=fname)