Windows NT/2000/2003/XP

System Administration Software

 

 

Hyena is a tool for day-to-day administration of Windows NT and Windows XP/2000/2003 systems.   

 

Hyena brings together all of the administrative tools from Windows NT such as User Manager, Server Manager, and File Manager/Explorer, and many of the MMC components from Windows 2000/2003 into a single, easy-to-use, centralized program. Hyena arranges all system objects, such as users, servers, and groups, in a hierarchical tree for easy and logical system administration. Here's a sample of just a few of Hyena's functions:

 

 Create, modify, delete, and view users, groups, and group membership

 Modify single or multiple user properties, including terminal server and Exchange mailbox settings

 Automatically create home directory and home shares for users, including full security configuration

Export delimited text files of users, groups, printers, computers, group members, services, scheduled tasks, disk space, registry, and Active Directory information for your entire network.

 Browse all server shares, copy and delete files without drive mappings

 View events, sessions, shares, processes, and open files for any server

 View and control services and drivers for one or more computers

 Manage share and file permissions, including creating new shares and viewing all share access rights at the same time

 Remotely schedule, delete, and manage jobs for multiple computers at the same time

 Remotely shutdown and reboot any single or group of computers

 View remaining disk space for multiple computers at the same time

And more...

 

This help document is organized by system administration function.  Use the navigation window at the left to browse the remaining help topics, or visit http://www.systemtools.com/hyena for more information about Hyena.

 

If you have questions or problems, or want to check to see if a new version is available, see the Support and Suggestions section. If you need information on purchasing Hyena, see the Licensing and Registration section for pricing and licensing information.

 

If you want to be kept informed of exciting news and updates to Hyena, find out more about How to Receive Hyena Update Notices

What's New !

 

New Features in Hyena v6.0

 

WMI Support

 

WMI support has been added to Hyena.  Hyena can display any WMI property from any WMI class and also provides access to common WMI methods.  Hyena also supports modification of most writable WMI instance information on one or multiple instances from one or more computers. To help in understanding WMI and how it is integrated into Hyena, see the WMI topic.  WMI exporting options have also been added to Exporter Pro.

 

Exporting Selected Active Directory Objects

 

Hyena now supports exporting information on selected Active Directory objects.  Previously, only domains, computers, and OUs could be selected for exporting.  For example:

 

Tool Grouping

 

Hyena now allows tools to be grouped into submenus.  Hyena will automatically transfer all existing custom tool settings to a file named TOOL_CMDS.DAT, which can be found in the same location as other Hyena configuration files.  This new tool command file provides a structure that permits the tools to be grouped and displayed on submenus.  To assign tools to groups, see the User-Defined Tools topic.

 

Microsoft Exchange Public Folders

 

Support has been added for displaying Microsoft Exchange Public Folders as well as access to the shell Properties dialog for these directory objects.

 

Access to Microsoft Hotfix Information

 

The Computer Properties->Hotfix dialog has been modified to support viewing the online Microsoft Hotfix Support database.  Either double-clicking on any 'Q' or 'KB' hotfix, or clicking the View Hotfix Information button will access the Microsoft Support web site.

 

 

 

 

Hyena v5.7

 

Originally introduced in Hyena v5.5, Exporter Pro has been enhanced with more options for easier administration and customization.  Exporter Pro v1.2, included with Hyena, also now supports exporting 'true' last logon information for both Windows NT and Active Directory domains.  Hyena also now has tighter integration with Exporter Pro, providing simple and easy selection of objects in Hyena to be immediately sent to Exporter Pro.  See the Exporting topic for more information on Hyena's new Exporter Pro integration.

 

Improved Active Directory Shell Integration - Hyena v5.7 can now display the standard Active Directory shell context menu functions for most objects in addition to the full shell property pages.  Need access to a 3rd party shell extension or Exchange Task functions?  Click here for more information.

 

Wake-On-Lantm (WOL) - New integration with industry-standard WOL-enabled computers has been added in Hyena v5.7.  What is WOL ?  Quite simply, it is a technology that allows a computer that is turned off to be remotely turned on.  See the Wake-On-Lan (WOL) topic for more information.

 

Improved Active Directory 'Find' Integration - Previous versions of Hyena could display the standard Active Directory 'Find' dialog, but were limited to what could be done with the results.  Hyena v5.7 supports selecting and returning the resulting objects back into Hyena.

 

Viewing Share Security - While previous versions of Hyena could display the share security for all shares through the View All Access Rights option or for a single share through the Share Properties dialog, Hyena v5.7 can now display share security information for any range of selected shares through a new View Share Security function.

 

Service Installation - Hyena can now install services on one or more computers using a simple wizard-based service installation process. For more information, see the Installing Services topic.

 

Hyena v5.5

 

Exporting Improvements

 

Hyena v5.5 now includes a separate and more powerful version of the exporting software, Exporter Pro.  All Hyena v5.5 licenses include free Exporter Pro licensing!  Exporter Pro provides for many improvements to the previous exporting options found in Hyena, including exporting of Active Directory information, registry, scheduled tasks, and more.  See the Exporting topic for more information.

 

Timeout (Ping) Protection Options

 

Hyena can now be optionally configured to initiate a ping to any computer before attempting a remote operation, preventing long delays in waiting for a timeout error to be returned.  For more information about this feature, see the Ping Options topic.

 

Support for adding Containers/OUs through Object Manager

 

Containers and Organizational Units (OUs) can now be added directly in Object Manager.  A browse button was also added to assist in creating the paths for Containers/OUs and Windows 2000/2003 domains.

 

Hyena v5.2

 

Active Directory Shell Properties

 

Hyena can now display the standard shell property pages for all Active Directory objects.  This provides for 100% full Microsoft functionality for Active Directory objects, while at the same time leveraging Hyena's ease-of-use and easy navigation through Active Directory.  Specifically, these changes allow Hyena to:

For some objects, such as users and computers, the Account Functions (users) or Directory Functions (computers) menus provide direct access to the Shell Property pages and the Security Property pages.  Other objects, such as foreign security principals, contacts, printers, and shares use the Shell Property pages by default when managing object properties.

 

The default property pages for user and group objects can be changed under Tools->Settings->Active Directory settings.   The user and group objects, Hyena can either continue to display its own customized set of property dialogs, or use the standard shell property pages.

 

Additionally, to force the display of the integrated shell property pages for a user or group object, hold the SHIFT key when using the Properties function (toolbar, or double-click). To force the display of Hyena's internal property pages for a user or group object, hold the ALT key when using the Properties function (toolbar, or double-click).

 

Active Directory Security

 

In addition to the standard Security dialog that can be accessed either through the Security tab on any Properties dialog or through the new Security Properties... option, there is also a new List Directory Security option to the context menus for all Active Directory (AD) objects.  This option will generate a display of the security settings for any selected AD objects.  To view the security for multiple objects, select them from the right window.

 

For other improvements in this release, see the General Improvements section; for bugs fixed in this release, see the Bug Fixes section.

 

Hyena v5.0

 

New Organization Unit (OU) Filtering toolbar

 

A new toolbar has been added that allows control over object retrieval options when viewing the contents of OUs or containers.  This new toolbar is displayed automatically in the lower left corner of Hyena's window when an Active Directory container is selected.  See Using the OU Filtering Toolbar for more information.

 

Registry Management

 

Registry management has been added to Hyena.  To access the registry, expand any computer in Hyena's left window; registry functions are at the bottom of the computer object list.  Supported functions include registry navigation, creating new keys/values, key and value deletion, searching, and modification of REG_DWORD and REG_SZ data types.  For more information, see Registry Management.

 

Listing Group Members for Multiple Groups

 

Hyena can now display the members of multiple Active Directory groups in the list window.  To do this, select any number of Active Directory groups (any type) in Hyena's list window, right click and select "View Group Members".  Hyena will add the applicable group name as an additional column to the resulting display.  This feature can be used to create a complete domain-wide group membership listing.

 

New XP-style toolbar and menus

 

Hyena now uses a new full color toolbar and XP-style menus.  Also, a large button toolbar is available under Tools->Settings->GUI.  Hyena must be restarted to change the toolbar button size.

 

Add to Group... function for Active Directory Users

 

A new function, Add To Group, has been added for Active Directory user displays on the Account Functions submenu.  This new function will allow any number of select users to be added to any Active Directory group.

 

Viewing multi-valued Active Directory elements in Tabular Views

 

Hyena can now display the values for multi-valued Active Directory attributes when used in a Tabular (right window) query.  For example, the MemberOf attribute for a user's group memberships and the proxyaddress attribute for Exchange are examples of these attributes.

 

Since there is only one 'cell' for each attribute for the output of a tabular query, Hyena will append the values for multi-valued attributes together and separate them with the '^' character.  Windows is limited to placing a maximum of 255 characters in any cell/field in a list window, so if Hyena detects that this limit has been reached, the characters "...!" will be placed at the end of the attribute data to indicate that more data was available, but could not be displayed.

 

General Improvements

 

Hyena v6.0

Hyena v5.7

Hyena v5.5

Hyena v5.2

Hyena v5.0

Corrections and Bug Fixes

 

Hyena v6.0 'B'

Hyena v6.0

Hyena v5.7 'E'

Hyena v5.7 'D'

Hyena v5.7 'C'

Hyena v5.7  'B'

Hyena v5.7

Hyena v5.5 'D'

Hyena v5.5 'C'

Hyena v5.5 'B'

Hyena v5.5

Hyena v5.2 'D'

Hyena v5.2 'C'

Hyena v5.2 'B'

Hyena v5.2

Hyena v5.0 'B'

Hyena v5.0

Installation Requirements

 

General

 

Hyena can be installed on any Windows NT, Windows 2000, Windows 2003 Server, or Windows XP computer.  The computer that Hyena is installed on can be running either as a workstation or server.  There are two general configurations that Hyena is normally installed under:

Hyena relies heavily on the capabilities of the operating system environment that it is installed on to manage remote computers and domains.  Some guidelines on specific installations:

 

Security and Permissions

 

Hyena depends entirely upon the operating system for security and authentication, and does not alter or modify the security capabilities in Windows.   Any user that is using Hyena therefore does not have any greater or lesser degree of functionality than what could be performed outside of Hyena.   If a user running Hyena attempts to perform a function or operation for which they are not authorized to perform, Hyena will display an appropriate access denied error message.  Hyena can be used either directly from the actively logged on user account, or the "Run As" option can be used when the Hyena.exe file is executed.

 

 

