26
Dell Client Configuration Toolkit Version 2.1 User’s Guide

Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

  • Upload
    others

  • View
    24

  • Download
    2

Embed Size (px)

Citation preview

Page 1: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Dell Client ConfigurationToolkit Version 2.1

User’s Guide

Page 2: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of

your computer.

CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed.

A WARNING indicates a potential for property damage, personal injury, or death.

____________________

Information in this publication is subject to change without notice.© 2012 Dell Inc. All rights reserved.

Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.

Trademarks used in this text: Dell™, the Dell logo, Dell Precision™ , OptiPlex™, Latitude™, PowerEdge™, PowerVault™, PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™ and Vostro™ are trademarks of Dell Inc. Intel®, Pentium®, Xeon®, Core® and Celeron® are registered trademarks of Intel Corporation in the U.S. and other countries. AMD® is a registered trademark and AMD Opteron™, AMD Phenom™ and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc. Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista® and Active Directory® are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat® and Red Hat® Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® and SUSE® are registered trademarks of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States and/or other countries. VMware®, Virtual SMP®, vMotion®, vCenter® and vSphere® are registered trademarks or trademarks of VMware, Inc. in the United States or other countries. IBM® is a registered trademark of International Business Machines Corporation.

Other trademarks and trade names may be used in this publication to refer to either the entities claiming the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own.

2012 - 05

Rev. A00

Page 3: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Contents

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . 5

What’s New in This Release . . . . . . . . . . . . . . . 5

Supported Systems and Operating Systems . . . . . . . 6

Other Documents You May Need . . . . . . . . . . . . . 6

Contacting Dell . . . . . . . . . . . . . . . . . . . . . . 7

2 Using CCTK GUI . . . . . . . . . . . . . . . . . . . . . 9

Accessing CCTK . . . . . . . . . . . . . . . . . . . . . . 9

Files and Folders of CCTK . . . . . . . . . . . . . . . . . 9

Launching the CCTK GUI . . . . . . . . . . . . . . . . 10

Creating a BIOS Package Using GUI . . . . . . . . . . 10

Create Configuration Screen . . . . . . . . . . . . 11

Configuring Setup and System Passwords . . . . 13

Clearing Setup and System Passwords . . . . . . 14

BIOS Setup or System Password Dialog box . . . 14

Password Protection Dialog box . . . . . . . . . . 14

Configuring Auto On Option . . . . . . . . . . . . 15

Configuring Boot Order . . . . . . . . . . . . . . 15

Validating the BIOS Options . . . . . . . . . . . . . . 17

Validating a Multi-platform File or Saved File . . . 17

Validating a Host System File . . . . . . . . . . . 18

Contents 3

Page 4: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Exporting the BIOS Configuration . . . . . . . . . . . . 18

Exporting the Configuration Without Setting Values . . . . . . . . . . . . . . . . . . . 19

Applying the Configured Files . . . . . . . . . . . . . . 19

Applying a .ini or .cctk File . . . . . . . . . . . . . 19

Applying a Shell Script on Linux Systems . . . . . 19

Applying a SCE File . . . . . . . . . . . . . . . . . 19

Reviewing History . . . . . . . . . . . . . . . . . . . . 21

Viewing a Log File . . . . . . . . . . . . . . . . . 21

Deleting Log Details . . . . . . . . . . . . . . . . 21

3 Troubleshooting CCTK . . . . . . . . . . . . . . . 23

Running CCTK Displays Error Messages . . . . . . . . 23

Running CCTK on 32-bit and 64-bit Supported System . . . . . . . . . . . . . . . . . . . . 23

Running CCTK on Windows Vista or Windows 7 When User Account Control is Enabled . . . . . . . . 23

Running CCTK on Linux . . . . . . . . . . . . . . . . . 24

TPM Activation . . . . . . . . . . . . . . . . . . . . . 24

SCE Failing to Run on Windows Pre-installation (Windows PE) Environment . . . . . . 24

4 Contents

Page 5: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

IntroductionDell Client Configuration Toolkit (CCTK) is a packaged software that provides configuration capability to Dell client systems such as OptiPlex, Latitude, and Dell Precision workstation. You can configure the client systems using a Graphical User Interface (GUI) or a Command Line Interface (CLI.) For more information on CLI, see Dell Client Configuration Toolkit Command Line Interface Reference Guide. You can use CCTK in Red Hat Enterprise Linux (RHEL) environments and Microsoft Windows Pre-installation Environment (Windows PE), and on the Microsoft Windows XP, Windows Vista, and Windows 7 operating systems.

