Version PK-2.02
(Nov 22, 1998)
DISCLAIMER: THIS PRODUCT IS SUPPLIED "AS IS". DREAMLAN DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. DREAMLAN ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PRODUCT. |
FSTrust is comprised to two programs: gTRUSTEE and pTRUSTEE. The gTRUSTEE program retrieves file and directory trustee information from either a bindery (NetWare 3.1x) server or NDS (NetWare 4.x and 5.x) server and stores the information into an ASCII text file. Under NetWare 4/5, each server has its own set of user object ID for a given NDS user object. For example, for NDS user object Peter, on Server A the object ID may be 012345 while on Server B, the same NDS object may have an object ID of 892345. Therefore, if you backup the file system trustee information using object ID instead of object name, you could lose the file system trustee information if you restore a file after an NDS reinstall. Therefore, to overcome this problem, gTRUSTEE stores the information using full NDS names.
pTRUSTEE is the tool that puts the file system trustee information back onto the server volumes.
Four immediate application of FSTrust comes to mind:
- If your backup software is not NetWare aware, file and directory trustee information (as well as NDS data) are not backed up. You can use FSTrust to backup and restore file system trustee data.
- If you need to move a directory structure from one volume to another or from one server to another. You can simply NCOPY the data over and use FSTrust to quickly reassign the file system trustees.
- Use FSTrust (gTRUSTEE specifically) to document your current file system trustee assignment. Since the generated data file is in a fixed format, you can choose to import them into a database or other applications to generate reports.
- You can use the generated data file to change file and directory trustee assignments off-line, before doing the update enmass. You can also use it as a tool to standardize trustee assignments across your network.
gTRUSTEE can also be used to gather file system trustee information from NetWare 3.1x servers using bindery access mode. This is useful if you are migrating data from a 3.1x environment to NDS.
Although designed with NetWare 4/5/NDS in mind, but now with v1.24 and higher, you can also restore the trustee and ownership information back to a 3.1x server!
- Please note that in version MT-1.10 and higher, the -X option in gTRUSTEE has been changed to -Z; and the -X option is now used to disable scanning of files or directories. Please refer to the Usage section for more information.
- In version 1.24, a -3 switch is added to pTRUSTEE. This enables the trustee and ownership information stored in TRUSTEE.DAT and OWNER.IRM be placed back on to a NetWare 3.1x server. Therefore, now you can use FSTrust to fully backup and restore file/directory trustee and ownership information in a NetWare 3.1x environment!
- Version PK-2.01 is Y2K on dates in log files. All previous versions of FSTrust are fully Y2K (unless you're picky about the time stamp in the log files). NetWare 5 certified. (YES Bulletin #44433)
No special installation steps or program need to be used. Simply copy gTRUSTEE and pTRUSTEE to SYS:PUBLIC of your servers. You must have the Unicode files for the country code and code page that your workstation use available in the the respective NLS directories, for example, SYS:PUBLIC\NLS.
If you choose to place the FSTrust files in a different directory, you may need a search map to SYS:PUBLIC\NLS in order for the application to find the Unicode files.
gTRUSTEE:
gTRUSTEE is a command-line based utility. Therefore, you need to supply the necessary options when invoking the utility. The syntax for using gTRUSTEE is:
gTRUSTEE -dh? -v volname -p dirpath -s server [-n objname] [-raioZ] [-X F|D]
where (none of the parameters are case sensitive)
- -v volume_name specifies the volume to access. The default is SYS: volume.
- -p directory_path specifies the directory at which to start scanning for file and directory trustee assignments. All subdirectories under this starting path will be scanned. The default is \PUBLIC. If you wish to gather information for a given volume, use "\" as the path name.
- -s server_name indicates the server on which the volume is located. This is a REQUIRED parameter and there is no default.
- -h or -? will generate a help message screen.
File and directory trustee data is stored in a data file called TRUSTEE.DAT; if the bindery mode is enabled, the data file is called the same name.
Examples
gTRUSTEE -s Server1
will get the trustee info of SYS:PUBLIC on Server1 and save to file TRUSTEE.DAT.
gTRUSTEE -s Server2 -p TEST -v DATA
will get the trustee info of DATA:TEST on Server2 and save the data to TRUSTEE.DAT.
Special gTRUSTEE Options
- You can use the -n objectname to generate a report of file and directory trustee information for a given NDS object.
- -r will generate a report file called gTRUSTEE.RPT with essentially the same information as displayed on the screen during program execution. This provides a record for later reference.
- .-a will append to an existing report file, if the -r option is used. [Example: gtrustee -s nw411 -n o=dreamlan -r will find all file system trustee assignment for O=DreamLAN in the SYS:PUBLIC and below, and record the information in the gtrustee.rpt file.]
- -b places gTRUSTEE into bindery mode when collecting the file and directory trustee information.
- -i will collect the IRM information of each file and directory and store the information in a file called OWNER.IRM.
- -o will collect the ownership information of each file and directory and store the information in a file called OWNER.IRM.
- -X allows you to bypass either the scanning of files or directories, based on the parameter following this keyword. For example, -X F will disable file scanning; -X D will disable directory scanning. If you do not specify a parameter after the -X, this option is ignored.
- -Z (must be uppercase) will clear ALL trustee assignments in the scanned path. Password is 1234. The use of password here is simply to prevent you from accidentally delete all trustee assignments.
Pressing the ESC key any time will abort the program. This is useful if you started scan on a large volume and wish to abort.
pTRUSTEE:
pTRUSTEE is a command-line based utility. Therefore, you need to supply the necessary options when invoking the utility. The syntax for using pTRUSTEE is:
pTRUSTEE -h?3bio -s server [-t] [-r] [-a]
where
- -s server_name indicates the server on which the volume is located. This is a REQUIRED parameter and there is no default.
- -b is the flag to indicate one is migrating (bindery mode) trustee info from 3.1x to NetWare 4. The data will be read from TRUSTEE.DAT.
- -3 informs pTRUSTEE that the target server is a 3.1x server. To be used in conjunction with the -b option.
- -h or -? will generate a help message screen.
Example
pTRUSTEE -s Server1
Restores the trustee info from file TRUSTEE.DAT to Server1. Server1 here is assumed to be a NetWare 4 server. Note that the volume and directory information is already in the data file.
pTRUSTEE -s Server2 -b -3
Restores the trustee info from file TRUSTEE.DAT to Server2, where Server2 is a NetWare 3.1x server.
Special pTRUSTEE Options
- -i will assign the IRM information of each file and directory based on the information in a file called OWNER.IRM.
- -o will assign the ownership information of each file and directory based on the information in a file called OWNER.IRM.
- -r will generate a report file called pTRUSTEE.RPT with essentially the same information as displayed on the screen during program execution. This provides a record for later reference.
- -a will append to an existing report file, if the -r option is used.
- -t will prevent the TRUSTEE.DAT from being processed. This is useful if you only want to assign IRM/Ownership.
Pressing the ESC key any time will abort the program. This is useful if you started update a large volume and wish to abort.
Special Notes About the TRUSTEE.DAT and OWNER.IRM Files
- As you noticed from just looking at the TRUSTEE.DAT file, the syntax is pretty straightforward. You can easily add or remove trustee assignments by modifying the file. However, please make sure you follow the EXACT syntax as you see. Each entry is made up of FOUR (4) lines. It is important to identify on the second line if the entry is a file (F) or a directory (D). The identifier on the third line is not currently used, but may be used in the future to indicate if the object named is a user, group, or other NDS object types. The rights on the fourth (and last) line can be specified in any order.
- When extracting information using the bindery mode (-b option in gTRUSTEE), a [U] is associated with an user object name and a [G] is associated with a group object name. Since NetWare 3.1x only allows either a user or a group to be trustees, no other object types are supported in the bindery mode of gTRUSTEE.
- You can include a very special keyword in the TRUSTEE.DAT file called [K]Create_Directory Normally when a file/directory does not exist on the target volume, trustee assignments can not be made. With the use of the above keyword flag near the top of the TRUSTEE.DAT file, missing directories will be created and trustee assignments made. However, missing files will not be created. This keyword must be entered into the TRUSTEE.DAT file manually and it MUST appear as above (case-dependent). You should not edit any lines above the "Please do not edit this file..." unless you understand the consequence.
The same holds true for the OWNER.IRM file.
Two variations of FSTrust are available. The version included here is a Freeware version. This version will not do the following:
- It will not scan for file trustee assignments.
- It will not generate a report file.
- It will not report an NDS object's file system assignments.
- It will not support bindery/migration mode.
- It will not create missing directories.
- It will not clear trustee assignments.
- It will not abort from the pressing of ESC key.
- It will not scan for IRM.
- There is no technical support for the Freeware version.
You are granted an unlimited usage at no cost. However, you are not allowed to sell or package this utility as part of another software package or service contract. Bottom line: you can not make money using this Freeware version. All standard Freeware limitation applies.
Should you find the need, a registered verison is available by registering on-line through the following Web sites:
The NDS tree name is required as it is used to generate a key. The registration cost is $99 US. Canadian registration is $135 CDN plus GST. All other countries, please remit in US funds.
You can also FAX a company Purchase Order or credit card information to +1 (905) 887-3836. Please make sure you either include your tree name information on the FAX or send a follow up email.
This will be a NETWORK license, limited to ONE NDS TREE. This license does not permit you to include it as part of another software package or service contract. Reseller inquiries welcome. Special site agreements for multiple trees is available.
FSTrust is written in C using Microsoft C optimizing compiler and Novell's SDK. Some string manipulating routines are from the CXL library.
Inclusion of this utility on CD-ROMs (except for backup purposes) without permission from DreamLAN Network Consulting Ltd. is expressly prohibited.