Active Directory Administration Requirements

 

Due to Hyena's extensive integration with Active Directory and to provide complete Active Directory compatibility and support, Hyena requires the installation of the Microsoft Administration Tools (AdminPak) if any Windows 2000/2003 domain is managed.  The AdminPak.MSI file can be found in one of the following locations:

Note that there are different versions of the adminpak.msi file for Windows 2000 and Windows XP/2003.  If your client computer (the computer that Hyena is being used on) is running Windows 2000, you need to install the Windows 2000 adminpak either from the CD or from the server.

 

The Windows Server 2003 Administration Tools can be used to manage both Windows 2000 and Windows 2003 domains.

 

Exchange Installation Requirements

 

To manage any version of Microsoft Exchange, the appropriate Microsoft Exchange Administration software must be installed.  The Exchange Administration software is found and installed from the Exchange Server CD.  After installation, see the Exchange Setup section for more information for your specific Exchange configuration.

 

Note: The Enterprise Edition of Hyena is required for Exchange administration.

Getting Started - General

 

Hyena displays information in one of two primary windows, similar to Windows Explorer.  The leftmost window is referred to in this guide as the tree window, since domain objects are arranged in a hierarchical tree-style format, while the rightmost window is referred to as the list window, which always displays items in a report/list format.

 

Using the Tree Window

 

Objects in the tree window that contain additional subordinate objects will be displayed with a small "plus" indicator next to them.  Clicking on the plus indicator will cause the object to expand, and all of the subordinate objects will be displayed.  Clicking on the "minus" indicator will hide the subordinate objects, effectively hiding the contents of the parent object.

 

In the example to the left, the domain controller for the Resource2000 domain has been expanded to show the various objects that can be managed, including printers, shares, sessions, open files, services, devices, events, disk space, processes, and scheduled jobs.

 

Some objects, for example, the printers, shares, computers, and user/groups, can be further expanded in the tree window, by clicking on the "plus" indicator.

 

The order and display of the sub-objects, or "nodes", that are displayed under some object types can be customized using the Object Manager.  For more information, see the Object Manager - Nodes topic.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Using the List Window

 

 

Double clicking on an object in the tree window that contains additional subordinate objects will result in the information to be displayed in the list window.  For example, double clicking on the Domain Users object in the tree window, will cause the domain users to be displayed in the list window.

 

Objects displayed in the list window can be sorted by clicking on the column heading.  Clicking a second time on a column heading will result in the sort to be reversed (descending sort).  In the example above, the device name column has been sorted on (ascending), indicated by the "down arrow" image after the column header name.

 

The widths of each of the column headings can be adjusted by moving the mouse between any two of the columns and then dragging the borders.  The column heading widths will be saved and restored the next time the same type of object is displayed.  

 

Positioning the mouse pointer between the column separator between two columns and double-clicking will automatically adjust the column width to show the contents of all values of the column.

 

The columns in most list view windows can be temporarily rearranged by simply dragging and dropping the columns on the column header.

 

Many of the list window displays can also be customized, to remove unwanted fields, or to hide (not display) some fields. Additionally, grid lines and full row selection can be enabled for the list window for easier navigation and control.  See the Options and Settings (Display) section on how to customize the list window views, and the Options and Settiongs (GUI) section on how to enable list window options.

 

The contents of the list window can also be filtered using the filter toolbar button.  For more information on the filtering options, see the Filtering Data topic.

 

Accessing Object Properties and Functions

 

Objects displayed in any of the windows can be selected by clicking on them once with the mouse.  In the list window, multiple objects can be selected at the same time by simultaneously clicking on them while holding down either the shift or control keys.  If the shift key is held down while clicking on an object in the list window, a range of objects will be selected.  Holding down the control key while selecting objects will select additional objects.  Only one object can be selected at a time in the tree window.

 

Once one or more objects have been selected in either the tree or list window, clicking with the right mouse button will display the appropriate context menu for the object.

 

Note: Some functions will be grayed out (disabled) on the context menu, depending upon the exact type of object selected and whether single or multiple objects are selected.  As a shortcut, the Properties function for most objects can be invoked by double clicking on the object, or the Properties button on the toolbar can be used.

 

For complete documentation on all of Hyena's objects, see the Using Hyena - Objects topic. For information concerning Hyena's functions, such as reporting, printing, and exporting see the Using Hyena - Functions topic.

Using the Mouse

 

Clicking the right mouse button after selecting an object will display a pop-up context menu displaying options specific to the selected object.

 

Double clicking on any object will display any children that the object may have. If the object does not contain any child items, then the object's properties will be displayed. For example, double clicking on the Domain Users object will display all of the domain users in the target domain. Double clicking, in turn, on one of the individual domain users will display that user's properties dialog window.

 

Many of the mouse actions can be performed with the keyboard instead.

 

 

 

Using the Keyboard

 

When using the mouse for drag-and-drop file copy and move operations, the control key must be pressed to indicate a copy operation, while the shift key must be pressed to indicate that a file move operation should be performed. The keys only need to be pressed when the file copy/move operation is initiated; they do not have to be held down for the duration of the file copy/move.

 

To speed access to certain common operations, the following keys have been assigned to specific commands:

 

Return/Enter - Same as selecting Properties option. If object does not have any properties, then object's double-click action is performed.

 

Shift-F10 - Same as right mouse click.

 

Application button - This key is located only on Windows/Natural keyboards below the right shift key. Pressing it is the same as the right mouse click.

 

Insert - Same as selecting object's Create... or New... option. For example, pressing Insert when the Domain Users object is selected will display the Create New User dialog.

 

Delete - Same as selecting object's delete option.

 

F5 - Will refresh the contents of the list window.

 

ESC - Pressing the Escape key while in the tree view window will automatically jump to the parent of the selected item.

 

Left and Right Arrow Keys - When positioned over a tree window item that has a "plus" symbol next to it, the right and left arrow keys can be used to expand and contract the selected item.

 

Control-F - Activates the Search and Filter function.

 

Ctrl-F1…Ctrl-F9 - Activates the 1st (F1) through the 9th (F9) user-defined tool or command.

 

Shift-Ctrl-F1…Shift-Ctrl-F9 - Activates the 1st (F1) through the 9th (F9) shared user-defined tools or commands. See the Shared Settings section for more information about how to set up shared settings.

 

Hyena's main tree and list windows can also be quickly navigated by simply typing in the first few characters of any displayed item.  For example, if the list window is displaying a list of users, typing the characters "john" will quickly move the selection to the first entry starting with "john".

Configuring Multiple Domains

 

When Hyena is first started, the domain that the workstation is currently logged into will always be shown and added to the tree window.  If additional domains have been setup in your network, they can be added into Hyena.

 

Note: Adding domains in Hyena does not affect any domain or in any way actually create a new domain, it simply makes the domain available and known to Hyena's functions.

 

To add a domain, use either of the following techniques:

 

1. To simply add a new domain to the view window:

 

Click on the File menu

Select Add Domain...

Enter the name of the domain to add and click OK

Alternately, the Find All Domains button can be clicked to query the network for all domains.  Select the domain(s) to add from the list displayed.  Note that Windows does not distinguish Windows NT or Windows 2000/2003 domains from Windows workgroups.  However, the name of the Primary Domain Controller (PDC) will usually be displayed next to the domain name; workgroups will not have a PDC name displayed next to them.

 

2. To add a domain using the Object Manager:

 

Click on the File menu

Select Manage Object View...

Click the New button

Select Windows NT Domain as the Type of Object

Enter the NetBios name of the domain for the Name of the Object

Optionally, enter a comment for the domain

Optionally, enter the name of a BDC for the Source Controller for the domain.  See the Setting a Source Controller topic for more information.

 

The Object Manager can also be used to put domains and other objects into custom groups.  For more information on using the Object Manager, see the Object Manager topic.  

 

The newly added domain will be permanently added and will be always available until it is removed.

 

To remove a domain from the view, use the Object Manager.  For more information on using the Object Manager, see the Object Manager topic.  

 

Note: Removing domains in Hyena does not affect or in any way actually remove a domain, it simply makes the domain unavailable to Hyena and removes it from the tree view window.

Options, Settings, and Customizations

 

Support is provided for a number of customizable settings. To access the settings dialog, select the Tool Settings toolbar button or the Tools->Settings menu option.

 

General Settings

 

Automatically Add Current Domain to Object View

Automatically Expand Current Domain on Startup

Confirm all File Copy and Move Operations

Automatically refresh disk space information

Remote share mask for disk space function

Automatically refresh print job information
Editor Path and Name

Path to Object Manager and other shared configuration files

Shared Settings File Location

 

User Settings

 

Suppress automatic display of all groups and users

Sort user group memberships in tree window

Refresh list view window when users are modified

Show last logon/logoff information

Show RAS (dialup) information

Show user thin client (Terminal Server) information

Confirm changes to properties for multiple users

Show user preview window on user properties dialog

Display warning when accessing locked out accounts
Show User Profile Manager dialog when deleting users

Batch file to run for all user changes (add/modify/delete)

Show batch file command windows

Default Login Script Directory

 

Home Dir Settings

 

The home directory settings dialogs allows setting home directory templates for control over home directory, home share, and security settings. See the Home Directory Templates section for more information on user home directory options.

 

View Settings

 

Show Hidden Shares

Show UNIX (Samba/Linux) computers

Check if Shares contain Subdirectories in Tree View

Check if Directories contain Subdirectories in Tree View

View All Computers (offline, hidden, etc.)

Show shell context menu for computer objects

Cache domain controller information

Integrate browse list with Active Directory computer listing
Ping Options

Disk Space View Options

 

Active Directory Settings

 

Enable Active Directory support
Show Shell Property Pages by default for user objects
Show Shell Property Pages by default for group objects
Use DNS computer paths
Enable support for adding INetOrgPerson objects
Add shell functions menu to directory object context menus

 

Focus Settings

 

The Focus settings let you configure an object to automatically show its contents when it receives the focus, that is, it is clicked on or selected by the keyboard.

 

The focus options are broken down into many different related object categories, so you can select to have this option available for some objects, yet not available for others. For networks with WAN or slow network connections, it is advisable to have these options disabled.

 

GUI Settings

 

Enable large toolbar buttons

Enable OU filtering toolbar
Always Show OU filtering toolbar

 