What’s New in This ReleaseThe new features for this release include:

• Support for following platforms:

– Dell Latitude systems: E5430, E5530, E6430 ATG, E6430, E6530, E6330, and E6230

– Dell Precision workstations: M4700, M6700, and T1650

– Dell OptiPlex systems: 3010, CORE 9010, AIO 9010, and 7010

• Support for the following operating systems

– Windows 7 SP1 (32-bit and 64-bit)

– Windows PE 3.1 (32-bit and 64-bit)

• Support for the following BIOS options:

– chassisintrustatus

– fanctrlovrd

– fanspeed

– multidisplay

– pcibuscount

– sfuenabled

– stealthmode

Introduction 5

Page 6: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

– ownerpwd

– sysdefault

– primarybatterycfg

– batteryslicecfg

– modulebaybatterycfg

NOTE: The Battery Management options are BIOS dependent. Upgrade the BIOS to the appropriate version for configuring the Battery Management options.

• Support for the following features:

– Additional argument, selectdays, for the autoon option to automatically turn on the system on specified days.

– Tooltip for GUI elements.

– CLI help displays a ’+’ symbol for the arguments of an option that is supported on the system.

– 64-bit Red Hat Package Managers (RPMs) on RHEL 5 and RHEL 6.

– /e option to extract Self-Contained Executable (SCE.)

– /l option to provide a valid path for creating the SCE log file.

– /nolog option to prevent generation of log file in read-only location.

Supported Systems and Operating SystemsFor the list of Dell client systems and operating systems, see the readme.txt available in the CCTK installation files or at support.dell.com/manuals.

Other Documents You May NeedIn addition to this guide, you can access the following guides available at support.dell.com/manuals. On the Manuals page, click SoftwareSystems Management. Click on the appropriate product link on the right-side to access the documents.

• The Dell Client Configuration Toolkit Installation Guide provides information about installing CCTK on supported Dell client systems. The guide is available as part of CCTK download.

6 Introduction

Page 7: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

• The Dell Client Configuration Toolkit Command Line Interface Reference Guide provides information about configuring the BIOS options on supported Dell client systems.

• The Glossary provides information about the terms used in this document.

Additionally, the readme.txt file, which is available as part of CCTK download and at support.dell.com/manuals, provides the latest available information for the installation and operation of CCTK.

Contacting Dell NOTE: If you do not have an active Internet connection, you can find

contact information on your purchase invoice, packing slip, bill, or Dell product catalog.

Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues:

1 Visit support.dell.com.

2 Select your support category.

3 If you are not a U.S customer, select your country code at the bottom of the page, or select All to see more choices.

4 Select the appropriate service or support link based on your need.

Introduction 7

Page 8: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

8 Introduction

Page 9: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

2Using CCTK GUIDell Client Configuration Toolkit Graphical User Interface (CCTK GUI) displays all Basic Input/Output System (BIOS) configurations supported by CCTK. Using GUI, you can do the following:

• Create BIOS configuration for Dell client systems.

• Validate the BIOS configuration against the BIOS configuration of the host system.

• Export the customized BIOS configurations as a configuration file (.ini/.cctk), Self-Contained Executable (SCE), shell script, or report.

NOTE: To apply the configuration using Command Line Interface (CLI), run the required file (.ini or .cctk or sce.)

See Also:

• Creating a BIOS Package Using GUI

• Validating the BIOS Options

• Exporting the BIOS Configuration

Accessing CCTK To access CCTK from a Windows system, click StartProgramsDellCCTK.

To access CCTK from a Linux system, navigate to /opt/dell/toolkit/bin directory.

Files and Folders of CCTKThe following table displays the files and folders of CCTK on a Windows system.

Files/Folders Description

CCTK Command Prompt Allows access to the CCTK command prompt.

CCTK Configuration Wizard Allows access to the CCTK GUI.

Using CCTK GUI 9

Page 10: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Launching the CCTK GUICCTK GUI is supported only on systems running the Microsoft Windows operating system.

To launch the GUI from a Windows system:

• Click Start Programs Dell CCTK CCTK Configuration Wizard or

• Double-click Dell CCTK Configuration Wizard on the desktop.

NOTE: CCTK GUI is not supported on the Windows PE or Linux systems.

Creating a BIOS Package Using GUIUsing CCTK GUI, you can create a BIOS package containing valid settings to apply on the target client systems.

