Top
Systemwalker Desktop Patrol V14g Operation Guide: for Administrators
Systemwalker

2.2.1 Create User Definition

.

The following software search conditions can be defined in user definition.

Note

Please do not perform circulated definition in user definition.


The procedure of creating user definition is as follows.

  1. Add software dictionary group (optional)

  2. Define the search condition of software

  3. Put a check in the check box in front of the added user definition


Add Software Dictionary Group (optional)

Add software dictionary group in the user definition tree.

Through adding software dictionary group, the dictionary code can be managed in groups.

The procedure is as follows.

  1. Login to the Main Menu and click [Environment settings].

    →The [Environment Setup] window is displayed.

  2. Click the [Settings of Software Auditing].

    →The following window is displayed.

  3. Click the button on the right of [User Definition] in the tree on the left, and select [Add Group] from the menu.

    →The following window is displayed.

  4. Enter the group name and click the [OK] button.

    → The created software dictionary group name will be added.

  5. When performing operation for the added group, click the button on the right of the added group to display the menu.

    Description of the displayed menu is as follows.

    Setting

    Description

    [Add Group]

    Specify it to create a group in user definition.

    Please specify a group name within 60 characters.

    [Delete Group]

    Specify it to delete the group that has been created in user definition.

    All of the lower-level group and user dictionary will be deleted.

    [Move Group]

    Specify it to move the group that has been created in user definition.

    All of the lower-level group and user dictionary will be moved.

    [Rename Group]

    Specify it to modify the group name that has been created in user definition.

    Please specify a group name within 60 characters.


Define Search Condition of Software

Define the search condition of software.

The procedure is as follows.

  1. Login to the Main Menu and click [Environment settings].

    →The [Environment settings] window is displayed.

  2. Click the [Settings of Software Auditing].

    →The following window is displayed.

  3. Click the [Add user definition] button.

    →The following window is displayed.

  4. Define the following information.

    Software Information

    Item

    Description

    [Name]

    Specify the name of software to be audited with multi-byte or single-byte characters within 256 characters. This item cannot be omitted.

    [Version]

    Please specify the version within 14 characters.

    [Notes]

    Enter the remarks. Enter with 128 multi-byte characters or 256 single-byte characters.

    [Software Dictionary Group Name]

    Select the software dictionary group name to be added into user definition.


    Detailed Settings

    Item

    Description

    [Software Code]

    It is generated automatically at new registration.

    To modify, please specify with 15 single-byte alphanumeric characters. However, “@” cannot be specified at the beginning.

    [Security Auditing]

    Please select whether to set this software to the target of security audit from the following.

    • Not to be audited (default)

      This software will not be the target for security audit.

    • Audit as Anti-Virus software

      This software will be set as the target for security audit of Anti-Virus software.

    • Audit as encryption software

      This software will be set as the target for security audit of encryption software.


    Search Condition

    Specify the search condition of this software.

    As the search condition, it involves search from Add or Remove Programs, search according to files, search from registry, combined search condition of defined auditing software.

    When a certain condition is satisfied, this software will be detected.

    • Search for"Add or Remove Program"

      After [Search by name] is selected, search will be performed in Add or Remove programs according to the name specified in Name.

    • File search

      After [Search files that matched all conditions] is selected, setting of file search can be performed.

      Each item of file search condition not only can be set manually, but also can be set automatically through command. For details of command, please refer to “dtpfinfo.exe (obtain details of executable file)” of “Systemwalker Desktop Patrol Reference Manual”.

      Specify the search condition of file.

      Item

      Description

      [File name]/[Folder name]

      Select [File name] or [Folder name] from the list and specify the name to be searched within 259 characters. This item cannot be omitted.

      The following characters cannot be specified.

      “+”, ”:”, ”\”, ”;”, ”,”, ”*”, ”"“, ”<“, ”>“, ”|”, ”?”, ”/”

      [Search by size]

      This item is effective when [File name] is specified, select it when adding the file size as search condition.

      When specifying the file size in [File name], please specify with numbers within 13 digits, and select one of [Equal], [Larger than] or [Smaller than] as the comparison condition of file size.

      [Search by update date/ time]

      Select it when adding file update time as the search condition.

      Specify the update time of file in [File name] and select one of [Equal to], [Above] or [Below] as the comparison condition of update time.

      When [From] is selected in the comparison condition, it is required to specify the end date of that period.

      The date that is larger than the start date of the period should be specified.

      When [Equal to] is selected in comparison condition, up to 10 conditions can be registered.

      The same date and time cannot be specified.

      [Search by version information]

      Select it when adding the version information of file as search condition.

      The numeric value from 0 to 2147483647 and “.” can be specified.

      In the comparison condition of version information, select one of [Equal to] or [Larger than].

      When the comparison condition is specified to [Equal to], up to 10 conditions can be registered. The same version cannot be specified.

      In the properties of search file displayed in Windows Explorer, the version information will be displayed in “File Version” in the “Version Information” tab. Please set the value of version information displayed as above here.

    • Registry Search

      After [Search any key and value] is selected, setting of registry search can be performed.

      Specify the search condition of registry.

      Item

      Description

      [Key name]

      Specify the key name of registry within 233 characters. Please select the beginning of key name from the list.

      • \HKEY_LOCAL_MACHINE\

      • \HKEY_CLASSES_ROOT\

      • \HKEY_USERS\

      [Value name]

      Specify the value name of registry within 256 characters. When omitted, search by key name only.

      [Value data]

      Specify the data of registry value within 256 characters. When omitted, search by key name and the name of key value only.

      [In 64-bit OS environment]

      Specify registry search operation on the 64-bit OS.

      • When selected

        When search registry on 64-bit OS, refer to the registry under “HKEY_LOCAL_MACHINE\Software\Wow6432Node”. On the 32-bit OS, refer to the specified registry.

      • When not selected

        Refer to specified registry for both 32-bit OS and 64-bit OS.

    • Combined condition

      Select [Use composition condition], combined condition can be set.

      Select the software to be combined from the list, and specify [Include] or [Not Include] for the selected software to determine combined condition. Up to 10 combined conditions can be specified.

      Item

      Description

      [Adding conditions] button

      Add one line of field that can select software.

      [Delete] button

      Delete the software where the line of delete button is located from the combined condition.


    Software Operation Status

    Select [Specify the object file], the setting of software operation status can be performed.

    Register the result file of command output to server and software can be registered.

    For details of command, please refer to “dtpfinfo.exe (Obtain details of executable file)” of “Systemwalker Desktop Patrol Reference Manual”.

    Item

    Description

    [Download] button

    Register the file specified in the output result file to server.

    During registration, please select whether to specify PE Header for target file to register.

    • Do not use PE Header

    • Use PE Header

    [Delete] button

    Delete the file of the line where the delete button is located from the server.

    [Target file name]

    The name of target file to be audited as operation status of software is displayed.

    [PE Header]

    When registering target file according to specified PE Header, it is displayed as “Registered”.

    In addition, the operation status of the following software cannot be collected.

    • Software without fixed file name

    • Software with extension apart from “exe”

    • Resident software and software without window that is started in service of Windows .etc

  5. Click the [OK] button.