The remaining GUI settings allow some of the windows to utilize the advanced options available in some Microsoft add-in products, including Internet Explorer 4.0. These options will only be visible if the file named ComCtl32.DLL is version 4.7 or later. These options include a grid and optional selection behavior. Unfortunately, third-party software developers cannot redistribute this .DLL file. To get this functionality, update to the latest version of Microsoft Internet Explorer.

 

Note: Hyena must be restarted for these settings to take effect.

 

 

User-defined Tools

 

Adding user-defined tools and commands to the Tools menu is fully supported. User-defined tools can be invoked either by selection from the Tools menu, or by pressing Ctrl-F1 through Ctrl-F9. Ctrl-F1 corresponds to the first user-defined tool, Ctrl-F2 for the second, etc.

 

To setup user-defined tools, select Tools->Settings->Tools. A maximum of fifty (50) custom tool commands can be defined.  Hyena stores all tool configuration information into a file named TOOL_CMDS.DAT.  Tools can also be placed into groups as follows:

When configuring a user-defined tool option or a macro command string, the command line to execute can include the following special symbols that will be replaced before execution:

 

%S% - Server Name. When used in a command line, the %S% will be replaced with the name of the current server active for the selected object.

 

Note: Leading "\\" characters in the server name will NOT be included in the command replacement. If the tool being invoked requires the leading backslashes, enter these explicitly into the command string.  See the example below.

 

%E% - Entry. When using in a command line, the %E% will be replaced with the text of the active entry for the selected object. For a selected item in the right list window, the first column will be used for the text. Use the %Cx% (see below) if a different column needs to be used.

 

%G% - Group. This option is only valid when viewing members of local or global group; it will be replaced with the name of the selected members’ group name.

 

%Cx% - Column "x". When used on selected information in the list window, replace the "x" with the number of the column to retrieve information from. For example, to use the information displayed in the third column, enter "%C3%" for the symbol.

 

%Px% - User-defined parameter. Can be used to prompt for up to three (3) parameters. Use %P1% for the first parameter, %P2% for the second, etc.

 

%Px:prompt% - User-defined parameter with custom prompt. Same as above, but adds the “prompt” text to the input dialog, so that it will be clear what is being asked for.

 

%Px:prompt/PWD% - User-defined parameter with custom password-enabled prompt. Same as above, but automatically turns on the password entry check box for security.

 

Note: The symbols MUST be entered in uppercase only.

 

 

 

Display Options

 

The Display tab on the Settings dialog allows customization of some of the view windows.

 

After first selecting the display to customize, control over the fields to display, the order of display, and the field captions can be modified.

 

Note: The display options are saved immediately upon modification; clicking OK on the Settings dialog is not necessary.

 

 

 

WOL

 

Hyena includes support for Wake-On-Lan tm (WOL) enabled computers.  See the Wake-On-Lan section for more information.

 

 

Reporting Options

 

Hyena includes both printing and reporting capabilities.

 

Printing and Reporting options only apply to items displayed in the list window.

 

 

Print Functions

 

The printing function is accessed through the File->Print menu option. The options that can be configured include the point size to be used on the printed output, and whether to print using a bold font.

 

Reporting Functions

 

Hyena includes a Microsoft Access-based reporting interface. To utilize the reporting capabilities, you need to have Microsoft Access already installed on your system.

 

Hyena will by default automatically attempt to find MSAccess.exe and use the HyenaRpt.mdb file that is in Hyena's installation directory.  To customize the locations of these files for special or shared configurations, the following options can be provided on the Tools->Settings->Reporting dialog:

 

Path to MSAccess.exe- Provide a path to the MSAccess.exe program, such as j:\apps\microsoftoffice\office. You can leave this option blank to have Hyena attempt to find MSAccess.exe.

 

Path to HyenaRpt.mdb report database – Hyena’s installation program installs the HyenaRpt.mdb database into the default Hyena installation directory.  If this setting is left blank, Hyena will use the .mdb file in the installation directory.  You can provide an alternate directory path here, or move the HyenaRpt.mdb file to a central network location.

 

To generate a report, first display some information in Hyena’s right list window. Then, select Tools->Run Report… from the menu.

 

 

Licensing Settings

 

The licensing settings display the active Hyena License, as well as any license options, such as Exchange, Terminal Server, and the current maintenance expiration date.

 

Remote Control Settings

 

The SystemTools Remote Control Manager (STRCM) provides for a way to manage some remote control software products from within Hyena.  The STRCM supports installation, configuration, viewing, and uninstallation of remote control software, including VNC-based products.  See the Remote Control topic for more information about the STRCM.

 

The individual configuration files (.rcm) can be viewed and modified from the Tools->Settings->Remote dialog.

 

Hyena supports sharing of Remote Control configuration (.RCM) files.  To share these files with other Hyena users, enter a network path location for the ".RCM file configuration directory" setting.

 

Exchange Options and Setup

 

Hyena’s Exchange 5.5 and Exchange 2000/2003 interfaces are to add, modify, and delete Exchange mailboxes that have associated Windows NT/Windows 2000/2003 user accounts.

 

The only installation prerequisite for using the Exchange integration options in Hyena is that you must have already installed the Microsoft Exchange Administrator program on your client workstation. If you can already manage Exchange recipients from your workstation, then this probably has already been done. Hyena requires the use of certain DLLs for these functions; Microsoft does not allow 3rd party software developers to redistribute these files.

 

Important Note: Hyena’s Microsoft Exchange integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow Exchange information to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Exchange features to be fully evaluated before any additional licenses for it are purchased. For more information on the licensing of the Enterprise Edition, see the Licensing topic.

 

Exchange 5.5 Options

 

Configuration to use Default User Manager Interface

 

Hyena includes two (2) different interfaces into Microsoft Exchange 5.5. The first interface (the default) uses exactly the same interface that Window NT’s own User Manager for Domains uses into Exchange. To configure Hyena to use this interface, go into Tools->Settings->Exchange and enable the Enable User Manager Extensions for Exchange Integration option. If this option is changed, Hyena must be restarted. As long as the Exchange Administrator program is installed on the computer that Hyena is being run on, then the existing User Manager configuration will be used. Note that there will be an “Exchange” option on the main menu bar, plus an Exchange Functions menu on all context menus for users.

 

 Configuration to use Hyena’s Custom Interface

 

Hyena also includes its own custom Exchange 5.5 interface. This interface does have some limitations, but also some advantages over the built-in User Manager interface. To configure Hyena to use this interface, go into Tools->Setting->Exchange, and follow these steps:

 

Enable Exchange integration, by enabling the “Enable Hyena’s Custom Exchange Integration Options” checkbox. If Exchange integration is being enabled for the first time, you must restart Hyena before you will be able to have access to the Exchange options.

 

Provide the name of your local Exchange server for the value in “Exchange Server for Directory Operations”. This is sometimes referred to as the “DSA”.  If your site has multiple Exchange servers, enter in the name of the closest or fastest Exchange server to your location.

 

Provide the name of the Exchange-enabled Profile Name. To get the name of the mail profile that you are using, or to create a new profile, go into Control Panel->Mail and configure a profile that uses Microsoft Exchange. This profile does NOT have to be the same profile that is used to read your mail.   The Exchange (MAPI) interface uses this profile to initialize and validate your access rights into Exchange.

 

If desired, check the option to automatically add/delete Exchange users when adding NT users. Hyena will prompt for confirmation before removing Exchange mailboxes.

 

If selecting the option to automatically add new mailboxes when adding users, you must also provide a default location for the container for newly added recipients, using a format such as the following:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container

 

The first value is the name of the organization, followed by the name of the site, followed by the name of the recipients container.

 

If you want to use a template for new accounts, enter in the full directory path to the Exchange template account, using the following format:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container/cn=TemplateDirectoryName

 

If you want to be able to select from multiple templates, separate each of them with a semicolon (";")

 

 

If you want to be prompted for the default container and template account, you can select that option as well.

 

For new Exchange recipients, you can also override the directory and home server names on the General Properties dialog.

 

To access the Exchange properties for a user, right click on the user (in any window) and select Exchange Functions->Mailbox Properties from the menu. If the user is associated with multiple Exchange mailboxes, you will be able to select the mailbox to modify from a list.

 

Limitations

 

See the Known Limitations and Issues section for a description of all known issues concerning Hyena’s Exchange integration module.

 

Exchange 2000/2003

 

To configure Exchange 2000/2003:

To create a new Mailbox Location Template:

To select the template or change other options when creating a mailbox:

For more information on how to create, modify, and delete Exchange mailboxes, see the Enterprise Features - Exchange Features topic.

Sharing Settings

 

To make Hyena easier to use between many administrators or available for use from a centralized location, a mechanism for saving all of Hyena's settings into a file is supported. Hyena also supports a command line switch for retrieving configuration information from this file.

 

To enable Hyena to use a shared settings file, enter the full directory path to the shared settings file on the Tools->Settings->General dialog.  In general, you should use a unc or network path.  To create the shared settings file, check the "Save all of these settings..." checkbox under the Tools->Settings->General dialog.  After clicking OK, the settings will be written to the file.  Hyena uses a standard Windows .INI file format. Other users who want to use these settings need to enter in the file's path and name into their Shared Settings file setting.  

 

Please note the following:

Object Manager Files and Roaming Profile Settings

 

Hyena will attempt to store and read all configuration information from the user's default profile directory.   Hyena will create a \SystemTools\Hyena folder, and store all Object Manager files (ad_*.dat), registration (Register_key.dat), and optionally, shared settings, in the profile area.  This "Roaming Profile" feature is enabled automatically, and is a requirement for the Windows NT/2000/XP logo program.

 

The location of the shared settings file, as well as the Object Manager files, can be specified and changed in the Tools->Settings->General dialog, permitting others to share the same configuration information.  

 

Specifying a shared settings file on the command line

 

Hyena can be run with the name and path to a settings file on the command line, such as:

 

Hyena \\server\share\dir\config.ini

 

If the settings file is modified while Hyena is running, it can be re-loaded without exiting Hyena by simply accessing and closing the Tools->Settings dialog.

User-defined Tools

 

Adding user-defined tools and commands to the Tools menu is fully supported. User-defined tools can be invoked either by selection from the Tools menu, or by pressing Ctrl-F1 through Ctrl-F9. Ctrl-F1 corresponds to the first user-defined tool, Ctrl-F2 for the second, etc.

 

