Developer Guide

  • 2021.2
  • 06/11/2021
  • Public
Contents

Examples of Scripts for Windows* OS

Custom OS/Firmware Support for DSO describes scripts that you can copy and modify for your choice of OS.
To support Windows* OS as a target, the Intel® TCC Tools package contains examples of modified scripts. If you have a Windows OS target with UEFI BIOS, you can use the example scripts without modifications to run data streams optimizer. If you have a different Windows* environment, you can copy and modify the scripts.
You will need to implement all scripts for the target system. You will also need to satisfy all requirements for the host system. Use the recommended OS for the host system.
The tuning process for targets running Windows* OS has its own specifics. The documentation below describes dependencies.

Prerequisites

  • Windows* 10

Set Up SSH Server

To support the data streams optimizer, the target system must support SSH connection. You will need to install and configure SSH Server on the target.
To install SSH Server:
  1. On the target system, run Microsoft
    PowerShell
    with Administrative permissions.
  2. Get the available version for SSH Server:
    PS> Get-WindowsCapability -Online | ? Name -like "OpenSSH*" Name : OpenSSH.Client~~~~0.0.1.0 State : NotPresent Name : OpenSSH.Server~~~~0.0.1.0 State : NotPresent
  3. Install SSH Server:
    PS> Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
  4. (Optional) For convenience, you can also install SSH Client:
    PS> Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
  5. Start SSH Server:
    PS> Start-Service sshd
  6. Add starting SSH Server during start:
    PS> Set-Service -Name sshd -StartupType `Automatic`
  7. Confirm the firewall rule is configured. It should have been created automatically by setup:
    1. Run the following command:
      PS> Get-NetFirewallRule -Name *ssh*
    2. Confirm that you see a firewall rule named “OpenSSH-Server-In-TCP” and it is enabled.
    3. If the firewall does not exist, create one:
      PS> New-NetFirewallRule -Name sshd -DisplayName `OpenSSH Server (sshd)` -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
  8. Enable remote access:
    PS> Enable-PSRemoting -SkipNetworkProfileCheck -Force

Install Python

You will need a tool for writing scripts. Intel recommends Python 3.7, because Windows OS supports it.
  1. Download Python 3.7.x (3.7.9 version was tested) installation package from the official Python site, and install it on the target.
  2. Add the path for the executable
    python.exe
    to the system environment variable
    PATH
    so that
    python.exe
    is accessible in the command-line prompt without specifying the full path.

Extract the Target Package

The package contains scripts used by data streams optimizer on target systems running Windows* OS.
Copy the contents of the
${TCC_TOOLS_PATH}/tools/target_scripts_win/
directory from your Linux* host to the
C:APPSTCCSDKtoolstarget_scripts_win
folder on the Windows* target.

Sample Input Files for Targets Running Windows* OS

The package contains a sample environment file and sample requirements file in the
demo
folder on the host system. You can copy and modify these files when using the data streams optimizer to tune targets running Windows* OS.
Sample files:
  • Sample environment file on host system:
    demo/environment/sample_environment_uefi_win.json
  • Sample requirements file on host system:
    demo/requirements/single_pciememrd_0_win.json

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.