Dell EMC Repository Manager Version 3.0 User Guide
Table of Contents
Dell EMC Repository Manager Version 3.0User’s Guide
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
Overview
The Dell EMC Repository Manager (DRM) ensures that the Dell systems are up-to-date with the latest BIOS, driver, firmware, and software. DRM allows you to:
Create repositories of customized component(s) and updates.
Create groups of related updates for systems running the Microsoft Windows and Linux operating systems.
Generate comparison reports. Update baselines of custom repositories and generate deployment tools.
The customized repositories are made up of Dell EMC Update Packages (DUPs) or Non-DUPs (such as .exe, .msi, .bin or any other file formats) files. DUPs are software utilities provided to update specific software and firmware components. You can arrange these components to group the related updates together. Every repository has a catalog.xml file and it specifies the content of the repository. DRM also has catalog.xml.gz and catalog.gz files. You can import the repository content in two formats, however, you can export the repository content in catalog.xml format only. The file downloaded from ftp.dell.com/catalog and downloads.dell.com/catalog is digitally signed to ensure system security.
Topics:
What is new in this release
Prerequisites for installing DRM
Accessing documents from the Dell EMC support site
Other documents you may need
What is new in this release
This release of Dell Repository Manager (DRM) supports the following new features:Support for DRM installation on Linux operating systems.
Improved user interface
Support for Command Line Interface.
Support for Smart Bootable ISO
Support for index catalog
Support for multiple repository versions
Prerequisites for installing DRM
This section lists the specific prerequisites to be considered before installing DRM.
Hardware requirements
Table 1. Hardware requirements
Requirement
Details
Processor
1 GHz Pentium processor or equivalent
RAM
4 GB
Hard Disk
1 GB of available space
Display
1024 x 768 high color, 32-bit
Optical Drive (Optional)
CD/DVD writer
Software requirements
Supported operating systems:
Microsoft Windows Server 2008 R2
Microsoft Windows Server 2012 R2
Microsoft Windows Server 2016
Microsoft Windows 7 (64-bit)
Microsoft Windows 8.1 (64-bit)
Microsoft Windows 10 (64-bit)
RedHat Enterprise Linux 6.x
RedHat Enterprise Linux 7.x
SUSE Linux 12
Optional requirements
Internet connectivity – To access, create, and work with bundles, catalogs, and repositories.NOTE: You can use the local repositories on DRM without internet connectivity.
CD/DVD or USB burning software – To create a bootable CD/DVD or bootable USB.
Select the required version of the repository manager.
The drivers specific to the version of the product is displayed.
Accessing documents from the Dell EMC support site
You can access the required documents in one of the following ways:Using the following links:
For Dell EMC Enterprise Systems Management, Dell EMC Remote Enterprise Systems and Dell EMC Virtualization Solutions documents — www.dell.com/esmmanuals
Dell EMC Systems Management – OpenManage Software Support Matrix
Dell EMC Update Packages User’s Guide
Dell EMC Server Update Utility User’s Guide
Dell EMC OpenManage Server Administrator Installation Guide
Dell EMC OpenManage Essentials User’s Guide
Installing and uninstalling DRM
DRM can be installed on the supported Microsoft Windows and Linux operating systems. For the list of supported operating systems, seeSoftware requirements.For more information on installing DRM on supported operating systems, see Installing, updating, and uninstalling DRM chapter in the Dell EMC Repository Manager version 3.0 Quick Start Guide.
Topics:
Updating DRM
Updating DRM
On the Dell EMC Repository Manager drop-down list, in the Settings section, click on Check for New Version to update to the latest version of the repository manager.
Using Dell EMC Repository Manager
Using DRM, you can perform some of the basic tasks, such as:
Work with repositories
Modify repository
Delete repositories
Work with components
Export catalog
Search repository based on filters and search criteria you specify
Copy components to new and existing repositories
Work with jobs queue
Search Dell Support Site
Topics:
Configuring settings
Creating repository
Working with My Repositories
Working with components
Working with jobs
Creating deployment tools
Working with filters
Launching support site
Save and mail logs
Configuring settings
This section describes the process to configure the settings. You can configure the network settings, notifications, plug-in, data storagesettings.
Configuring network settings
This section describes the process to configure the network settings.
Click on the Dell EMC Repository Manager drop-down
On the Manage section, click Application Preferences. The Preferences window is
In the Network section, you can:
Select the Web Download Protocol — The available options are HTTP. and FTP. NOTE: By default, the HTTP protocol is selected.
Select the maximum number of concurrent downloads.
As an optional step, you can choose the proxy configuration. You must provide the Proxy Server Address. Proxy Port. and the appropriate credentials.
Click Apply.
Configuring notifications
This section describes the process to configure the notification.
Click on the Dell EMC Repository Manager drop-down
On the Manage section, click Application Preferences.The Preferences window is displayed.
In the Notification section, select the relevant option if you want a notification for catalog updates or jobs.
In the Email Configuration section, click configure.
From the Email Type, select the method through which you want to send the mail. The available options are SMTP and MicrosoftExchange.If you select the SMTP option, you must provide the following details:• Email ID• Username• Password• DomainNOTE: You also have the option to authenticate anonymously.You should also provide the SMTP details such as:• SMTP Server• Port Number NOTE: You also have the option to bypass proxy or use SSL/TLS to establish communication.If you select the Microsoft Exchange option, you must provide the following details:• Email ID• Username• Password• DomainNOTE: To manually create an exchange URL, hold the control (ctrl) key and right-click on the Microsoft Outlook trayicon. Click Test E-mail AutoConfiguration and provide an email address and click Test. The exchange URL is displayed in the Availability Service URL field.
Click Save to save the configuration.
Click Apply. NOTE: A notification is sent to the email that has been configured. You can also add additional emails to notify multiple users. To add multiple users, separate the recipients using a semicolon (;).
Configuring store settings
This section describes the process to configure the storage settings.
Click on the Dell EMC Repository Manager drop-down menu.
On the Manage section, click Application Preferences.The Preferences window is displayed.
In the Store section, you can choose the location to store the repositories.
You have the option to clear the files after exiting through the Cleanup option, delete update packages that are not referenced, or send alerts when the size of the file exceeds a certain limit.
After selecting the preferences, click Apply.
NOTE: The repositories can be stored in a local storage location, a mapped network shared location, or a Common Internet File System (CIFS) shares location only.
Configuring plug-in settings
This section describes the process to configure the plug-in settings.
NOTE:Dell EMC System Update(DSU) is a prerequisite for Smart Deployment Script.
Click on the Dell EMC Repository Manager drop-down menu.
On the Manage section, click Application Preferences.The Preferences window is displayed.
In the Plug-ins section, you can:• Update the available plug-ins• Update notification — Automatic download or notify when a new plug-in is available• Select the source of plug-in
Select the required plug-in from the Plugin section and click on Update.
Select the required option either to automatically install the updates or notify about the update.
Select the source of plug-in update from the Source of Plug-in Update. The available options are Dell EMC Online and Folder,that is the local location or the network shared location.
Click Apply.
Configuring catalogs settings
This section describes the process to configure the network settings.
Click on the Dell EMC Repository Manager drop-down menu.
On the Manage section, click ApplicationPreferences.The Preferences window is displayed.
In the Catalogs section, you can add, delete, or update catalogs. A notification is displayed every day with the information about thecatalog update.
You can choose the actions whenever an update is available. You can automatically download and update the new catalog or notifywhen a new catalog is available.
After selecting the preferences, click Apply.
Creating repository
DRM enables you to create a repository that contains multiple system bundles and allows you to manage baselines or create deploymenttools.
Creating manual repository
This section describes the process to create a repository manually.
On the Home page. Click Add New Repository. Add Repository window is displayed.
Enter the Repository Name and Description.
Select a catalog to be used as a base catalog for the repository. If you want to add a custom base catalog. Click Choose File option from the Base Catalog drop-down list and select the required file. The available options are Enterprise Server Catalog. Index None. and Choose File.
From the Catalog Location drop-down menu. select the latest available catalog or click on Choose File to select the catalog file saved in a local folder or a common shared location.
If you want to select systems to apply the updates in the repository:
Select All systems in the base catalog to apply updates to all the systems.
Select Custom and click Choose Systems to select systems individually to apply the update. The Systems window is displayed.From the Line of Business drop-down menu, select the system whose updates are to be included in the repository. Click
Select All operating systems in the base catalog to apply updates to all the operating systems or select Custom and click Choose Operating System to select the operating systems individually to apply the update.
Select All component types and devices In the base catalog to apply updates to all the devices or select Custom and select Choose Components to select the components individually to apply the update.
If you do not select the components. by default, the repository is created for all the components in the base catalog.
Select Add to create the repository. The repository is displayed in the repository dashboard available on the home page.
NOTE: You can also create a new repository without customizing the preferences. Enter the name of the repository and click Add to create a repository.
Creating empty repository
This section describes the process to create an empty repository.
On the Home page, click Add Repository.Add Repository window is displayed.
Enter the Repository Name and Description.
Select None from the Base Catalog drop-down menu.
Click Add to create the repository.The repository is displayed in the repository dashboard available on the home page.
Creating repository with integration
This section describes the process to create a repository with integration.
On the Home page. Click Add New Repository. Add Repository window is displayed.
On the Integration enter the Repository Name and Description.
From the DUP Format drop-down menu. select the formats that you want to include in the repository.
From the Integration Type drop-down menu. select the product with which you want to integrate. Based on the product selected the following options are displayed. The available options are:
iDRAC — Hostname/IP. Port Number. Username. Password. and Proxy Server
Dell OpenManage Essentials — IP. Port Number. Username. Password. and Proxy Server
Dell OpenManage Integration for VMware vCenter — Virtual Appliance IP. vCenter Server Username. Password. and proxy server
Dell Console Integration —URL. User– i.. password. and proxy server
NOTE: Dell Console Integration is applicable for consoles that have incorporated the web services such as OpenManage Integration for System Center Virtual Machine Manager (SCVMM) and OpenManage Enterprise v3.0 or greater.
After selecting the required option-click Connect The available system and model will be displayed in the Integration Type section.
Select Add to create the repository. The repository is displayed in the repository dashboard available on the home page.
Creating repository with inventory
This section describes the process to create a repository with an inventory.
On the Home page. Click Add New Repository. Add Repository window is displayed.
On the Inventory enter the Repository Name and Description.
Select a catalog to be used as a base catalog for the repository. If you want to select a customized catalog, click navigate. and select the required catalog.
To select an inventory. Click Browse and navigate to the location where the inventory is saved and select the required inventory file.
Select Add to create the repository.
The repository is displayed in the repository dashboard available on the home page.
Working with My Repositories
The My Repositories screen displays the list of available repositories. You can control and perform various tasks using the New, Open, Delete, and Refresh options available on the screen. During the installation, Dell Repository Manager creates a database in the system.
Viewing repository
You can view the created repositories on the Home page. You can also click on the Dell EMC Repository Manager drop-down menuand in the View section, click Repositories
Editing repository properties
lit swoon describes the process to get the cosplay propane.
On the DMAhome page. select a repository to edit. The Property writer 6 &spayed
ark Eat to edit the selected repository.The Eat wmobw 6 displayed.an Update the required bald, such as Name Label Description
CIO Save to t.cdve pr.:fere-cc
Comparing repository
This section describes the process to corneal repository based on components platforms.
On the DMA home page. select a repository that you want to compare.
Click ampere
Fran the View section select if you want to display the Component View a Platfonn %fn.NOTE: A notification is displayed If the latest version of the selected catalog is wobbled.
From the Filter, section selects the preferences from the Type of Change drop-down 1st. Ayalatile opals we Upgraded Downgraded. and No Change.
from the Criticality dop. cbwn lot. select at option. The wattle options are Urgent. Recommended. and Optional
ark Update.If there we arty updates between Taiwan and the latest yenta, of the catalog. the changes we displayed.
Refreshing repository
This section describes the process to refresh a repository.
On the DRM home page, select the repositories that you want to refresh.
Click Refresh.The Refresh window is displayed and the selected repositories is displayed.
Select the Date and time to refresh the repository.
From the Settings section, choose the duration at which the repository is refreshed. The available options are One Time, Daily,WeeklyOnce, and Monthly on this day.
Select the Notification option to notify users through the mail.
Click Save.You can also edit the scheduled refreshed task from the Jobs screen.
Viewing properties of repository
This section describes the process to view the properties of repositories.
On the DRM home page, select the repository for which you want to view the properties.
The properties of the selected repository are displayed in the Property section on the DRM home page.Information such as Name, Version, Type, Number of Bundles, Number of Components, Date, Size, and Available Versions is displayed.
Cloning bundles
This section describes the process to clone the bundles.
On the DRM home page, select the repository.
Expand the repository list to view the bundles associated with that repository.
Select a bundle and click Clone to clone the bundle.Clone Bundles window is displayed.
Select the repository from the Select Repository drop-down list to clone the bundle.
Click Clone.
Deleting repository
This section describes the process to delete a repository.
On the Dell EMCRepository Manager home page, select a repository by clicking on the checkbox next to the name of therepository.
Click Delete.A message is displayed to confirm the deletion.
Select Delete.NOTE: You also have the option to delete a particular version of the repository. Click on the version of the repository, select one version at a time to delete. Click OK and click Delete.
Working with components
All the DUPs and non-DUPs (such as .exe, .msi, .bin, or any other file formats) files are called components. They are used for updatingthe Basic Input/Output System (BIOS), firmware, drivers on specific platforms, or any other application.
DUP conventions for DRM
DUPs are update packages that help you to keep your system up to date. DUPs are applications that are available in various formats;Windows 32-bit, Windows 64-bit, and Linux (32-bit and 64-bit). In case you are not sure about the type of DUP that you should run onthe system, select 32-bit DUPs since the 32-bit DUP can be applied even for 64 bit operating systems. If you are using a Windows ServerOS that does not support WoW64 (Windows 32-bit on Windows 64-bit) then you must select 64-bit DUPs.
Component properties
This section describes the process to view the properties of components.
On the DRM home page, select the repository that you want to view.
Expand the repository list to view the bundles associated with that repository.
Select a bundle and click to expand the list of components associated with that bundle.The properties of the component is displayed in the Property section.
Downloading components
This section describes the process to download components associated with a bundle.
On the DRM home page, select the repositories that have the components that you want to download.
Expand the repository list to view the bundles associated with that repository.
Select a bundle and click to expand the list of components associated with that bundle.
Select the component and click Download.The Download Components window is displayed.
Navigate to the location to download the component and click Download.NOTE: To download the component to a shared location, enter the IP address of the network share in the addressbar of the Browse window. Log in with the relevant credentials and select the location to download the components.
Copying components
This section describes the process to copy components associated with a bundle.
On the DRM home page, select the repositories that you want to filter.
Expand the repository list to view the bundles associated with that repository.
Select a bundle and click to expand the list of components associated with that bundle.
Select the component and click Copy.The Copy Components window is listed.
Select the repository and then select the bundle you want to copy.The Selected Bundles section has the bundle that you selected earlier.
Click Add to copy the selected bundle.
Importing components
To import components to a repository:
On the DRM home page, select the repository and bundle where you want to import components. Click the Import tab.
Browse the location of the repository that you intend to import the components and click Import.NOTE: To import components from a network shared location, you must log in to the shared location with providingappropriate credentials and select the components to import.The component is successfully imported to the specified repository.
Working with jobs
This section describes the process to work with scheduled jobs in DRM.1. Click on the Dell EMC Repository Manager drop-down menu.2. On the View section, click Jobs.The Jobs page is displayed.You can Edit and Delete the jobs that you create.
Editing jobs
This section describes the process of editing the jobs on the jobs page.1. Click on the Dell EMC Repository Manager drop-down list and click Jobs.The Jobs screen is displayed. The created or scheduled jobs are displayed.2. Select the job you want to edit. Click Edit.3. Edit the preferences and click Save.
Deleting jobs
This section describes the process of deleting the jobs on the jobs page.1. Click on the Dell EMC Repository Manager drop-down list and click Jobs.The Jobs window is displayed. The created or scheduled jobs are displayed.2. Select the job you want to delete and click Delete.A warning message is displayed to confirm the deletion.3. Click Delete to delete the job.
Jobs queue details
The details such as, Job Name, Status, Next Execution Date/Time, Last Execution Date/Time, Affected Repositories, and Log are displayed. The Show Log option is displayed for certain jobs. This option provides more details about the job.
Creating deployment tools
This section describes the process to export the repository through a deployment tool type.
On the DRM home page, select the repositories or bundles for which you want to create the deployment tools.A warning message is displayed if you do not select any repository.
Click Export.The Export Deployment Tools window is displayed.
The repositories that you select are displayed in the Selected Repositories section. Select the required Deployment Tool Type andclick Create. The available options are:• Smart Bootable ISO- Support Linux bundles only.• SUU ISO- Supports SUU as an ISO image file or in an expanded format.• Smart Deployment Script- You can choose the Script Type for Microsoft Windows or Linux operating systems. You can alsospecify the script to execute before or after the deployment script is executed by selecting Pre-Script or Post-Script.• Share- Local storage or network share.NOTE: If a plug-in update is available, a message is displayed. you can Click to Configure to set the plug-in preferences. For more information on configuring plug-in preferences, see Configuring plug-in preferences.
Select the required preference and click Create.NOTE: Dell System Update (DSU) is used in orchestrating the deployment.
Creating smart bootable ISO
This section describes the process to export the repository to a smart bootable ISO.
1. On the DRM home page, select the repositories or bundles for which you want to create the deployment tools.A warning message is displayed if you do not select any repository.2. Click Export.The Export Deployment Tools window is displayed.3. The repositories that you select is displayed in the Selected Repositories section. Select the Smart Bootable ISO option.4. Click Browse to select the location to download the ISO.5. Click Export.
creating SUU ISO
This section describes the process to export the repository to a Dell Server Update Utility (SUU) ISO.
On the DRM home page, select the repositories or bundles for which you want to create the deployment tools.A warning message is displayed if you do not select any repository.
Click Export.
The Export Deployment Tools window is displayed.
The repositories that you select are displayed in the Selected Repositories section. Select SUU ISO option.
Click Browse to select the location to download the ISO.
Click Export.NOTE: If you export or save ISO images in the expanded format, SUU is saved in non-ISO format.
Creating smart deployment script
This section describes the process to export the repository to a smart deployment script.
On the DRM home page, select the repositories or bundles for which you want to create the deployment tools.A warning message is displayed if you do not select any repository.
Click Export.The Export Deployment Tools window is displayed.
The repositories that you select are displayed in the Selected Repositories section. Select the Smart Deployment Script option.
Select the type of script from the Script Type drop-down list. The available options are Windows and Linux.
Specify if the script is to be executed before or after the deployment script. The available options are Pre-script and Post-script.
Click Select to choose the script file.
Click Browse to select the location to download the ISO.
Click Export.
Exporting repository as share
This section describes the process to export the repository to a network shared location.1. On the DRM home page, select the repositories or bundles for which you want to create the deployment tools.A warning message is displayed if you do not select any repository.2. Click Export.The Export Deployment Tools window is displayed.3. The repositories that you select is displayed in the Selected Repositories section. Select the Share option.4. Click Browse to select the location to download the ISO.5. Click Export.
Working with filters
This section describes the process to work with options to filter the repositories based on conditions.
On the DRM home page, select the repositories that you want to filter.
Click the filter logo available above the list of repositories.
Set the preferences to filter the repositories. The available conditions are Criticality and Component Type.
In the Criticality section, select the required preference. The available options are, Urgent, Optional, and Recommended.
In the Component Type section, select the required components.NOTE: You can also search and select the components by entering the keywords of the components. For example,type Fibre in the search bar, and the Fibre Channel component is displayed.
After the preferences are set, click Apply.NOTE: You can also revert to the previous preferences by selecting Reset Default.
Launching support site
This section describes the process of launching the DRM page on the support site.To view the DRM manuals:
Click support.dell.com/manuals.
Click on View Products to view the Dell EMC portfolio.
Click Software and Security.
Click Enterprise Systems Management.
Click Repository Manager.
Select the relevant release and click Manuals & documents.
Save and mail logs
Click Dell EMC Repository Manager drop-down list.
On the Help and Support section, click Save and Mail logs.The Save/Mail Logs window is displayed.
Enter the recipient’s email address to send logs to recipients through email by configuring the email settings. You also have the optionof downloading the logs to a local location or a network shared location.
Command-line interface syntax
The following chapter describes the syntax for the commands that you can use to work in DRM.Table 2. Command-line interface syntax
Commands
Description
drm
Open DRM in a Graphical User Interface (GUI) mode.
Display the details of all the versions associated with the repository.Details such as version, size, and the last date the repository wasmodified. NOTE: The argument format of <reponame> is name or name: version. All associated bundle and respectiveassociated components details are displayed.
Create deployment tools.NOTE: location attribute must be provided in the command. authentication and non-interactive attributes are also mandatory only if the location is a network shared location. NOTE: script-type, prescript, postscript, script authentication must be provided when using a smart script.expand-iso must be provided when using suuiso.
drm –update –plugin=<pluginname1,pluginname2,….>
Update or update plug-in
drm –compare –repository=<reponame:version>
Compare a version of the repository with the base catalog in the database.
drm –update –catalog=<ALL>
Update all catalogs.
drm –logfile=<FilePath>
A download log file with the name provided in <FilePath>.
Frequently asked questions
This section lists some frequently asked questions about DRM.Where is the Dell EMC Repository Manager runtime log located?DRM creates the log file at runtime in the following location:
Windows: C:\ProgramData\Dell\drm\log
Linux: /var/Dell/drm/log
You can also view the logs through Save and Mail Logs option in the Dell EMC drop-down menu.
Can DRM be run through a Proxy Server?Yes, install DRM inside the firewall and connect to a catalog located outside the firewall (downloads.dell.com or a local repository) througha proxy server. You can use the proxy server settings of Internet Explorer. If the proxy settings for Internet Explorer are not working, theproxy can be set in DRM. You can then use Dell Repository Manager to customize the catalog as per the requirement and store thecustomized catalog inside the firewall. For more information on setting proxy, see Configuring Network Settings.
How do I edit the ‘.sh’ file in the Linux deployment script bundle? Is there any recommended tool to edit this file?
Notepad++ editor is recommended for editing the Linux-based file extension on a Microsoft Windows operating system. If you want to edit the extension of the file on a Linux operating system, vi editors is recommended.
I have installed DRM version 3.0 on my system and I am trying to downgrade to one of the previous versions. However, I am not able to proceed further. What do I do now?
Reverting to the previous version of DRM is not supported in the current version of the DRM installer. To install an earlier version of DRM, manually uninstall the latest version through Add/Remove Programs in the Microsoft Windows Control Panel and then run the installer of the desired version.
NOTE: DRM 2.0 and DRM 3.0 can co-exist on the same system.
I am not able to connect DRM to an OpenManageEssentials (OME) instance. How do I troubleshoot this issue?DRM cannot connect to an OME instance if OME is installed on the same system running Microsoft Windows operating system. You canresolve this issue by updating the system policy and enable the NTLM authentication on a different system.
I am facing an access issue in Linux operating system.How do I proceed further?Ensure that you have:
Read and Execution access
Read and Write access to the DRM user in the particular folder including all individual directories where you want to create a
I saved a file in the mapped network location.However, I am not able to access that location.What do I do now?
Ensure that you have privileges to access the location and then login with the appropriate credentials.
I am not able to automatically discover theMicrosoft Exchange Web Service URL when trying to configure the email notifications. Is there any other option to discover the URL apart from updating it manually?
No. In DRM 3.0, the auto-discovery of the Microsoft Exchange Web Server URL is not supported. You have to update the URL manually.
I get a message “GLX version 1.2 or higher is required” when I try to open a Linux terminal window. This message is observed in SUSE Linux 11 and 12.This is a warning message and does not affect the functionality of the product.
I am not able to create an inventory repository usinga specific catalog and inventory file throughthe command-line interface. How do I proceed?Ensure that the catalog and inventory are available in the same network location and then create a repository.