To setup user-defined tools, select Tools->Settings->Tools. A maximum of fifty (50) custom tool commands can be defined.  Hyena stores all tool configuration information into a file named TOOL_CMDS.DAT.  Tools can also be placed into groups as follows:

When configuring a user-defined tool option or a macro command string, the command line to execute can include the following special symbols that will be replaced before execution:

 

%S% - Server Name. When used in a command line, the %S% will be replaced with the name of the current server active for the selected object.

 

Note: Leading "\\" characters in the server name will NOT be included in the command replacement. If the tool being invoked requires the leading backslashes, enter these explicitly into the command string.  See the example below.

 

%E% - Entry. When using in a command line, the %E% will be replaced with the text of the active entry for the selected object. For a selected item in the right list window, the first column will be used for the text. Use the %Cx% (see below) if a different column needs to be used.

 

%G% - Group. This option is only valid when viewing members of local or global group; it will be replaced with the name of the selected members’ group name.

 

%Cx% - Column "x". When used on selected information in the list window, replace the "x" with the number of the column to retrieve information from. For example, to use the information displayed in the third column, enter "%C3%" for the symbol.

 

%Px% - User-defined parameter. Can be used to prompt for up to three (3) parameters. Use %P1% for the first parameter, %P2% for the second, etc.

 

%Px:prompt% - User-defined parameter with custom prompt. Same as above, but adds the “prompt” text to the input dialog, so that it will be clear what is being asked for.

 

%Px:prompt/PWD% - User-defined parameter with custom password-enabled prompt. Same as above, but automatically turns on the password entry check box for security.

 

Note: The symbols MUST be entered in uppercase only.

 

 

 

Display Options

 

The Display tab on the Settings dialog allows customization of some of the view windows.

 

After first selecting the display to customize, control over the fields to display, the order of display, and the field captions can be modified.

 

Note: The display options are saved immediately upon modification; clicking OK on the Settings dialog is not necessary.

 

 

 

WOL

 

Hyena includes support for Wake-On-Lan tm (WOL) enabled computers.  See the Wake-On-Lan section for more information.

 

 

Reporting Options

 

Hyena includes both printing and reporting capabilities.

 

Printing and Reporting options only apply to items displayed in the list window.

 

 

Print Functions

 

The printing function is accessed through the File->Print menu option. The options that can be configured include the point size to be used on the printed output, and whether to print using a bold font.

 

Reporting Functions

 

Hyena includes a Microsoft Access-based reporting interface. To utilize the reporting capabilities, you need to have Microsoft Access already installed on your system.

 

Hyena will by default automatically attempt to find MSAccess.exe and use the HyenaRpt.mdb file that is in Hyena's installation directory.  To customize the locations of these files for special or shared configurations, the following options can be provided on the Tools->Settings->Reporting dialog:

 

Path to MSAccess.exe- Provide a path to the MSAccess.exe program, such as j:\apps\microsoftoffice\office. You can leave this option blank to have Hyena attempt to find MSAccess.exe.

 

Path to HyenaRpt.mdb report database – Hyena’s installation program installs the HyenaRpt.mdb database into the default Hyena installation directory.  If this setting is left blank, Hyena will use the .mdb file in the installation directory.  You can provide an alternate directory path here, or move the HyenaRpt.mdb file to a central network location.

 

To generate a report, first display some information in Hyena’s right list window. Then, select Tools->Run Report… from the menu.

 

 

Licensing Settings

 

The licensing settings display the active Hyena License, as well as any license options, such as Exchange, Terminal Server, and the current maintenance expiration date.

 

Remote Control Settings

 

The SystemTools Remote Control Manager (STRCM) provides for a way to manage some remote control software products from within Hyena.  The STRCM supports installation, configuration, viewing, and uninstallation of remote control software, including VNC-based products.  See the Remote Control topic for more information about the STRCM.

 

The individual configuration files (.rcm) can be viewed and modified from the Tools->Settings->Remote dialog.

 

Hyena supports sharing of Remote Control configuration (.RCM) files.  To share these files with other Hyena users, enter a network path location for the ".RCM file configuration directory" setting.

 

Exchange Options and Setup

 

Hyena’s Exchange 5.5 and Exchange 2000/2003 interfaces are to add, modify, and delete Exchange mailboxes that have associated Windows NT/Windows 2000/2003 user accounts.

 

The only installation prerequisite for using the Exchange integration options in Hyena is that you must have already installed the Microsoft Exchange Administrator program on your client workstation. If you can already manage Exchange recipients from your workstation, then this probably has already been done. Hyena requires the use of certain DLLs for these functions; Microsoft does not allow 3rd party software developers to redistribute these files.

 

Important Note: Hyena’s Microsoft Exchange integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow Exchange information to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Exchange features to be fully evaluated before any additional licenses for it are purchased. For more information on the licensing of the Enterprise Edition, see the Licensing topic.

 

Exchange 5.5 Options

 

Configuration to use Default User Manager Interface

 

Hyena includes two (2) different interfaces into Microsoft Exchange 5.5. The first interface (the default) uses exactly the same interface that Window NT’s own User Manager for Domains uses into Exchange. To configure Hyena to use this interface, go into Tools->Settings->Exchange and enable the Enable User Manager Extensions for Exchange Integration option. If this option is changed, Hyena must be restarted. As long as the Exchange Administrator program is installed on the computer that Hyena is being run on, then the existing User Manager configuration will be used. Note that there will be an “Exchange” option on the main menu bar, plus an Exchange Functions menu on all context menus for users.

 

 Configuration to use Hyena’s Custom Interface

 

Hyena also includes its own custom Exchange 5.5 interface. This interface does have some limitations, but also some advantages over the built-in User Manager interface. To configure Hyena to use this interface, go into Tools->Setting->Exchange, and follow these steps:

 

Enable Exchange integration, by enabling the “Enable Hyena’s Custom Exchange Integration Options” checkbox. If Exchange integration is being enabled for the first time, you must restart Hyena before you will be able to have access to the Exchange options.

 

Provide the name of your local Exchange server for the value in “Exchange Server for Directory Operations”. This is sometimes referred to as the “DSA”.  If your site has multiple Exchange servers, enter in the name of the closest or fastest Exchange server to your location.

 

Provide the name of the Exchange-enabled Profile Name. To get the name of the mail profile that you are using, or to create a new profile, go into Control Panel->Mail and configure a profile that uses Microsoft Exchange. This profile does NOT have to be the same profile that is used to read your mail.   The Exchange (MAPI) interface uses this profile to initialize and validate your access rights into Exchange.

 

If desired, check the option to automatically add/delete Exchange users when adding NT users. Hyena will prompt for confirmation before removing Exchange mailboxes.

 

If selecting the option to automatically add new mailboxes when adding users, you must also provide a default location for the container for newly added recipients, using a format such as the following:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container

 

The first value is the name of the organization, followed by the name of the site, followed by the name of the recipients container.

 

If you want to use a template for new accounts, enter in the full directory path to the Exchange template account, using the following format:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container/cn=TemplateDirectoryName

 

If you want to be able to select from multiple templates, separate each of them with a semicolon (";")

 

 

If you want to be prompted for the default container and template account, you can select that option as well.

 

For new Exchange recipients, you can also override the directory and home server names on the General Properties dialog.

 

To access the Exchange properties for a user, right click on the user (in any window) and select Exchange Functions->Mailbox Properties from the menu. If the user is associated with multiple Exchange mailboxes, you will be able to select the mailbox to modify from a list.

 

Limitations

 

See the Known Limitations and Issues section for a description of all known issues concerning Hyena’s Exchange integration module.

 

Exchange 2000/2003

 

To configure Exchange 2000/2003:

To create a new Mailbox Location Template:

To select the template or change other options when creating a mailbox:

For more information on how to create, modify, and delete Exchange mailboxes, see the Enterprise Features - Exchange Features topic.

User-defined Tools

 

Adding user-defined tools and commands to the Tools menu is fully supported. User-defined tools can be invoked either by selection from the Tools menu, or by pressing Ctrl-F1 through Ctrl-F9. Ctrl-F1 corresponds to the first user-defined tool, Ctrl-F2 for the second, etc.

 

To setup user-defined tools, select Tools->Settings->Tools. A maximum of fifty (50) custom tool commands can be defined.  Hyena stores all tool configuration information into a file named TOOL_CMDS.DAT.  Tools can also be placed into groups as follows:

When configuring a user-defined tool option or a macro command string, the command line to execute can include the following special symbols that will be replaced before execution:

 

%S% - Server Name. When used in a command line, the %S% will be replaced with the name of the current server active for the selected object.

 

Note: Leading "\\" characters in the server name will NOT be included in the command replacement. If the tool being invoked requires the leading backslashes, enter these explicitly into the command string.  See the example below.

 

%E% - Entry. When using in a command line, the %E% will be replaced with the text of the active entry for the selected object. For a selected item in the right list window, the first column will be used for the text. Use the %Cx% (see below) if a different column needs to be used.

 

%G% - Group. This option is only valid when viewing members of local or global group; it will be replaced with the name of the selected members’ group name.

 

%Cx% - Column "x". When used on selected information in the list window, replace the "x" with the number of the column to retrieve information from. For example, to use the information displayed in the third column, enter "%C3%" for the symbol.

 

%Px% - User-defined parameter. Can be used to prompt for up to three (3) parameters. Use %P1% for the first parameter, %P2% for the second, etc.

 

%Px:prompt% - User-defined parameter with custom prompt. Same as above, but adds the “prompt” text to the input dialog, so that it will be clear what is being asked for.

 

%Px:prompt/PWD% - User-defined parameter with custom password-enabled prompt. Same as above, but automatically turns on the password entry check box for security.

 

Note: The symbols MUST be entered in uppercase only.

 

 

 

Display Options

 

The Display tab on the Settings dialog allows customization of some of the view windows.

 

After first selecting the display to customize, control over the fields to display, the order of display, and the field captions can be modified.

 

Note: The display options are saved immediately upon modification; clicking OK on the Settings dialog is not necessary.

 

 

 

WOL

 

Hyena includes support for Wake-On-Lan tm (WOL) enabled computers.  See the Wake-On-Lan section for more information.

 

 

Reporting Options

 

Hyena includes both printing and reporting capabilities.

 

Printing and Reporting options only apply to items displayed in the list window.

 

 

Print Functions

 