To create a BIOS package:

1 Launch the wizard.

The Client Configuration Toolkit HOME page is displayed.

2 Click Create Package.

The Client Configuration Toolkit CREATE page is displayed with the following configuration options:

• Multi-platform File — Click to view the BIOS settings that are supported on all possible client systems. You can configure, validate, and export the settings as .ini, .cctk, .exe, shell script, or .html file.

CCTK WINPE Allows access to the winpe scripts to create a bootable image. For more details, see the Dell Client Configuration Toolkit Installation Guide.

Uninstall Uninstalls CCTK.

User’s Guide Online Provides access to the CCTK online documentation.

Files/Folders Description

10 Using CCTK GUI

Page 11: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

• This System’s File — Click to view the BIOS settings of the host system. You can configure, validate, and export the settings as .ini, .cctk, .exe, or .html file. The file displays the supported and unsupported BIOS options for the system.

• A Saved File — Click to import a saved configuration file. You can configure, validate, and export the settings as .ini, .cctk, .exe, shell script, or .html file.

NOTE: If you select A Saved File, then browse and select the required file.

3 On the CREATE page, click the required option and click Next.

The Create Configuration screen is displayed.

4 On the Create Configuration screen, click Edit or double-click the table.

5 From the Value to Set drop-down list box, select the values of the required option.

The Apply Settings check box of the edited options are displayed as selected.

6 Click the required Export option to export the edited options.

NOTE: If you do not want to export an option, then clear the Apply Settings check box.

See Also:

• Launching the CCTK GUI

• Create Configuration Screen

• Exporting the BIOS Configuration

• Configuring Auto On Option

• Configuring Boot Order

Create Configuration ScreenYou can customize the BIOS settings and create a configuration package using the Create Configuration screen. The following table displays the available options on the Create Configuration screen.

Using CCTK GUI 11

Page 12: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Options Description

Change Click to change the selected configuration and load a new configuration. When you click Change to load a new configuration, Dismiss is displayed on the screen. You can click Dismiss to return to the previous configuration.

NOTE: If you try to load a new configuration without exporting the configured BIOS options, then a dialog box is displayed. Click Discard Changes to discard the configured values or click Cancel to continue with the same configuration.

Edit Click to edit the loaded configuration.

To Advanced view Click to view the configuration details such as command line options, possible values that you can set for the option, current value of the option, check box to apply the settings, and description of the option.

NOTE: You can view the current value of an option only if you have loaded the settings of the host system.

To Basic view Click to view the configuration details such as category to which the option belongs, name of the option, possible values that you can set for the option, current value of the option, check box to apply the settings, and description of the option.

NOTE: You can view the current value of an option only if you have loaded the settings of the host system.

Validate Click to validate the loaded configuration against the configuration of the host system.

Search Search a text in the table. Type the text in the text box and the first occurrence of the text in the table is highlighted.

Category Click to select the required categories from the drop-down list box.

NOTE: You can view this option only in Basic View.

Name Displays the name of the options.

NOTE: You can view this option only in Basic View.

Value to set Displays the value of the option. Double-click the row or click Edit to change the values.

12 Using CCTK GUI

Page 13: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

See Also:

Validating the BIOS Options

Configuring Setup and System PasswordsYou can set or change the setup password (setuppwd) and the system password (syspwd.)

To edit the setup or system password:

1 In the Edit mode, click the Value to Set text box of the required option.

The corresponding password dialog box is displayed.

NOTE: To display the password as clear text, select Display password in clear text. If you select Display password in clear text, then the Confirm Password text box is not displayed.

Type the password in the Password textbox.

NOTE: The password must contain minimum four characters.

2 Type the same password in the Confirm Password textbox to confirm the password.

If both the entries match, then a green check mark is displayed next to the Confirm Password text box, else a red X mark is displayed.

Present Value Displays the current value of the option.

NOTE: You can view this option only if you have loaded the settings of the host system.

Apply settings Select the check box to export the option. By default, all the options having a value in the Value to set column are selected.

Description Displays a short description of the option.

Command Line Options

Displays the command line representation of the options.

NOTE: You can view this option only in Advance View.

Status Displays the status of the options in the loaded configuration.

NOTE: The Status column is displayed only when you validate.

Options Description

Using CCTK GUI 13

Page 14: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

3 Click Save.

Clearing Setup and System PasswordsYou can clear the configured setup and system passwords.

