######################################################################
Dell OpenManage(TM) Server Agent Sync Utility Version 1.0
######################################################################
======================================================================
Overview
======================================================================
The Dell OpenManage Server Agent Sync Users (OMSASync) Utility reads the
user entries from a Dell OpenManage Remote Assistant Card (DRAC) II and
copies the user entries (both user name and password for each entry)
into the Dell OpenManage Server Agent user database.
If you Use the RacConf utility to add user entries to the DRAC II, you then
run the OMSASync Utility to copy the new user entries from the DRAC II into
the OMSA user database. See the "Dell OpenManage Remote Assistant Card
User's Guide" for details on using the RacConf utility to add user
entries to the DRAC II, and to view and manage DRAC II user entries.
You can view Server Agent user entries by using the Dell OpenManage IT
Assistant application. See the Server Agent and IT Assistant
documentation for details on viewing and managing Server Agent user
entries. You can find these documents on the "Dell Online Documentation"
CD or at http://support.dell.com.
The following steps summarize a typical scenario:
1. Add user entries to the DRAC II using the RacConf utility.
2. Run the OMSASync Utility to copy the DRAC II user entries from the
DRAC II to the Server Agent user database.
3. View (and manage) Server Agent user entries using IT Assistant.
----------------------------------------------------------------------
OMSASync Utility Requirements
----------------------------------------------------------------------
To operate properly, the OMSASync Utility requires installation of the
following components:
* DRAC II hardware
* DRAC II software version 2.3.1 or later
* Server Agent software version 4.0 or later
You can copy the OMSASync Utility program to a system that might not
have all of the required components, but the utility is not usable
without them.
======================================================================
Using the Racconf Utility Under Microsoft(R) Windows(R) 2000
and Windows NT(R)
======================================================================
----------------------------------------------------------------------
Installing the OMSASync Utility
----------------------------------------------------------------------
NOTE: This section describes a process of "installing" the OMSASync
Utility program by manually copying the file "OMSASync.exe" to a
system. The OMSASync Utility is typically installed with
the installation of DRAC II software version 2.3.1 or later. A
version of "OMSASync.exe" might already exist on a system.
Installing OMSASync:
1. Log in as "administrator."
2. Ensure that the DRAC II Agent software is installed.
A simple way to check for the DRAC II Agent software is to
search the system for the file "RacConf.exe." If it exists, it
will most likely be in a directory such as:
c:\Program Files\Dell\OpenManage\Drac\server
If "RacConf.exe" exists on the system, then proceed to Step 3.
If "RacConf.exe" does not exist on the system, then install the
DRAC II Agent software.
3. Check for an existing version of the file "OMSASync.exe"
on the system.
If the file exists, it will most likely be in a directory such as:
c:\Program Files\dell\OpenManage\Drac\server
If a copy of "OMSASync.exe" already exists on the system, proceed
to Step 4.
If a copy of "OMSASync.exe" does not exist on the system, you
must copy the "OMSASync.exe" file in this package to the
directory where the DRAC II Agent software resides. You are
finished. You do not need to restart the system.
4. Compare versions.
Check the "Properties" of both "OMSASync.exe" files. For each
file:
a. Right-click the file.
b. Click "Properties."
c. Click the "Version" tab.
The "File version:" will display similar to the following:
"n.n.mmmm.0"
where "n.n" is the version of the file and "mmmm" is the build
number of the file.
If the version (including the build number) of the file from this
package is later than the version of the file that currently
exists on the system, copy the file from the package over the
existing file. You are finished. You do not need to restart the
system.
Otherwise, if the version of the file from this package is not
later than the version of the file that currently exists on the
system, then do not copy the file from the package over the
existing file. You are finished. You do not need to restart the
system.
----------------------------------------------------------------------
Uninstalling the OMSASync Utility
----------------------------------------------------------------------
If the "OMSASync.exe" file still exists on the system after you
uninstall the DRAC II Agent software, manually delete the
"OMSASync.exe" file.
----------------------------------------------------------------------
Executing the OMSASync Utility
----------------------------------------------------------------------
1. Log in as "administrator."
2. Open a Windows "Command Prompt" window.
3. Get usage and help for utility commands by typing the following
at the command prompt:
omsasync /h
If your "PATH" environment variable does not include the
directory where the "OMSASync.exe" file is installed, then you
must either add the appropriate directory to your "PATH,"
or type in the entire directory at the command prompt. For
example, type the following (including the quotes) at the command
prompt:
"c:\Program Files\dell\OpenManage\Drac\server\omsasync" /h
4. Execute the OMSASync Utility by typing the following at the
command prompt:
omsasync
By default, the verbose level is set to "0" and you will not see
any output.
5. Execute the OMSASync Utility with a verbose level of "2" by typing
the following at the command prompt:
omsasync -v2
You should see output similar to the following:
Dell OpenManage Server Agent Sync Users (OMSASync) Utility
Version 1.0 (BLD_zzzz)
Added the following DRAC II user(s) to the OMSA user database:
<username0>
<username1>
...
OMSASync program executed successfully.
======================================================================
Using the Racconf Utility Under Red Hat Linux
======================================================================
----------------------------------------------------------------------
Installing the OMSASync Utility
----------------------------------------------------------------------
1. Log in as "root".
This login is a requirement for Red Hat Package Manager (RPM)
installation. The installation uses an RPM file. Go to
http://rpmdp.org/rpmbook/ for information on RPM files and how to
use them.
2. Install or update the OMSASync Utility RPM by typing the following
at the command prompt:
rpm -U dellomsa-omsasync-1.0-zzzz.i386.rpm
You do not need to restart the system.
3. To verify that the OMSASync Utility is installed, type the following
at the command prompt:
rpm -qa | grep -i omsasync
You should see output similar to the following:
dellomsa-omsasync-1.0-zzzz
----------------------------------------------------------------------
Uninstalling the OMSASync Utility
----------------------------------------------------------------------
1. Log in as "root".
This login is a requirement for RPM installation. The installation
uses an RPM file. Go to http://rpmdp.org/rpmbook/ for information
on RPM files and how to use them.
2. Uninstall the OMSASync Utility RPM by typing the following at
the command prompt:
rpm -e dellomsa-omsasync-1.0-zzzz
You should not see any output. Do not restart the system.
----------------------------------------------------------------------
Executing the OMSASync Utility
----------------------------------------------------------------------
1. Log in as "root".
2. Get usage and help for utility commands by typing the following
at the command prompt:
/usr/sbin/omsasync -h
If your "PATH" environment variable includes the directory
/user/sbin, you can type only the following:
omsasync -h
3. Execute the OMSASync Utility by typing the following at the
command prompt:
/usr/sbin/omsasync
If your "PATH" environment variable includes the directory
/user/sbin, you can type only the following:
omsasync
By default, the verbose level is set to "0" and you will not see
any output.
4. Execute the OMSASync Utility with a verbose level of "2" by typing
the following at the command prompt:
/usr/sbin/omsasync -v2
If your "PATH" environment variable includes the directory
/user/sbin, you can type only the following:
omsasync -v2
You should see output similar to the following:
Dell OpenManage Server Agent Sync Users (OMSASync) Utility
Version 1.0 (BLD_zzzz)
Added the following DRAC II user(s) to the OMSA user database:
<username0>
<username1>
...
OMSASync program executed successfully.
======================================================================
Using the Racconf Utility Under Novell(R) NetWare(R)
======================================================================
----------------------------------------------------------------------
Installing the OMSASync Utility
----------------------------------------------------------------------
1. Ensure that the the DRAC II library and DRAC II Agent software
is installed.
a. Perform the following steps to search for the DRAC II library:
- Type monitor at the NetWare prompt.
- Select "Loaded Modules" under "Available Options."
- Look under "Loaded NLMs" for "dra.nlm".
If "dra.nlm" does not exist, there was an error installing the DRAC II
software.
b. Perform the following steps to search for the DRAC II Agent software:
- Type "down" to go to the MS-DOS(R) prompt (c:\nwserver).
- At the prompt, search the system for the "RacConf.exe" file.
If the file exists, it will most likely be in a directory such as:
c:\nwserver\ or c:\
If "dra.nlm" and "RacConf.exe" exist on the system, then proceed
to Step 2. If not, load the DRAC II Agent before you load
"OMSASync.nlm" to your system.
2. Type "server" at the MSDOS prompt to go to the NetWare command prompt.
3. Type:
copy [OMSASync_path_in_package]\omsasync.nlm [server\]sys:\system\dell\omsasync.nlm
where OMSASync_path_in_package is the path where the "omsasync.nlm" file
exists in the package.
You are finished. You do not need to restart the system.
----------------------------------------------------------------------
Executing the OMSASync Utility
----------------------------------------------------------------------
1. Execute the OMSASync Utility by typing the following at the
command prompt:
load omsasync.nlm
By default, the verbose level is set to "0" and you will not see
any output.
2. Execute the OMSASync Utility with a verbose level of "2" by typing
the following at the command prompt:
omsasync -v2
You should see output similar to the following:
Dell OpenManage Server Agent Sync Users (OMSASync) Utility
Version 1.0 (BLD_zzzz)
Added the following DRAC II user(s) to the OMSA user database:
<username0>
<username1>
...
OMSASync program executed successfully.
======================================================================
Additional Information
======================================================================
----------------------------------------------------------------------
OMSASync Utility Messages
----------------------------------------------------------------------
* If the verbose level is set to level "0", OMSASync does not
display any messages.
* If the verbose level is set to level "1", OMSASync displays only
error messages.
* If the verbose level is set to level "2", OMSASync displays:
- A program header
- Any user names that it copies
- A status message (which is either a message indicating
program success or describing an error)
----------------------------------------------------------------------
OMSASync Utility Return Codes
----------------------------------------------------------------------
Regardless of the verbose level, the OMSASync Utility returns one
of the following return codes, depending on the execution results:
0 - If the utility executed successfully
Nonzero - If any type of error occurred
----------------------------------------------------------------------
Information in this document is subject to change without notice.
(C) 2001 Dell Computer Corporation. All rights reserved.
Trademarks used in this text: "Dell" and "Dell OpenManage" are
trademarks of Dell Computer Corporation; "Microsoft," "Windows," and
"Windows NT" are registered trademarks of Microsoft Corporation;
"Novell" and "NetWare" are registered trademarks of Novell, Inc.
Other trademarks and trade names may be used in this document to refer
to either the entities claiming the marks and names or their products.
Dell Computer Corporation disclaims any proprietary interest in
trademarks and trade names other than its own.
September 2001
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.