The printing function is accessed through the File->Print menu option. The options that can be configured include the point size to be used on the printed output, and whether to print using a bold font.

 

Reporting Functions

 

Hyena includes a Microsoft Access-based reporting interface. To utilize the reporting capabilities, you need to have Microsoft Access already installed on your system.

 

Hyena will by default automatically attempt to find MSAccess.exe and use the HyenaRpt.mdb file that is in Hyena's installation directory.  To customize the locations of these files for special or shared configurations, the following options can be provided on the Tools->Settings->Reporting dialog:

 

Path to MSAccess.exe- Provide a path to the MSAccess.exe program, such as j:\apps\microsoftoffice\office. You can leave this option blank to have Hyena attempt to find MSAccess.exe.

 

Path to HyenaRpt.mdb report database – Hyena’s installation program installs the HyenaRpt.mdb database into the default Hyena installation directory.  If this setting is left blank, Hyena will use the .mdb file in the installation directory.  You can provide an alternate directory path here, or move the HyenaRpt.mdb file to a central network location.

 

To generate a report, first display some information in Hyena’s right list window. Then, select Tools->Run Report… from the menu.

 

 

Licensing Settings

 

The licensing settings display the active Hyena License, as well as any license options, such as Exchange, Terminal Server, and the current maintenance expiration date.

 

Remote Control Settings

 

The SystemTools Remote Control Manager (STRCM) provides for a way to manage some remote control software products from within Hyena.  The STRCM supports installation, configuration, viewing, and uninstallation of remote control software, including VNC-based products.  See the Remote Control topic for more information about the STRCM.

 

The individual configuration files (.rcm) can be viewed and modified from the Tools->Settings->Remote dialog.

 

Hyena supports sharing of Remote Control configuration (.RCM) files.  To share these files with other Hyena users, enter a network path location for the ".RCM file configuration directory" setting.

 

Exchange Options and Setup

 

Hyena’s Exchange 5.5 and Exchange 2000/2003 interfaces are to add, modify, and delete Exchange mailboxes that have associated Windows NT/Windows 2000/2003 user accounts.

 

The only installation prerequisite for using the Exchange integration options in Hyena is that you must have already installed the Microsoft Exchange Administrator program on your client workstation. If you can already manage Exchange recipients from your workstation, then this probably has already been done. Hyena requires the use of certain DLLs for these functions; Microsoft does not allow 3rd party software developers to redistribute these files.

 

Important Note: Hyena’s Microsoft Exchange integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow Exchange information to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Exchange features to be fully evaluated before any additional licenses for it are purchased. For more information on the licensing of the Enterprise Edition, see the Licensing topic.

 

Exchange 5.5 Options

 

Configuration to use Default User Manager Interface

 

Hyena includes two (2) different interfaces into Microsoft Exchange 5.5. The first interface (the default) uses exactly the same interface that Window NT’s own User Manager for Domains uses into Exchange. To configure Hyena to use this interface, go into Tools->Settings->Exchange and enable the Enable User Manager Extensions for Exchange Integration option. If this option is changed, Hyena must be restarted. As long as the Exchange Administrator program is installed on the computer that Hyena is being run on, then the existing User Manager configuration will be used. Note that there will be an “Exchange” option on the main menu bar, plus an Exchange Functions menu on all context menus for users.

 

 Configuration to use Hyena’s Custom Interface

 

Hyena also includes its own custom Exchange 5.5 interface. This interface does have some limitations, but also some advantages over the built-in User Manager interface. To configure Hyena to use this interface, go into Tools->Setting->Exchange, and follow these steps:

 

Enable Exchange integration, by enabling the “Enable Hyena’s Custom Exchange Integration Options” checkbox. If Exchange integration is being enabled for the first time, you must restart Hyena before you will be able to have access to the Exchange options.

 

Provide the name of your local Exchange server for the value in “Exchange Server for Directory Operations”. This is sometimes referred to as the “DSA”.  If your site has multiple Exchange servers, enter in the name of the closest or fastest Exchange server to your location.

 

Provide the name of the Exchange-enabled Profile Name. To get the name of the mail profile that you are using, or to create a new profile, go into Control Panel->Mail and configure a profile that uses Microsoft Exchange. This profile does NOT have to be the same profile that is used to read your mail.   The Exchange (MAPI) interface uses this profile to initialize and validate your access rights into Exchange.

 

If desired, check the option to automatically add/delete Exchange users when adding NT users. Hyena will prompt for confirmation before removing Exchange mailboxes.

 

If selecting the option to automatically add new mailboxes when adding users, you must also provide a default location for the container for newly added recipients, using a format such as the following:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container

 

The first value is the name of the organization, followed by the name of the site, followed by the name of the recipients container.

 

If you want to use a template for new accounts, enter in the full directory path to the Exchange template account, using the following format:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container/cn=TemplateDirectoryName

 

If you want to be able to select from multiple templates, separate each of them with a semicolon (";")

 

 

If you want to be prompted for the default container and template account, you can select that option as well.

 

For new Exchange recipients, you can also override the directory and home server names on the General Properties dialog.

 

To access the Exchange properties for a user, right click on the user (in any window) and select Exchange Functions->Mailbox Properties from the menu. If the user is associated with multiple Exchange mailboxes, you will be able to select the mailbox to modify from a list.

 

Limitations

 

See the Known Limitations and Issues section for a description of all known issues concerning Hyena’s Exchange integration module.

 

Exchange 2000/2003

 

To configure Exchange 2000/2003:

To create a new Mailbox Location Template:

To select the template or change other options when creating a mailbox:

For more information on how to create, modify, and delete Exchange mailboxes, see the Enterprise Features - Exchange Features topic.

Displaying Terminal Server/Citrix User Properties

 

Important Note: Hyena’s Terminal Server integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow terminal server user settings to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Terminal Server features to be fully evaluated before any additional licenses for it are purchased.  For more information on the licensing of the Enterprise Edition, see the Licensing and How to Order section.

 

References to "Terminal Server" in this document also apply to Citrix installations as well.

 

 

Setting up Hyena to Access Terminal Server User Properties

 

Microsoft has added the interfaces for accessing terminal server user settings through a .DLL named “wtsapi32.dll”.  This file is part of service pack 4 for Windows Terminal Server.  It is highly recommended that any computer with user account information to be updated using this interface be upgraded to service pack 4 or later.

 

There are two methods to use Hyena to modify Terminal Server user information:

 

Install Hyena onto the terminal server itself, and connect to it through your workstation through a terminal server client connection.  If your terminal server has sp4 installed, you should be able to see the "Terminal" tab on the user properties dialog.

 

 - or -

 

Copy the following files into Hyena's installation or your workstation's system (System32) directory, which can be found in the system32 directory of a Terminal Server:

 

wtsapi32.dll

utildll.dll

winsta.dll

regapi.dll

 

Microsoft does not allow third party software developers to re-distribute these files.  You will only find the wtsapi32.dll file if the Terminal Server is using service pack 4 or later.

 

Note that the icon used in Hyena for terminal server computers has been modified for easier identification of these servers.

 

Check to make sure that Hyena's installation directory is the working directory when you are using Hyena, and restart Hyena if necessary.  You will then be able to modify any user's terminal server settings, by simply displaying the user Properties dialog, and selecting the "Terminal" tab.

 

Accessing User Terminal Server Properties

 

The terminal server options for a user are accessed through the User Properties dialog by going to the "Terminal" tab, as show in the image below.

 

 

The terminal dialog provides for full access to profile, home directory, and session settings.  Hyena's Home Directory Management features are available for terminal server home directories.

 

Active Directory Integration

 

Windows 2000 Users Only: Terminal Server (TSE) user settings are not stored in individual attributes in Active Directory, but instead are stored in one attribute that does not permit direct viewing of its contents.  Hyena allows the user TSE fields, however, to be included into Hyena's Active Directory queries.  

 

To include one or more TSE fields into an Active Directory query, access the File->Manage Object View->Queries dialog, and either create a new Users query or modify an existing query that displays user-related information.  To add the TSE attributes, select Terminal Server Attributes from the Attribute Category.

 

TSE information is extremely slow to retrieve, therefore it is recommended that a special query be created to display only the minimal information required.  Do NOT add TSE fields to a default query for any view or Hyena's overall performance will be severely affected.

 

Home Directory Templates

 

Hyena’s home directory template capability allows control over the creation of the home directory, home directory share, and both NTFS and share security.  To configure home directory templates, select the Tools->Settings->Home Dir option.  Hyena will automatically configure a default template, named “Default”.  However, it must be configured prior to being used.  Hyena will use a template anytime a home directory or home directory share must be created.  The home directory configuration dialog will display all defined templates, plus the following settings:

 

Default Template for standard user profiles – Select the name of the template to use for home directories that are specified on the User Profile dialog.  Select “(None)” to disable any template from being used.

 

Default Template for Terminal Server profiles – Select the name of the template to use for home directories that are specified for use by Terminal Server.  Select “(None)” to disable any template from being used.

 

Confirm template prior to usage (when adding users) – If unchecked, Hyena will automatically use the designated default template when adding new users. When this option is enabled, Hyena will prompt for the template to use when adding new users.  This prompt will appear BEFORE the user properties dialog is displayed.  The selection of a template will configure the default home directory information on the Profile properties tab.  When the user is actually added, the same template will be used to configure home share and security settings.  Hyena will then re-prompt again for the template to use for the next user to be added.  A check box on the bottom of the template confirmation dialog can be enabled to make Hyena use the same template for the entire user adding session.

 

Confirm template prior to usage (when copying users) – If unchecked, Hyena will automatically use the designated default template when copying users.  Note that if the user being copied does not already have a home directory setting, Hyena will not automatically assign the new user a home directory.  Hyena will only use a template for creation of a home directory (and security) if a home directory is specified or modified on the user profile dialog when copying users.

 

NOTE: When users are being modified, Hyena will always prompt for the template to use.

 

 

 

Template Definitions

 

From the home directory configuration dialog, use the “New” button to create a new template, or the “Copy” button to copy an existing template.  In order to better understand how to configure a home directory template, consult the home directory definitions below for home directories and home directory shares, and then view the associated diagram.

 

User home directories can take two different formats in Windows, which are described as follows.   Hyena will automatically determine what type of user home directory format is being used and apply the necessary changes, however, the template itself must be configured according to what type of home directory is being used.

 

Home Directories

 

