Dell EMC OpenManage Installation Guide — Microsoft Windows Version 10.1.0.0 June 2021 Rev.
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. © 2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction................................................................................................................. 5 OMSA Customer Survey....................................................................................................................................................5 What is new in this release................................................................................................................................................
Chapter 4: Installing Managed System Software On Microsoft Windows Server and Microsoft Hyper-V Server......................................................................................................................... 31 Running Prerequisite Checker In CLI Mode.................................................................................................................31 Installing Managed System Software In CLI Mode...................................................................................
1 Introduction This topic provides information about: ● Installing Server Administrator on managed systems. ● Installing and using the Remote Enablement feature. ● Managing remote systems using Server Administrator Web Server. ● Configuring the system before and during a deployment or upgrade. NOTE: If you are installing management station and managed system software on the same system, install identical software versions to avoid system conflicts.
Software Availability The Server Administrator software can be installed from: ● Systems Management Tools and Documentation software ● Support site—For more information, see www.dell.com/Support/Home. Systems Management Software Systems management software is a suite of applications that enables you to manage the systems by monitoring, notification, and remote access. Systems management software comprises of the ISO Dell EMC Systems Management Tools and Documentation image.
Table 1. Managed System Software Components (continued) Component What is installed Deployment Scenario Systems to install on Management User’s Guide in the docs directory. Command Line Interface (Management Interface) Command Line Interface of Server Instrumentation Install to provide local and remote system management solutions to manage Server and Storage instrumentation data using command-line interfaces. Supported systems.
Table 1. Managed System Software Components (continued) Component What is installed Deployment Scenario Systems to install on information about Broadcom NICs. installed and which are running on Windows operating system.
● The Dell EMC OpenManage Systems Management Tools and Documentation software contains readme files for applications found on the media. NOTE: If the product does not perform as expected or you do not understand a procedure described in this guide, see Getting Help in the system’s Hardware Owner’s Manual.
2 Preinstallation Setup Ensure that you perform the following before installing Server Administrator: ● ● ● ● Read the installation instructions for the operating system. Read the Installation Requirements to ensure that the system meets or exceeds the minimum requirements. Read the applicable readme files and the Dell EMC OpenManage Systems Software Support Matrix. Close all applications running on the system before installing the Server Administrator applications.
Table 2. Return Codes While Running the Prerequisite Checker Silently (continued) Return Code Description —2 The operating system is not supported. The prerequisite checker does not run. —3 The user does not have Administrator privileges. The prerequisite checker does not run. —4 Not an implemented return code. —5 The prerequisite checker does not run. The user failed to change the working directory to %TEMP%. —6 The destination directory does not exist. The prerequisite checker does not run.
NOTE: Prerequisites specific to an operating system are listed as part of the installation procedures. Supported Operating Systems And Web Browsers For information about supported operating systems and web browsers, see the Dell EMC OpenManage Systems Software Support Matrix at www.dell.com/OpenManageManuals . NOTE: Ensure that the web browser is configured to bypass the proxy server for local addresses.
Supported Systems Management Protocol Standards Install a supported systems management protocol on the managed system before installing the management station or managed system software. On supported Windows operating system, systems management software supports: ● Common Information Model (CIM)/Windows Management Instrumentation (WMI) ● Simple Network Management Protocol (SNMP) Install the SNMP package provided with the operating system.
Once activated, the log files are generated in the %TEMP% directory. Some log files generated in this directory are: ● Managed System Installation ○ SysMgmt_.log These log files are created by default if the prerequisite checker user interface (UI) is running. Microsoft Active Directory If you use Active Directory service software, you can configure it to control access to the network. The Active Directory database is modified to support remote management authentication and authorization.
Best Practices For X.509 Certificate Management For the security of the system while using server administrator, ensure the following: Unique host name All systems that have Server Administrator installed should have unique host names. Change 'localhost' to unique For systems with host name set to localhost change the host name to a unique host name.
9. Right-click Personal, select All tasks > Request New Certificate. 10. Click Next. 11. Select the appropriate certificate type, Mostly (Computer), and then click Enroll. 12. Click Finish. Creating The HTTPS Listener With The Valid CA Signed Certificate Run the installer and click the link on the prerequisite checker to create the HTTPS listener. NOTE: The HTTP listener is enabled by default and listens at port 80.
4. Select Windows Remote Management check box. If you do not see the check box, click Add Program to add Windows Remote Management. Configuring The Envelope Size For WinRM To configure the envelope size for WinRM: NOTE: On WinRM version 2.0, enable the compatibility mode for WinRM version 2.0 to use port 443. WinRM version 2.0 uses port 5986 by default. To enable the compatibility mode, type the following command: winrm s winrm/config/Service @{EnableCompatibilityHttpsListener="true"} 1.
3 Installing Managed System Software On Microsoft Windows Operating Systems On Microsoft Windows, an autorun utility is displayed when you insert the Dell EMC OpenManage Systems Management Tools and Documentation software. This utility allows you to choose the systems management software you want to install on the system. If the autorun program does not start automatically, use the autorun program from the DVD root or the setup program in the srvadmin\windows directory on the Dell EMC OpenManage Systems Man
Table 4. Deployment Scenarios (continued) You want to Select For systems running on Microsoft Windows, Remote Enablement is under the Server Instrumentation option. You must then install the Server Administrator Web Server on the remote system. View the status of local and remote storage attached to a managed system and obtain storage management information in an integrated graphical view. Storage Management.
Typical Installation When you access the Server Administrator installation from the prerequisite checker and select the Typical Setup option, the setup program installs the following managed system software features: ● ● ● ● ● ● ● ● ● Server Administrator Web Server Server Instrumentation Storage Management Command Line Interface WMI Operating System Logging DRAC Command Line Tools Intel SNMP Agent Broadcom SNMP Agent During a Typical installation, individual management station services that do not meet t
A selected feature has a hard drive icon depicted next to it. A feature that is not selected has a red X depicted next to it. By default, if the prerequisite checker finds a software feature with no supporting hardware, the prerequisite checker automatically ignores the feature. To accept the default directory path to install managed system software, click Next. Else, click Change and browse to the directory where you want to install the managed system software, and click OK. 10.
NOTE: After an unattended installation is complete, to use the command line interface (CLI) feature of Server Administrator, you must open a new console window and execute the CLI commands from there. Executing CLI commands from the same console window in which Server Administrator was installed does not work. You can make the DVD image available to the remote system by either distributing the entire contents of the media, or by mapping a drive from the target system to the location of the DVD image.
Specifying Log File Locations For managed system MSI installation, run the following command to perform an unattended installation while specifying the log file location msiexec.exe /i .msi /l*v "C:\openmanage\logs\SysMgmt.log" Unattended Installation Features Unattended installation provides the following features: ● A set of optional command line settings to customize an unattended installation. ● Customization parameters to designate specific software features for installation.
Table 5. Command Line Settings for MSI Installer (continued) Setting Result /fa – This option forces all files to be reinstalled. /fu – This option rewrites all required user-specific registry entries. /fm – This option rewrites all required system-specific registry entries. /fs – This option overwrites all existing shortcuts. /fv – This option runs from the source and re-caches the local package. Do not use this reinstall option for the first installation of an application or feature.
Table 6.
or uninstall. This operation includes restoration of deleted or overwritten files, registry keys, and other resources. Windows temporarily saves all files that it deletes or overwrites during the course of an installation or removal, so that they can be restored if necessary, which is a type of rollback. After a successful installation, Windows deletes all of the temporary backup files.
Upgrade For an unattended upgrade, the msiexec.exe /i SysMgmtx64.msi /qn command accesses the DVD to accept the software license agreement and upgrades all the required Server Administrator features on selected remote systems. All major user settings are retained during an unattended upgrade. 1. Mount the Dell EMC OpenManage Systems Management Tools and Documentation image onto the system's DVD drive. The autorun menu is displayed. 2. Select Server Administrator and click Install.
Repair If you want to repair an installed Server Administrator component that is damaged: 1. Navigate to the Windows Control Panel. 2. Click Add/Remove Programs. 3. Click Server Administrator and click Change. The Welcome to the Install Wizard for Server Administrator dialog box is displayed. 4. Click Next. The Program Maintenance dialog box is displayed. 5. Select the Repair option and click Next. The Ready to Repair the Program dialog box is displayed. 6.
Uninstalling Managed System Software Features Using The Operating System Perform the following tasks to uninstall managed system software features using the operating system. 1. Navigate to the Windows Control Panel. 2. Click Add/Remove Programs. 3. Click Server Administrator, and then click Remove. The Add or Remove Programs dialog box is displayed. 4. Click Yes to confirm uninstallation of Server Administrator.
If there is a previous set of exported files, they are overwritten. The default folder preferences are always the last known set of preferences.
4 Installing Managed System Software On Microsoft Windows Server and Microsoft Hyper-V Server The Server Core installation option of the Microsoft Windows Server and Hyper-V Server operating system provides a minimal environment for running specific server roles that reduce the maintenance and management requirements and the attack surface for those server roles. A Windows Server or Hyper-V Server installation installs only a subset of the binaries that are required by the supported server roles.
Uninstalling Systems Management Software To uninstall managed system software, type msiexec /x SysMgmtx64.msi at the command prompt.
5 Using Microsoft Active Directory If you use Active Directory service software, configure it to control access to the network. The Active Directory database is modified to support remote management authentication and authorization. Server Administrator, as well as Integrated Remote Access Controllers (iDRAC), Remote Access Controllers (RAC), can now interface with Active Directory. With this tool, you can add and control users and privileges from one central database.
Figure 1. Typical Setup for Active Directory Objects In addition, you can set up Active Directory objects in a single domain or in multiple domains. Setting up objects in a single domain does not vary, whether you are setting up RAC, or Server Administrator objects. When multiple domains are involved, however, there are some differences. The following figure shows the set up of the Active Directory objects in a single domain.
Setting Up Objects In A Single Domain To set up the objects in a single domain scenario, perform the following tasks: 1. Create two Association Objects. 2. Create two RAC Product Objects, RAC1 and RAC2, to represent the two DRAC 4 cards. 3. Create two Privilege Objects, Priv1 and Priv2, in which Priv1 has all privileges (administrator) and Priv2 has login privileges. 4. Group User1 and User2 into Group1. 5.
Setting Up Server Administrator Active Directory Objects In Multiple Domains For Server Administrator, the users in a single Association can be in separate domains and need not be in a Universal group. The following is a very similar example to show how Server Administrator systems in separate domains affect the setup of directory objects. Instead of RAC devices, you will have two systems running Server Administrator (Server Administrator Products sys1 and sys2). sys1 and sys2 are in different domains.
● ● ● ● Extending the Active Directory Schema Installing the Extension to the Active Directory Users and Computers Snap-In Adding Users and Privileges to Active Directory Configuring the Systems or Devices Configuring The Active Directory Product Name To configure the Active Directory product name: 1. Locate the omsaoem.ini file in the installation directory. 2. Edit the file to add the line adproductname=text, where text is the name of the product object that you created in Active Directory.
Using The Dell Schema Extender To use the Dell Schema Extender perform the following tasks: CAUTION: The Dell Schema Extender uses the SchemaExtenderOem.ini file. To ensure that the Dell Schema Extender utility functions properly, do not modify the name or the contents of this file. 1. Click Next on the Welcome screen. 2. Read the warning and click Next. 3. Select Use Current Log In Credentials or enter a user name and password with schema administrator rights. 4. Click Next to run the Dell Schema Extender.
Table 12. dellProduct Class Elements Description OID 1.2.840.113556.1.8000.1280.1.1.1.5 Description This is the main class from which all the products are derived. Class Type Structural Class SuperClasses Computer Attributes dellAssociationMembers Table 13. dellOmsa2AuxClass Class Elements Description OID 1.2.840.113556.1.8000.1280.1.2.1.1 Description This class is used to define the privileges (Authorization Rights) for Server Administrator.
Table 15. General Attributes Added to the Active Directory Schema (continued) Attribute Name/Description Assigned OID/Syntax Object Identifier Single Valued Link ID: 12071 Table 16. Server Administrator-Specific Attributes Added to the Active Directory Schema Attribute Name/Description Assigned OID/Syntax Object Identifier Single Valued dellOMSAIsReadOnlyUser 1.2.840.113556.1.8000.1280.1.2.2.1 TRUE TRUE if the User has Read-Only rights in Server Administrator Boolean (LDAPTYPE_BOOLEAN 1.3.6.1.4.
5. Select the Active Directory Users and Computers snap-in and click Add. 6. Click Close and click OK. Adding Users And Privileges To Active Directory The extended Active Directory Users and Computers snap-in allows you to add DRAC and Server Administrator users and privileges by creating RAC, Association, and Privilege objects. To add an object, perform the steps in the applicable subsection.
Adding Objects To An Association Object By using the Association Object Properties window, you can associate users or user groups, privilege objects, systems, RAC devices, and system or device groups. NOTE: RAC users must use Universal Groups to span domains with their users or RAC objects. You can add groups of Users and Products. You can create related groups in the same way that you created other groups. To Add Users Or User Groups 1. Right-click the Association Object and select Properties. 2.
The following table shows the valid parameters for the command. Table 17. Active Directory Service Configuration Parameters name=value pair Description prodname= Specifies the software product to which you want to apply the Active Directory configuration changes. Prodname refers to the name of the product defined in omprv64.ini. For Server Administrator, it is omsa. enable= true: Enables Active Directory service authentication support.
6 Frequently Asked Questions What ports do systems management applications use? The Server Administrator uses the default port 1311. These ports are configurable. For port information of a particular component, see the User Guide of that respective component.
What do I do when the creation of WinRM listener fails with the following error message? The CertificateThumbprint property must be empty when the SSL configuration will be shared with another service This error occurs when the Internet Information Server (IIS) is already installed and configured for HTTPS communication. Details about coexistence of IIS and WinRM is available at technet.microsoft.com/en-us/library/cc782312.aspx.
When I run systems management Install, I see unreadable characters on the Prerequisite check information screen. When you run systems management Install in English, German, French, or Spanish and get unreadable characters on the Prerequisite Check Information screen, ensure that the browser encoding has the default character set. Resetting the browser encoding to use the default character set resolves the problem.
In the Prerequisite Checker screen, I get the following message. What can I do to resolve this problem? An error occurred while attempting to execute a Visual Basic Script. Please confirm that Visual Basic files are installed correctly. This error occurs when the prerequisite checker calls the systems management script, vbstest.vbs (a Visual Basic script), to verify the installation environment, and the script fails. The possible causes are: ● Incorrect Internet Explorer Security Settings.
What are the names of all the systems management features under Windows? The following table lists the names of all systems management features and their corresponding names in Windows. Table 18.