To clear the passwords:

1 In the Edit mode, click the Value to Set text box of the required option.

The corresponding password dialog box is displayed.

NOTE: To display the password as clear text, select Display password in clear text. If you select Display password in clear text, then the Confirm Password text box is not displayed.

2 Enter a blank space in the Password textbox.

3 Enter a blank space in the Confirm Password textbox to confirm the password.

If both the entries match, the a green check mark is displayed next to the Confirm Password text box, else, a red X mark is displayed.

4 Click Save.

BIOS Setup or System Password Dialog boxWhile exporting the BIOS configuration as SCE, the BIOS Setup or System Password dialog box is displayed prompting the user to provide a password. If the target system has a setup or system password, then select the Use the password information below option and type the same setup or system password in the BIOS Setup or System Password dialog box. If the target system does not have a setup or system password, then select No password is required.

Password Protection Dialog boxWhile exporting a file or report with system or setup password, a password protection dialog box is displayed. To export the file with the password as clear text, click Continue. To export the file without password, click Mask.

14 Using CCTK GUI

Page 15: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Configuring Auto On OptionYou can configure the days on which the system has to turn on automatically using the autoon option of the Power and Performance Management category.

To configure the days:

1 On the Create Configuration screen, click Edit or double-click the table.

2 Click View/Change in the Value to set column of autoon.

The Auto On screen is displayed.

3 Select the option to configure the days on which the target system has to turn on automatically.

NOTE: If you have selected Select Days, then select the days on which the target system has to turn on.

4 Click Save.

Configuring Boot OrderYou can configure the boot order of a client system using the bootorder option of the Boot Management category. You can add, remove, enable, disable, or change the boot order of the legacy and UEFI boot items.

To configure the boot order:

1 On the Create Configuration screen, click Edit or double-click the table.

2 Click View/Change in the Value to set column of bootorder.

The Boot Order screen is displayed with the boot order and boot order type.

3 On the Boot Order screen, click Edit.

• For multi-platform file, you can add devices.

NOTE: The multi-platform file supports only the legacy boot order.

• For the host system file and a saved file, you can edit the existing boot order (if present) or add devices.

NOTE: Use the arrow buttons at the bottom of the Boot Order screen to change the boot order of the devices.

4 Click Save to save the configuration, or click Cancel to discard the changes and close the Boot Order screen.

Using CCTK GUI 15

Page 16: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

See Also:

• Boot Order Screen

• Adding a New Device to the Boot Order

• Boot Order Type

Boot Order Screen

The following table displays the available options on the Boot Order screen.

Adding a New Device to the Boot Order

To add a device to the boot order:

1 Click Add Device on the upper-left corner of the Boot Order screen.

2 Select the device from the Device Type drop-down list.

The Shortform, Description, and Status fields are automatically populated. By default, the status of the device is displayed as enabled.

3 Select an instance for the device from the Device Instance drop-down list.

4 Click Save.

Options Description

Device Type Displays the type of device.

Device Instance Displays a unique number to identify the device on the system.

Shortform Displays the short form of the device. If the system has many devices of the similar device type, then the short form of the device is displayed with a .<number> notation. For example, if the system has an internal HDD, eSATA HDD, and eSATA Dock HDD, then the short forms are displayed as hdd.1, hdd.2, and hdd.3 respectively.

Description Displays a short description for the device.

Status Displays if the device is enabled or disabled.

Delete Removes the device from the boot order. Click X to remove a device.

NOTE: You can view this option only if the Boot Order screen is in Edit mode.

16 Using CCTK GUI

Page 17: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Boot Order Type

The boot order type displays the type of the loaded configuration. The two types of boot orders are legacy and UEFI. If the host system file is loaded, then it displays the currently active boot order type. If a saved file is loaded, then it displays the boot order type saved in the file.

The common scenarios for boot order type are:

• If boot order type is not specified in the file and if any UEFI devices are present on the system, then the system displays the boot order type as UEFI.

• If the boot order type is not specified in the file and if any legacy devices (other than hdd) are present on the system, then the system displays the boot order type as legacy.

• If the boot order type is not specified and the loaded configuration file has only hdd items, then the system prompts the user to select the boot order type.

• If the boot order type is not specified for a legacy system and if you add both UEFI and legacy devices, then the system displays a warning message and removes the legacy or UEFI devices depending on the order of occurrence of the device.