User home directories use the format \\servername\sharename\directorypath when entered into a user’s home directory user profile.  These type of home directories utilize a common sharename for all user accounts, with each user having their own unique directory path. Typically, the directory path portion of the home directory consists of the user name for ease of administration and identification.

 

Note: Hyena will not create the share that is part of the sharename portion of a home directory; only the last directory in the directory path will be created.

 

If this is the type of home directory format in use in your installation, consult the diagram and example below on how to configure the template for their use.

 

 

Template Name – Enter the name to use for the template.

 

New Home Directory Mask – Enter in a mask to use as a default home directory setting when adding new users.  The symbol “%username%” can be used to represent the current user.  In the example above, a setting of \\hyena2000\users\%username% would give all newly created users a home directory with a directory name equal to the user account, under a share named “users” on the server named “hyena2000”.   In effect, all users will share the same share (named “users”), but each will have a unique directory (folder) for their home directory, under this common share.

 

Note that this setting is ONLY used for new users, and only to configure a default home directory “Connect To” path; this path can be changed is necessary.  This setting is not used when modifying or copying users.

 

Drive – Enter in a drive letter to use as a default home directory mapping when adding new users.

 

Share Directory Local Mask – This setting does not apply for shared directories; it only is applicable when unique shares are created for each user home directory.  See the Home Shares section below for more information.

 

Share Directory Remote Mask – This setting does not apply for shared directories; it only is applicable when unique shares are created for each user home directory.  See the Home Shares section below for more information.

 

Security Settings – The symbol “%username%” can be used to represent the current user.  Options are also available to overwrite any existing security settings, or warn (verify) before overwriting.   If left empty, the home directory itself would be granted the same security as the parent directory. For better security control, it is advisable to explicitly specify security settings, rather than rely upon this default behavior.

 

After creating home directory run – See the Post User Batch Procedure section for more information about this option.

 

Home Shares

 

User home shares use the format \\servername\sharename when entered into a user’s home directory user profile.  These type of home directories require a unique sharename for each user account.  Typically, the user name is used for the name of the share, which is optionally hidden by placing a $ at the end of the share name.  Hyena can create both the share and the underlying shared directory when copying and creating user accounts.  If this is the type of home directory format in use in your installation, consult the diagram and example below on how to configure the template for their use.

 

 

Template Name – Enter the name to use for the template.

 

New Home Directory Mask – Enter in a mask to use as a default home directory setting when adding new users.  The symbol “%username%” can be used to represent the current user.  In the example above, a setting of \\hyena2000\%username% would give all newly created users a home directory share on the server named “hyena2000”, and set the share name to the name of the new user.  A “$” sign can be added to the end of the share name to create a hidden share.  Note that this setting is ONLY used for new users, and only to configure a default home directory “Connect To” path; this path can be changed is necessary.  This setting is not used when modifying or copying users.  When copying users, the home directory path/share of the user being copied is used instead.

 

Drive – Enter in a drive letter to use as a default home directory mapping when adding new users.

 

Share Directory Local Mask – Use this setting to control the format to be used for the local directory path when creating a home share.  Windows requires that all shares be assigned a LOCAL path when they are created remotely.  For example, if a user’s home directory profile specifies a home directory of \\HomeServer\JSmith, the share Jsmith must be assigned to a local (physical) drive and directory on the server named HomeServer, such as E:\Users\%username%.  It is important to use the remote server’s exact local drive letter and  directory path for this setting.  The symbol %username% can be used to specify the name of the active user.  If you are unsure of the local path for a user’s home directory, simply view the Path setting for an existing user’s share on that server.

 

Share Directory Remote Mask – Use this setting to specify a remote UNC path to the directory that will need to be created for the user’s home directory.  Using the example above, if the local directory mask is E:\Users\%username%, the remote mask could be something like \\hyena2000\e$\users\%username%.  Hyena will use this remote mask to remotely create the user’s home directory prior to creating the share.  The symbol %homedirserver% can be used in place of the server and will be substituted with the name of the server specified as the location of the home directory in the active user’s profile. This setting is only used to create the directory for the remote home directory share.

 

Security Settings – Security settings can be configured for either the home directory, home directory share, or both.  The symbol “%username%” can be used to represent the current user.  Options are also available to overwrite any existing security settings, or warn (verify) before overwriting.   If left empty, the home directory itself would be granted the same security as the parent directory, and the share would be given Everyone:Full Control.  For better security control, it is advisable to explicitly specify security settings, rather than rely upon this default behavior.

 

After creating home directory run – See the Post User Batch Procedure section for more information about this option.

 

Setting Owner and Inheritance

 

Use the Set Owner... and Set Inheritance... buttons to configure the owner and/or inheritance options for newly created home directories.  

 

Owner options include allowing the owner to be the same as the parent, forcing the owner to be the 'Administrators' group, or setting the owner to be the same as the user (%username%).

 

Inheritance options affect whether the directory will inherit the parent's security permissions.

 

User Home Directory and Profile Deletion

 

Hyena provides a powerful method to manage user home directory and profile contents, as well as deletion of their contents with the Home Directory and User Profile Management feature.  This feature is accessed on the user context menu, by selecting Account Functions->Profile/Home Directory Admin.  See the Home Directory and User Profile Management section for more information.

 

Post User Batch Procedures

 

A batch file can be specified in the Template Definition dialog that can be used to set additional user and/or group permissions automatically when a new user is added or a home directory is first specified, or to perform any other custom site-specific processing.

 

This batch file can contain any number of commands.  To specify a command to add, for example, the "Domain Admins" global group to the user's home directory with Full Control, use this command:

 

echo y|cacls %1 /e /g "Domain Admins":F

 

Hyena passes six (6) parameters to the batch procedure that you specify:

 

%1 - name of the directory being created (the home directory exactly as entered on the User Profile dialog).
 

%2 - name of the newly created/modified user

 

%3 - name of the server sharing the directory, without leading backslashes.

 

%4 - name of the home directory share

 

%5 - name of the directory path following the share name.  For example, if the home directory name is \\server\sharename\directory, then this value will be “directory”.  If the home directory is \\server\sharename, this value will be “NONE”.

 

%6 – path to the root share representing the home directory.  For example, if the home directory name is \\server\sharename, then this value will be the root share path to the “sharename” share, such as D$\users\directory.

 

Hyena will only run this batch procedure if it creates the home directory.  Additional help on the cacls command can be found by entering the "cacls" command at the command prompt, in NT's resource kits, and on TechNet.  Articles Q135268 and Q131780 are good references for the information presented here.

 

A final note: If your environment has more than one domain controller, then it's possible that the newly added user will not be known to all of the domain controllers until they are fully synchronized.  While synchronization does happen automatically, it can take a few minutes to complete.  During this time, the permissions on a newly created home directory may show "Account Unknown".  Once the domain controllers synchronize the Account Unknown entry will be replaced with the actual username.

Remote Control Settings

 

The SystemTools Remote Control Manager (STRCM) provides for a way to manage some remote control software products from within Hyena.  The STRCM supports installation, configuration, viewing, and uninstallation of remote control software, including VNC-based products.  See the Remote Control topic for more information about the STRCM.

 

The individual configuration files (.rcm) can be viewed and modified from the Tools->Settings->Remote dialog.

 

Hyena supports sharing of Remote Control configuration (.RCM) files.  To share these files with other Hyena users, enter a network path location for the ".RCM file configuration directory" setting.

 

Exchange Options and Setup

 

Hyena’s Exchange 5.5 and Exchange 2000/2003 interfaces are to add, modify, and delete Exchange mailboxes that have associated Windows NT/Windows 2000/2003 user accounts.

 

The only installation prerequisite for using the Exchange integration options in Hyena is that you must have already installed the Microsoft Exchange Administrator program on your client workstation. If you can already manage Exchange recipients from your workstation, then this probably has already been done. Hyena requires the use of certain DLLs for these functions; Microsoft does not allow 3rd party software developers to redistribute these files.

 

Important Note: Hyena’s Microsoft Exchange integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow Exchange information to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Exchange features to be fully evaluated before any additional licenses for it are purchased. For more information on the licensing of the Enterprise Edition, see the Licensing topic.

 

Exchange 5.5 Options

 

Configuration to use Default User Manager Interface

 

Hyena includes two (2) different interfaces into Microsoft Exchange 5.5. The first interface (the default) uses exactly the same interface that Window NT’s own User Manager for Domains uses into Exchange. To configure Hyena to use this interface, go into Tools->Settings->Exchange and enable the Enable User Manager Extensions for Exchange Integration option. If this option is changed, Hyena must be restarted. As long as the Exchange Administrator program is installed on the computer that Hyena is being run on, then the existing User Manager configuration will be used. Note that there will be an “Exchange” option on the main menu bar, plus an Exchange Functions menu on all context menus for users.

 

 Configuration to use Hyena’s Custom Interface

 

Hyena also includes its own custom Exchange 5.5 interface. This interface does have some limitations, but also some advantages over the built-in User Manager interface. To configure Hyena to use this interface, go into Tools->Setting->Exchange, and follow these steps:

 

Enable Exchange integration, by enabling the “Enable Hyena’s Custom Exchange Integration Options” checkbox. If Exchange integration is being enabled for the first time, you must restart Hyena before you will be able to have access to the Exchange options.

 

Provide the name of your local Exchange server for the value in “Exchange Server for Directory Operations”. This is sometimes referred to as the “DSA”.  If your site has multiple Exchange servers, enter in the name of the closest or fastest Exchange server to your location.

 

Provide the name of the Exchange-enabled Profile Name. To get the name of the mail profile that you are using, or to create a new profile, go into Control Panel->Mail and configure a profile that uses Microsoft Exchange. This profile does NOT have to be the same profile that is used to read your mail.   The Exchange (MAPI) interface uses this profile to initialize and validate your access rights into Exchange.

 

If desired, check the option to automatically add/delete Exchange users when adding NT users. Hyena will prompt for confirmation before removing Exchange mailboxes.

 

If selecting the option to automatically add new mailboxes when adding users, you must also provide a default location for the container for newly added recipients, using a format such as the following:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container

 

The first value is the name of the organization, followed by the name of the site, followed by the name of the recipients container.

 

If you want to use a template for new accounts, enter in the full directory path to the Exchange template account, using the following format:

 

/o=Exchange Organization/ou=Exchange Site/cn=Recipients Container/cn=TemplateDirectoryName

 