Put a check in the check box in front of the added user definition

Select the added user definition.

The procedure is as follows.

  1. Login to the Main Menu and click [Environment settings].

    →The [Environment settings] window is displayed.

  2. Click the [Settings of Software Auditing].

    →The following window is displayed.

  3. In the field on the left, select [User Definition].

    → The added user definition is displayed in the field on the right.

  4. Select the software name to be audited.

  5. Click [Apply] button, save the selected status.


2.2.1.1 Create User Definition from Inventory Information

“User Definition of software dictionary can be created automatically from the information of “Add or Remove Programs” collected as inventory information from CT.

This “User Definition” is called “User Asset Software Dictionary”. “The procedure of creating “User Asset Software Dictionary” is shown as follows.

  1. Confirm the software product that has been installed

  2. Execute the user asset software dictionary creation command

  3. Set user definition of software dictionary


Confirm the software product that has been installed

Confirm the installation status of software product to be audited from the Main Menu.

Select [PC Information] - [Adding or Removing Programs] of the Main Menu, and refer to the list of software collected from each PC to confirm whether the software product to be audited is displayed.

If the software product needs to be audited is not installed, please perform the one of following actions.

Execute the user asset software dictionary creation command

Execute the dtplocaldic.exe (user asset software dictionary creation) command.

For details of the dtplocaldic.exe (user asset software dictionary creation), please refer to “Systemwalker Desktop Patrol Reference Manual”.

It is recommended to set the following according to operation method for the timing of command execution.

Set the user definition of software dictionary

Through executing the user asset software dictionary command, the software product displayed in “Add or Remove Programs” will be added to the user definition of software dictionary.

The administrator selects the software added to user definition.


Select software product of user definition

The list of added software products will be added to the following location of the Main Menu in default setting.

[Environment Settings] - [Settings of Software Auditing] - [Software Dictionary] - [User Definition] - [Installed Software] (Note)

The software product needs to be audited by the administrator.

Note) The location to add software definition is specified in the dtplocaldic.exe (user asset software dictionary creation) command.

The value set for each items of added software definition is shown as follows.

Item

Description

[Name]

Software name displayed in “Add/Remove Program”.

[Version]

Set “VERSION” as the initial value.

[Software Dictionary Group Name]

In default setting, “User Definition” (note) is used as software dictionary group.

[Software code]

The code that is generated automatically is set.

Format: LLMMDDYYYYIIIII
LL: Indicates it is created at user definition creation

YYYY: 4 digits of western calendar
MM: Month (01~12)
DD: Date (01~31)
IIIII: Increment value (00000~99999)

[Search for “Add or Remove Program”]

The “Search by Name” check box is selected.
The result of search by software name according to this setting will be collected as inventory information.

Other item

It is not set as initial value.

Note) The software dictionary group name is specified during the execution of the dtplocaldic.exe (user asset software dictionary creation) command.

Since license management is managed according to the software name displayed in “Add/Remove Program”, if the software product for which the version, license and license form cannot be determined exists in the name displayed in “Add/Remove Program, this name cannot be used in software license management.

At this time, this situation can be changed through additional setting for other items of the software license definition. For details, please refer to “2.2.1 Create User Definition”.

Note

The notes for the user definition creation function are shown as follows.

  • User definition of the software product that is not displayed in “Add/Remove Program” cannot be created.

  • In following cases, software license definition cannot be created through the user asset software dictionary creation command.

    • In the previous process of executing the user asset software dictionary creation command, when the software license definition of software product with same name exists in [User Definition].

  • When the software dictionary is provided through software dictionary service, if the software license definition of software product with same name is contained, the software name of [User Information] will be renamed.

    “Software Name” → “Software Name (Duplicate)”