Validating the BIOS OptionsYou can validate the options of a BIOS package against the configuration of the host system using the Validate option. You can validate the settings of a multi-platform file, host system file, or a saved file. You can validate all the options except the bootorder, syspwd, and setuppwd options.

Validating a Multi-platform File or Saved FileTo validate the options, on the Create Configuration screen, click Validate.

• If the option and the configured value are supported on the host system, then a green check mark is displayed in the Status column.

• If the option is supported and if the configured value is not supported on the host system, then a red X mark is displayed in the Status column.

• All unsupported options are greyed out and the Status column remains blank.

Using CCTK GUI 17

Page 18: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

• All the supported options on the host system are highlighted and the Status column remains blank with the Value to Set field as Not Specified.

Validating a Host System FileTo validate the options, on the Create Configuration screen, click Validate.

• All the options that are applicable on the host system are highlighted and a green check mark is displayed in the Status column.

• All unsupported options are greyed out and the Status column remains blank.

NOTE: You can configure the supported options on the host system even after you validate.

Exporting the BIOS ConfigurationYou can export a customized configuration to apply the same settings on a target client system.You can export both supported and unsupported options. You can export certain options (asset and propowntag) without specifying any values. To export an option, select the Apply Settings check box of that option and then export in any of the following formats:

• Self-Contained Executable — Click Export Configuration.exe on the Create Configuration screen to export the configuration settings as a SCE (.exe file.)

• Report — Click Export Report to export the configuration settings as read-only html file.

• Configuration file — Click Export Configuration to export the configuration settings as a .cctk or .ini file.

NOTE: To display and configure the options on GUI, double-click the .cctk file.

• Shell script — The shell script is generated at the location where SCE file is exported and contains the same configuration as that of the SCE file. The shell script is used to configure a Linux system.

See Also:

• Exporting the Configuration Without Setting Values

• Password Protection Dialog box

• Exporting the Configuration Without Setting Values

18 Using CCTK GUI

Page 19: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

• Applying the Configured Files

Exporting the Configuration Without Setting ValuesTo export asset and propowntag without specifying changes to values: Select the Apply Settings check box of the corresponding option and export.

Applying the Configured FilesYou can apply the exported .ini, .cctk, SCE, and shell script files to configure the target client systems.

See Also:

• Applying a .ini or .cctk File

• Applying a Shell Script on Linux Systems

• Applying a SCE File

Applying a .ini or .cctk FileThe prerequisites for applying a .ini file or .cctk file is as follows:

• Administrator privileges

• Install CCTK on the client system

To apply: type cctk -i <filename>

Applying a Shell Script on Linux SystemsTo apply a shell script:

1 Copy the script to a Linux system.

2 Run dos2unix on the Linux system.

3 Run the script as: sh <filename.sh>

Applying a SCE File

NOTE: You should have administrator privileges.

On the target system, apply SCE in one of the following ways:

• Double-click the SCE, or

Using CCTK GUI 19

Page 20: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

• From the command prompt, navigate to the directory where SCE is located, and type the name of the SCE file. For example, C:\Users\SystemName\Documents>"<filename>"

NOTE: You cannot run SCE on Windows PE systems. For more information on applying SCE on target systems running the Windows PE operating systems, see Troubleshooting CCTK.

SCE Details

The common scenarios of using SCE are as follows:

• When you apply SCE on a target system, SCE silently installs the BIOS settings on the target system. When the installation is complete, SCE generates a log file with the SCE name at the same location. The log file contains all the applied options and the status of execution for the SCE file.

NOTE: To generate the log file in a required location: Specify the location of the log file. For example, SCE.exe /l="<folder_path>\log.txt"

• When you apply SCE on a target system from a read-only location, provide the /nolog option to prevent generation of the log file. For example, SCE.exe /nolog. The /nolog option helps to successfully run SCE and informs that a log file is not created as SCE is in a read-only location.

• If you run SCE from a read-only location without providing /nolog, then SCE fails to run.

• To apply SCE on a Windows PE system, extract SCE from a Windows system using /e option. For example, SCE.exe/e=<folder_path_to extract SCE>

• If you have configured a setup or system password on the target system, and while exporting SCE, if you have not provided the same password in the BIOS Setup or System Password Dialog box, then you cannot double-click and apply SCE on the target system. However, while applying SCE from the command prompt, you can provide the setup or system password of the target system.

Example of providing setup password: C:\Windows\CCTK\SCE>"<filename>" --valsetuppwd=<password string>

20 Using CCTK GUI