If you want to be able to select from multiple templates, separate each of them with a semicolon (";")

 

 

If you want to be prompted for the default container and template account, you can select that option as well.

 

For new Exchange recipients, you can also override the directory and home server names on the General Properties dialog.

 

To access the Exchange properties for a user, right click on the user (in any window) and select Exchange Functions->Mailbox Properties from the menu. If the user is associated with multiple Exchange mailboxes, you will be able to select the mailbox to modify from a list.

 

Limitations

 

See the Known Limitations and Issues section for a description of all known issues concerning Hyena’s Exchange integration module.

 

Exchange 2000/2003

 

To configure Exchange 2000/2003:

To create a new Mailbox Location Template:

To select the template or change other options when creating a mailbox:

For more information on how to create, modify, and delete Exchange mailboxes, see the Enterprise Features - Exchange Features topic.

Ping Options

 

One of the annoying features of remote administration of Windows is the delay in waiting for the RPC timeout to return control back to the user when an attempt is made to access a remote computer that is offline or not responding.  Applications, such as Hyena, are unable to set a RPC timeout, and are also blocked by the operating system from aborting the connection attempt on their own.  

 

Hyena has an option to offer some relief from this problem, by allowing for a brief ping to be sent to the remote computer prior to initiating any remote action.  To configure or enable this option, select the "Enable Ping Support" under Tools->Settings->View.

 

For various technical/logical reasons, Hyena cannot determine what actions a user may be intending to perform on a computer at any given time.   Moreover, Hyena cannot attempt to perform a ping action once another action, such as viewing a remote computer's services, has been initiated.

 

To provide for an option to alert the user that a remote computer may be offline, that is, it has failed to respond to a ping in the user-configured timeout period, Hyena can initiate the ping whenever the remote computer is selected.  This includes when the computer object is clicked on, expanded in the left window, or right-clicked on.  The ping is carried out in a separate thread (with slightly higher priority).

 

The results of the ping will be displayed in the status bar.  A beep can also be configured to be sent when the ping fails.  By initiating the ping this way, the ping will be started during the time that the user takes to start a remote action by selecting that action from a menu or object selection.  Ideally, by the time the action is selected, the ping will have completed (if a reasonable timeout is configured) and the user can decide whether they want to carry out the desired operation.

 

Setting Ping Options

 

Click the Ping Options button to configure specific ping settings.

 

Ping Type - Windows supports sending a ping two different ways.  Generally, the raw sockets method should work in most environments, however if the ping is unsuccessful on a computer that can be accessed, try changing the ping type.  Restart Hyena after changing the ping type.

 

Timeout / TTL / Buffer Size - Set these values to best suit your network environment.  The ping packet that is sent by default is 32 bytes long; only one ping is sent.

 

Play sound (beep) when ping fails - Enable this option to play the standard Windows error sound when a ping fails.

 

Show ping results on status bar - Enable this option to show the results (performance) of the ping.

 

Cancel remote operation/function if ping fails - If this option is set, Hyena will not attempt an operation on a computer that fails to respond to a ping.  If this option is NOT set, Hyena will initiate the ping and if it fails, display a failure message on the status bar; however, Hyena will not abort or stop any operation that is requested.

 

Use Netbios name (instead of DNS) for ping functions - Enable this option to force Hyena to use the Netbios name (instead of the DNS name) when attempting to ping a computer that is part of an Active Directory domain.  By default, Hyena will use the value of the 'dnshostname' Active Directory attribute for the target address of any ping operations.

Object Manager - General

 

The Object Manager is Hyena's central control mechanism for controlling the way that domains, computers, and other objects are managed in Hyena.  The Object Manager provides for flexible grouping of domains, computers, printers, directories, and urls into visual "folders".  This allows administrators to create a custom view of their organization's network, which in turn provides for a fast and efficient method of accessing these resources.  It also provides for an efficient way to access resources over a slow WAN link, from a non-trusted source, or through the internet.  

 

The Object Manager also controls the sub-objects, or "nodes" that Hyena displays beneath some objects when expanded in Hyena's left tree window.   Finally, the attributes that are displayed for Active Directory queries are also controlled through the Object Manager.  

 

Object Manager File Storage Locations

 

Object Manager stores all of the information in a series of simple text files.  This facilitates sharing of the files between multiple Hyena users, as well as roaming profile support.  Object Manager files can be shared between multiple users by specifying a path for the "Path to Object Manager..." setting in the Tools->Settings->General dialog.  The files used by Object Manager are:

 

ad_objects.dat - This is the main Object Manager file, which stores all of the information that is managed on the Objects dialog in Object Manager.

 

ad_schema.dat - The schema file is used to store the directory names and default field titles used in building views.  The schema file is never modified by Object Manager and is overwritten on each Hyena installation, as support for new directory elements are added.

 

ad_nodes.dat - The nodes file contains the listing of the sub-objects that appear beneath any object when it is expanded in Hyena's left tree window.

 

ad_columns.dat - The columns file contains customized user attribute field titles and column widths.  It is created automatically by Hyena.

 

ad_queries.dat - The queries file contains all of the queries used to generate the Listing and Tabular views.

 

perf_counters.dat - This file contains customized performance counter information, such as divisor, suffix, and title.

 

perf_queries.dat - This file contains all of the performance queries and their counters.

 

register_key.dat - This file contains the Hyena licensing information, which is also stored in the registry.

 

The active versions of these files can be found in the <profiledir>\Application Data\SystemTools\Hyena directory.  The versions in Hyena's installation directory are the default versions of this file, which are copied into the user's profile directory automatically when Hyena is first used.

 

The Object Manager can be accessed on Hyena's toolbar , or through the File->Manage Object View menu option.  The Object Manager's five (5) management dialogs consist of the Objects, Nodes, Queries, Performance, and Custom dialogs.  

 

TIP - Make a periodic backup of these files to save Hyena's object configuration information.

Object Manager - Objects

 

Managing Objects

 

Note: For General information about Hyena's Object Manager, click here.

 

The Object Manager supports many different types of objects.  Depending upon the type of object, different elements may need to be entered.   All object types, however, support a comment field, which is always displayed next to the object name in Hyena.  The different types of objects that Hyena supports, and what needs to be entered into each Object Manager field is as follows:

 

Windows 2000/2003 Domain / Container / OU - Enter any name and comment desired.  For the Path, enter in the full LDAP path to the directory object.  Use the browser button (...) to help format the path.  For Windows 2000/2003 domains, an optional Server can be specified to improve performance.

 

Windows Domain - Enter the name of the domain in for the Name.  Optionally, enter the name of a local BDC for the Source Controller to improve performance, and/or the name of the PDC for the PDC Name.  See the Performance section for more information on these settings.

 

Windows 2000/2003 Domain Controller / Server / Workstation - Enter any name and comment desired for the server or workstation.  For the Computer Path, enter the NetBios name (or DNS path) of the computer.  An ip address may also be entered for the path if name resolution is not available.

 

Printer - Enter any name and comment desired for the printer.  For the Printer Path, supply a full path to the printer, for example \\PrintServer\Printer Name, or \\PrintServer\PrinterShareName.  Printers do not have to be shared.

 

Object Grouping - Enter any name and comment desired to name the grouping.  Grouping are explained in detail below under Other Operations.

 

Directory Path - Enter any name and comment desired for the directory.  For the Directory Path, enter in the full unc-based path to the directory, for example \\server\share\directory.

 

Local Workstation - Enter any name and comment desired for the local computer.   Hyena will automatically use the name of the local computer for this object's path.

 

URL - Enter any name and comment desired for the url.  For the Address, enter in the exact internet address, such as http://www.systemtools.com.

 

Enterprise - Enter any name and comment desired for the Enterprise object.  This object is used to browse Windows, Novell, and other network systems, using standard Windows network browsing capabilities.

 

External Object List - Enter any display name and comment for the External Object List.  For the Path, enter in the local or network path to the external object list.  

 

External Object Lists are used to break the Object Manager file (and the view used to manage this file) into smaller pieces for easier and more modular management.  See the External Object Lists topic for more information about how to use and configure this capability.

 

Creating, Modifying, and Deleting Objects

 

To create a new entry, first click the New button, select an object type, complete the appropriate fields for the type of object being added, then click on the Add button.

 

To modify an existing entry, select the object from the object list, modify the desired fields, then click the Update button.

 

To delete entries from the Object Manager, first select the object(s) to delete, then click the Delete button.

 

Other Operations

 

Creating Object Groups - Object Groupings are used to group and organize other objects together.  To create a group, first create a new object with the type of "Object Grouping".  Then position the objects beneath the Object Grouping entry, select the objects, and then click the Right button.  Use the Left button to move selected entries from beneath a group.

 

 

In the example above, the Storage, Downloads, and HP Color objects have been moved under the RESOURCE2000 domain entry and indented to the right to show that they are sub-objects under the RESOURCE2000 domain.  Objects can be grouped and nested up to four (4) levels.

 

Moving Objects - One or more entries in the Object Manager window can be moved up or down using either the Up or Down buttons, or by selecting the objects to be moved, and dragging them with the mouse to the new position.  Multiple objects can be selected and moved at the same time.  Objects can also be moved by entering the new position number in the Move To field, then clicking the Move To button.  The currently selected object's position is always displayed in the Object Information area.  When moving objects, clicking on the Move Children with Parent Objects option will automatically move all children when the parent is moved.

 

Sorting - Use the Sort button to sort the selected entries by Object Name.

 

Importing Domains - To import one or more domains into the Object Manager list, use the Import Domains button.

 

Importing Quick Access files from previous versions - Use the Import Quick Access button to allow the Quick Access (Q*.dat) files used by previous versions of Hyena to be imported into the new Object Manager format.

 

Tip - If a different security context is needed to access a computer, right click on the computer, and select the Logon As option. Enter the name of a domain or server and a valid username/password. Hyena will then establish a connection to the computer using an alternate security context.

 

Object Manager - Nodes

 

Managing Nodes

 

Note: For General information about Hyena's Object Manager, click here.

 

Hyena's Object Manager provides support for managing the sub-items, or nodes, that appear beneath objects in Hyena's left tree window.  To configure Hyena's object nodes, first access the Object Manager, then change to the Nodes tab:

 

 

To disable a node, first expand the primary object, then click the Disable button.  Nodes can also be moved up or down.  Disabled nodes will not appear in Hyena, but can be re-enabled in the Object Manager->Nodes dialog.

Object Manager - Queries

 

Managing Queries

 

Note: For General information about Hyena's Object Manager, click here.

 

Hyena's Windows 2000 support is built around a very flexible and powerful query engine that is used to retrieve and display all Active Directory (AD) information.  All user, group, and computer retrieval functions use this same query mechanism.

 

To create new AD queries or modify the existing queries that Hyena relies upon, use the Object Manager (File->Manage Object View).  The AD queries are managed on the Queries dialog.

 

Queries are object-type specific, meaning that a query that applies for user objects may not be applicable to a group object.  To add or modify a query for a given AD object type, first select the type of object from the Query Type list.  Any existing queries defined for that object type will be listed in the Current Queries list.  

 

When Hyena is installed, over two dozen default pre-configured queries are automatically provided.

 

Query Display Formats

 

Query output can be displayed and viewed in either a "Listing" or "Tabular" format.  Each type of format is available as separate context menu item for all Active Directory objects.   For an illustration of the context menus, click here.

 

Tabular Output Format

 

The tabular-style format displays directory data in the standard report format that is used for the majority of Hyena's displays, whereby each directory attribute is displayed in its own column.  The tabular format can be used on either multiple objects, or for single directory objects.  The example below shows a typical detailed group listing in the tabular format:

 

 

Listing (List) Output Format

 

The list-style format is only applicable for single directory objects, such as a single user, group, OU, or computer.  This format shows Active Directory (AD) data whereby each AD attribute is listed separately.  In the example below, a portion of a detailed user query in the list-style format is shown.

 

 

The list output format also supports the "*" directory attribute, which will show ALL AD attributes that are defined for a given object.  The list output format is an excellent tool for troubleshooting directory problems and viewing directory information in its native, unstructured format.

 

To create a new query, first click the New... button after selecting the Query Type.  To modify an existing query's settings, click the Modify... button.  To add or modify a queries attributes (fields), see the Changing Query Attributes section below.

 

Changing Query Settings

 

The settings for a query are always displayed in the Current Queries list.  Query settings control the format used to display the query results, the displayable description, and whether the query is used as default output in either of Hyena's windows.  A query's settings consist of the following:

 

Query Name - The query name is used for the display name on the Query menu (see below), as well as the identification name for the Current Queries listing.

 

Display Format - Query data can be displayed and viewed in either a "Listing" or "Tabular" format, or both (see Query Display Formats above).  These two query formats will appear as a sub-menu under the Listing Views or Tabular View context menu for each directory object type.

 

Default Window - Queries can optionally be assigned to be the default display for a given directory object type and window.  See the Default Query Window section below.

 

Default Query Window

 

Many Active Directory (AD) objects in Hyena's left (tree) window can be either expanded directly in the tree window by clicking on the 'plus' icon next to the object, or the contents can be displayed in the right (results) window by double-clicking on the object.  These default actions are assigned to queries, which will automatically display the appropriate directory attributes.  There are two types of default query windows, the Tree (left) window, and the Results (right) window.

 

Tree Window Default

 

When a query is assigned to be the default output for the tree (left) window, it will be used for the display of directory attributes when a given object is 'expanded' in Hyena's left tree window.

 

Note: Hyena will only display the first two (2) directory fields in the tree window.  The second directory field will always be enclosed in parentheses ().

 

Results Window Default

 

When a query is assigned to be the default output for the results (right) window, it will be used for the display of directory attributes when a given object is double-clicked from Hyena's left tree window.  The results window default query is also used when the applicable "View" menu option is selected from a given object's context menu.  

 

Note: Hyena will not run a query when a single object, such as a user or group is double-clicked on.  This action will always result in the display of the object Properties dialog.

 

A query can also be assigned to be the default display output for both tree and results windows.

 

Changing Query Attributes

 

The primary purpose of an Active Directory query, of course, is to display directory attributes (fields), and Hyena provides full flexibility in the creation and modification of the individual directory attributes for a given query.

 

To change or add directory attributes to a query, first select the query to modify in the Current Queries list.  Hyena will display the query's current attributes in the lower left window, and display the current 'schema' in the lower right window.  The schema list is divided into several sub-categories for easier attribute selection.  However, any attribute can be selected and added to a query for any type of object.

 

Query attributes can be removed, added, or moved within the query.  The order of the attributes determines the order of the display in Hyena.  To change the title that is used to display an attribute, click the Modify... button.

Object Manager - Custom

 

Displaying Customized Active Directory Attributes

 

Note: For General information about Hyena's Object Manager, click here.

 

If your organization has added any specialized new attributes to the directory schema,  Hyena can be configured to display these additional Active Directory attributes for user objects.

 

The customized directory attributes will appear on the Custom dialog when displaying the user Properties dialog.

 

To configure the customized directory attribute list, first access Hyena's Object Manager (File->Manage Object View), then select the Custom dialog tab.  Select the object class (currently only the Active Directory "User" object class is supported), then add the attribute names to be displayed.  Use the New... button to add a new entry, and the Modify button to change an existing entry.  When setting the attribute properties, enter the actual Active Directory schema name for the Attribute Directory Name, and set the appropriate object data type, and indicate whether the attribute is single or multi-valued.

 

WMI Queries

 

Displaying WMI Query Properties

 

Note: For General information about Hyena's Object Manager, click here.

 

The WMI Query Properties dialog can be displayed by either selecting Execute Query... from the main WMI object under any computer or WMI class, or by selecting File->Manage Object View->WMI Queries, then selecting the query class and query name to modify.

 

The WMI queries properties dialog shown here is used to create or modify the parameters for WMI queries. 

 

Using 'Where' Clauses

 

WMI can accept optional conditional clauses in queries.  Use the Edit button to display a larger field for long conditional statements.  Check the option to "Prompt for 'Where' clause..." to change the query 'Where' condition prior to execution.

 

Where Clause Examples:

 

Name = "Spooler"
State = "running"
FreeSpace < 409800
Started = TRUE
Mode = 3
StartMode = "manual" and State = "running"

 

Note: Text entered in a WHERE condition is not case-sensitive

 

Setting the Default Query

 

To make a given query the default for a class, check the box titled "Make this the default query for this class".

 

Saving Query Template Changes

 

Changes to existing queries can be saved to the configuration file (WMI_QUERIES.DAT) by checking the option to "Save template information into WMI Configuration file".  New queries can be saved to the configuration file and/or saved temporarily for use in the current session.  If neither save option is selected, the query will be executed and then deleted

 Object Manager - Performance

 

Displaying Performance Information

 

Note: For General information about Hyena's Object Manager, click here.

 

To access Performance information for any computer, expand the Performance object for any computer in Hyena's left window.  The Performance object replaces the older "Processes" object in prior versions of Hyena.

 

Hyena's Performance function can view any type of performance monitoring object supported by the operating system.  This functionality uses the same techniques used by the built-in Performance Monitor utility.  A number of predefined performance queries are installed by default; additional performance objects and queries can be configured through Object Manager (File->Manage Object View->Performance). To configure additional performance queries or to modify an existing query:

To create a new performance query, click the New button.  To modify an existing query, select the query and either modify the performance counter information in the lower windows, or click the Modify button to modify the performance query attributes.

 

Performance Query Attributes

 

A performance query consists of an object type, such as the Process object, and the following attributes:

Performance Query Counters

 

The counters that are available for a given type of performance object will be listed in the Available Performance Counters (lower right window).  Use the Add button to add one or more counters to the selected query.  Changes are saved automatically.  Once added, use the Up, Down, Modify, or Delete buttons under the Current Query Performance Counters listing (lower left window) to modify the counter display.  The display of performance counter information can be controlled by using the Modify button, which allows setting the following:

Managing Processes

 

Windows does not have any support for terminating a remote process.  To terminate a remote process, use the Terminate function found in the WMI Win32_Process class.  See the WMI topic for more information on WMI.

Object Manager - External Object Lists

 

External Object File Support

 

Note: For General information about Hyena's Object Manager, click here.

 

Managing a large collection of objects (hundreds or thousands of entries) in Object Manager can be a bit cumbersome.  Object Manager supports "external" object lists that can be used to break the Object Manager listing into a more manageable size.  External object lists can be stored anywhere, including a network location.

 

Creating an External Object List Reference in Object Manager

 

To create a link to an external object list:

External Object List File Format

 

The format for external object lists follows the same format as the main Object Manager file, which is always named ad_objects.dat.  Hyena stores and maintains this file either in the designated storage location as specified under Tools->Settings->General, or by default, in the active user's profile directory.  Please note that the ad_objects.dat file stored in the Hyena installation directory is NOT generally used after installation. 

 

If a large set of objects are already stored in the main ad_objects.dat file, and it is desired to move these objects into a separate external object file, follow these steps:

 

IMPORTANT: First, create a backup of the existing ad_objects.dat file.

NOTE: The individual items in the file are separated by the TAB character.

 

To create an external object file manually, or by an external program, use this guide for the individual fields.  Again, the fields must all be TAB delimited.  The field order for both the main Object Manager file and External Object Listings is as follows:

 

Object ID - This field is not currently used for External Object lists.  Nesting of objects is not currently supported.  This field can be left blank/empty, or a unique number can be assigned to each object (row).  If entered, this value must be numeric.

 

Object Parent ID - This field is not currently used for External Object lists.  Nesting of objects is not currently supported.  This field can be left blank/empty.

 

Object Type - The object type is used to indicate the type of object, for example a workstation or printer.  Use the following table as a guide when setting this value.  This value must be one of the following numeric codes:

 

99 - Windows (NT) Domain

101 - Windows 2000 Domain

113 - Windows 2000 Domain Controller

33 - Server (any operating system version)

24 - Workstation (any operating system version)

9 - Printer

52 - External Object List

86 - Directory Path

23 - Local Workstation

89 - URL

46 - Enterprise Networking

 

Reserved - Set this value to '1'

 

Object Name - Used for the display name in Hyena's GUI for the object.

 

Object Comment - Optional, used for the comment

 

Object Path - Used to specify the path to the object.  See the Object Manager documentation on how to format the path depending upon the Object Type.

 

Object 'Server' - The server field is used only for domain objects as a mechanism to reference a specific server.  See the Object Manager documentation on when and how to use this field.

 

Note: Additional External Object Lists can be referenced within an External Object List (IE you can nest External Object Lists inside one another).