Page 21: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Example of providing system password: C:\Windows\CCTK\SCE>"<filename>" --valsyspwd=<password string>

See Also:

• Exporting the BIOS Configuration

• Exporting the Configuration Without Setting Values

Reviewing HistoryYou can view the details of the BIOS configuration exports in the HISTORY screen. It displays the details such as time, date, type of export, and the location to which the file is exported.

See Also:

• Viewing a Log File

• Deleting Log Details

Viewing a Log FileTo view the log file:

• On the HOME page, click Review History, or

• Click the HISTORY tab on the right side of the Client Configuration Toolkit page.

Deleting Log DetailsTo delete all the log details, click Clear Log on the HISTORY page.

Using CCTK GUI 21

Page 22: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

22 Using CCTK GUI

Page 23: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

3Troubleshooting CCTKThis section describes how to troubleshoot while running Dell Client Configuration Toolkit (CCTK.)

Running CCTK Displays Error MessagesIf you get the following error message, then uninstall and reinstall Hardware Application Programming Interface (HAPI): Required BIOS interface not found or HAPI load error.

Running CCTK on 32-bit and 64-bit Supported SystemEnsure that you are running CCTK.exe based on the architecture of the system. If you are running CCTK in a 32-bit supported system, in the installation directory, navigate to the x86 directory and run CCTK commands. If you are running CCTK.exe on a 64-bit supported system, then navigate to the x86_64 directory, and run CCTK commands.

If you are running CCTK for 32-bit supported systems on a 64-bit supported system, then the following error message is displayed: HAPI Driver Load Error.

If you are running CCTK for 64-bit supported systems on a 32-bit supported system, then the following error message is displayed: Not a valid Win32 application.

Running CCTK on Windows Vista or Windows 7 When User Account Control is EnabledIf you are running CCTK on a Windows Vista system or later on which User Account Control (UAC) is enabled, then run CCTK as an administrator. Right-click CCTK Command Prompt and select Run as administrator.

NOTE: On a Windows Vista system or Windows 7, if UAC is enabled, then a user with administrator privilege cannot install or uninstall CCTK in the silent mode.

Troubleshooting CCTK 23

Page 24: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

Running CCTK on LinuxWhen you install CCTK on a Linux system, the entry, modprobe dcdbas, is added in the /etc/rc.modules file. After uninstalling CCTK, this entry is not removed.

TPM ActivationTrusted Platform Module (TPM) is an industry standard cryptographic module that provides attestation, integrity metrics and reporting, and a secure key hierarchy. Dell client systems use TPM to verify if the state of the system has changed between two boot cycles.

To activate and check the TPM activation:

1 If not set, set the BIOS password on the system.

cctk --setuppwd=<new-BIOS-password>

2 If not enabled, enable TPM.

cctk --tpm=on

3 Reboot the system.

4 Activate TPM.

cctk --tpmactivation=activate --valsetuppwd=<BIOS-password>

5 Reboot the system without interruption till the operating system loads.

6 Check the status of TPM.

cctk --tpmactivation

The status is displayed as activate.

SCE Failing to Run on Windows Pre-installation (Windows PE) EnvironmentThe SCE generated using the Export option on GUI is failing to run on Windows PE. To configure BIOS using SCE, on the target systems running the Windows PE operating systems:

24 Troubleshooting CCTK

Page 25: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

1 On a Windows system, extract the contents of SCE to a folder using the option Sce.exe /e=<folder_path_to_extract_contents> (For more information on using the command, use /h switch.)

2 Copy the extracted contents to an accessible location in Windows PE system.

3 From the location of the extracted contents, run the following command to apply the configuration: applyconfig.bat /logfile <A valid and existing folder with write permission>\<A valid file name>

For example, applyconfig.bat /logfile C:\log.txt

To apply the configuration on a system, where setup or system password has been set, run the following command: applyconfig.bat /logfile <A valid and existing folder with write permission>\<A valid file name> "--valsetuppwd=<setup password>"

Example1. applyconfig.bat /logfile C:\log.txt "--valsetuppwd=dell"

Example 2. applyconfig.bat /logfile C:\log.txt "--valsyspwd=dell"

Troubleshooting CCTK 25

Page 26: Dell Client Configuration Toolkit Version 2.1 User's Guide · Applying a Shell Script on Linux Systems To apply a shell script: 1 Copy the script to a Linux system. 2 Run dos2unix

26 Troubleshooting CCTK