TGB - Thomas Botta, Rosenmuehlweg 7, D-89415 Lauingen, CIS: 100020,1721 ______________________________________________________________________________ Report-Generator V1.01 (26.02.1994) (c) 1993, 1994 by TGB All rights reserved ______________________________________________________________________________ Contents: 1. Overview 1.1 What is Report-Generator? 1.2 Features 1.3 Requirements 1.4 Problems/Suggestions 2. Shareware 2.1 Definition of Shareware 2.2 Disclaimer Agreement 3. Using Report Generator 3.1 Menu "Change Current File Server" 3.2 Menu "Choose Output File" 3.3 Menu "Server Information" 3.4 Menu "Accounting Information" 3.5 Menu "User Information" 3.6 Menu "Group Information" 3.7 Menu "Queue Information" 3.8 Menu "Print Server Information" 3.9 Menu "Volume Information" 3.10 Menu "Retrieve all" 3.11 Menu "View output" 3.12 Menu "Quit" 3.13 Command line options and usage 4. Format of the log files which are generated by report 4.1 Server Information 4.2 Accounting Information 4.3 User/Group/Queue Information 4.4 User Defaults 4.5 Printserver information 4.6 Volume information 1. Overview: ============ 1.1 What is Report-Generator? Report-Generator was designed to retrieve detailed configuration information from Novell file servers. It retrieves the information available with SYSCON, PCONSOLE, DSPACE, FCONSOLE and more. We use it to generate configuration reports for our customers. Report-Generator is also usefull to document changes in the server configuration e.g. at a weekly basis. 1.2 Features - Generate reports for Novell 2.x / 3.x / and (with limitations) 4.x servers - Server config: name/version/*.ncf files/system login script/... - Accounting config: charge rates - User/Group: account restrictions/time restrictions/trustee assignments/... - Queue: queue directory/users/servers/operators - Print Server: printer configuration/version/status/type/... - Volume: Volume Info/Directory tree with dspace information - Novell like menu system - Batch processing 1.3 Requirements - NetWare 2.x or higher 1.4 Problems/Suggestions You have problems using Report Generator? You are missing a bit of infor- mation which is not currently retrieved by Report Generator? Feel free to contact me via E-Mail (Compuserve: Thomas Botta [100020,1721]). 2. Shareware: ============= 2.1 Definition of Shareware: Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to re- gister. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registra- tion, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. 2.2 DISCLAIMER - AGREEMENT Users of Report Generator must accept this disclaimer of warranty: "Report Generator is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of Report Generator". Report Generator is a 'shareware program' and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. If you find this program usefull and wish to use it after you have run it 5 times on your server, you must make a registration payment of $89 which license Report Generator to use it on one server. Report Generator is also available in an unlimitted version for $235. The $89 registration fee will license one copy for use on one server. You must register Report Generator for each server you wish to use it for. If you have more than 2 servers the unlimitted version ($235 registration fee) is recommended. It license you to use one copy with any number of file servers. To register please send me your company name as well as the serial number of your file server. Registration is easy with compuserve: Simply enter "GO SWREG" and search for keyword "TGB" now select the product you want to register. Anyone distributing Report Generator for any kind of renumeration must first contact Thomas Botta at the address below for authorization. You are encouraged to pass a copy of Report Generator along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. 3. Using Report Generator ========================= After starting report generator you must confirm the registration reminder 3.1 Menu "Change Current File Server" Use this entry to change the fileserver for which you want to generate a report. A list box will be displayed with all file servers you are currently attached to. If you want to attach to another file server simply press the "ins" key. A list with all available server will be displayed. Select the server you want to attach to and press "enter". You are asked for the username and passwort to attach to the file server. If the attachement was successful the new file server will also be displayed in the selection. Now choose the server you want to use for this report. You must have super- visor equivalenz to that server. If you have not supervisor privilegs a message is displayed and you can't run report on this server. If you have successfully selected the file server RG will display something like "User SUPERVISOR attached to server PRODUCTION running NetWare v3.12[2]" in the second line. It shows your username the fileserver name and version as the number of times you have run RG on this server ( 2 times in the above example ). You can also specify the server at the command line. Simply start report with "report /server:servername". 3.2 Menu "Choose output file" Use this entry to specify the output filename. A input box will be displayed, where you can enter the path and filename of the output file you want to use. If you press the "ins" key in this box a listbox with the directory tree is displayed, where you can select a file name. If you press the "enter" key in the "Enter output filename" box, the file is created. If the file already exists you are asked to overwrite or append to the file or specify a new filename. You can also specify the output filename at the command line: "report /output:filename" 3.3 Menu "Server Information" Use this entry to retrieve server information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /SERVER. "report /batch /server /output:nw.log" 3.4 Menu "Accounting Information" Use this entry to retrieve accounting information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /ACCOUNTING. "report /batch /accounting /output:nw.log" 3.5 Menu "User Information" Use this entry to retrieve user information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /USER. "report /batch /user /output:nw.log" 3.6 Menu "Group Information" Use this entry to retrieve group information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /GROUP. "report /batch /group /output:nw.log" 3.7 Menu "Queue Information" Use this entry to retrieve queue information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /QUEUE. "report /batch /queue /output:nw.log" 3.8 Menu "Print Server Information" Use this entry to retrieve printserver information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /PS. "report /batch /ps /output:nw.log" 3.9 Menu "Volume Information" Use this entry to retrieve volume information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /VOLUME. "report /batch /volume /output:nw.log" 3.10 Menu "Retrieve all" Use this entry to retrieve all available information. If you run Report generator in batch mode (/BATCH command line argument) you can specify this option also by the command line argument /ALL. "report /batch /all /output:nw.log" 3.11 Menu "View output" Use this entry to view the current contents of the specified log file. 3.12 Menu "Quit" Use this entry to exit report generator. 3.13 Command line options and usage Call report with the /? or /HELP switch to get help for command line options. If you want to use report in batch files you must specify at least the following in the command line of report: /BATCH for batchmode /OUTPUT: to specify the output file and one or more of the options (/ACCOUNTING /GROUP /PS /QUEUE /SERVER /USER /VOLUME) or /ALL for all available information. The following errorlevels are returned by report: EXITERR_NOERROR 0 EXITERR_NOT_ATTACHED 1 EXITERR_UNABLETOATTACH 2 EXITERR_NOSUPERVISORPRIVILEGS 3 EXITERR_CREATEOUTPUTFILE 4 EXITERR_NOOUTPUTFILE 5 EXITERR_LICENSEVIOLATION 6 EXITERR_DAMAGEDEXE 7 4. Format of the *.log files which are generated by report: =========================================================== 4.1 Server Information section name: [Fileserver-%s] %s is the name of the fileserver entry 2 3 4 sample ------------------------------------------------------------------------------- ServerName X X X PRODUCTION SerialNumber X X X 23345689 ApplicationNumber X X X 2455 CompanyName X X X Novell NetWare Version X X X NetWare V4.01 OS Revision Date X X X 12 Juli 1993 CopyrightNotice X X X (C) Copyright 1983-1993 Novell, Inc. All Rights Reserved. Maximum Volumes X X X 64 Revision X X X 0 SFT Level X X X 2 TTS Level X X X 1 Accounting Version X X X 1 VAP Version X X X 1 Queue Version X X X 1 Print Version X X X 0 Virtual Console Version X X X 1 Restriction Level X X X 1 Internet Bridge X X X 1 Maximum Connections X X X 10 Maximum NumberOfNameSpaces X 6 Maximum NumberOfLANs X 256 Maximum NumberOfMediaTypes X 32 Maximum NumberOfProtocols X 16 Maximum SubDirTreeDepth X 100 Maximum NumberOfDataStreams X 3 Maximum NumberOfSpoolPrinters X 5 ConsoleOperators X X X -> none if there are no console operators defined IntruderDetection X X X -> disabled or enabled if enabled the following entries: IncorrectLoginAttempts 2 BadLoginCountRetentionTime 0 Days 1 Hours 5 Minutes LockAccountAfterDetection no or 1 Days 0 Hours 0 Minutes { System Login Script: X X X -> Contents of system login script (sys:public\net$log.dat) System Login Script X X X -> none if there is no system login script Workgroup Managers X X X -> none if there are no workgroup managers defined CacheBufferCount X 1000 CacheBufferSize X 4096 Byte LogicalDriveCount X 2 PhysicalDriveCount X 2 Chn-ChannelState X running / stopping / stopped / not functional / unknown(x) Chn-ChannelType X XT / AT / SCSI / disk coprocessor / unknown(x) Chn-DriverType X 5 Chn-DriverVersion X 2.1 Chn-DriverIOAddr1 X 1f0h-1ffh Chn-DriverIOAddr2 X 178h-17fh Chn-DriverMemory1 X D00000h:0h Chn-DriverMemory2 X D00000h:0h Chn-DriverInterrupt1 X 12 Chn-DriverInterrupt2 X none Chn-DriverDMAChannel1 X 5 Chn-DriverDMAChannel2 X none Chn-DriverConfigDescription X IBM SCSI Diskcontroller MaxOpenFiles X 240 LANc-Config1 X Racal Interlan NI6510 Driver V2.0EC (900201) LANc-Config2 X Dma Channel = 3 LANc-OptionNumber X 6 LANc-NetworkAddress X 01020304h:020701084b8a Diskn-Channel X 0 Diskn-Removable X yes or no Diskn-DriveType X XT / AT / SCSI / disk coprocessor / PS/2 with MFM controller PS/2 with ESDI controller / Convergent Technology SBIC / unknown(x) Diskn-ControllerDriveNumber X 1 Diskn-ControllerNumber X 2 Diskn-ControllerType X 0 Diskn-DriveSize X 100000KB Diskn-DriveCylinders X 1024 Diskn-DriveHeads X 16 Diskn-SectorsPerTrack X 17 Diskn-DriveDefinition X IDE Disk Diskn-IOErrorCount X 0 Diskn-HotFixStart X 10000 Diskn-HotFixSize X 2000 Diskn-HotFixBlockAvailable X 1999 Diskn-HotFixEnabled X yes or no { xxxxxxxx.NCF: X X -> Contents of all *.NCF files in sys:system { AUTOEXEC.NCF: X X X -> Contents of AUTOEXEC.NCF (NW > 2) or AUTOEXEC.SYS (NW <= 2) AUTOEXEC.NCF X X X -> none if there is no AUTOEXEC.NCF/.SYS 4.2 Accounting Information section name: [Accounting] entry 2 3 4 sample ------------------------------------------------------------------------------- Accounting installed X X X yes or no - if yes the following additional entrys are used AccountingServers X X X -> name of the accounting servers BlocksRead X X X -> none or the format described below BlocksWritten X X X -> none or the format described below ConnectTime X X X -> none or the format described below DiskStorage X X X -> none or the format described below RequestsMade X X X -> none or the format described below format of the accounting entries entryname Charge Rate xx=n/m List of defined charge rates entryname hh:mm r r r r r r r r rate for time hh:mm from 00:00 - 23:30 ( Su Mo Tu We Th Fr Sa ) 4.3 User/Group/Queue Information section name: [USERS] / [GROUPS] / [PRINT_QUEUES] entry 2 3 4 sample ------------------------------------------------------------------------------- Usern/Groupn/Queuen X X X SUPERVISOR(1) -> username(object id) NumberofUsers/Groups/Queues X X X 5 for each user/group/queue a own section is created section name: [User/Group/Queue-%s] %s is the name of the user/group/queue entry 2 3 4 sample ------------------------------------------------------------------------------- FullName X X Jonny Walker Account X X X enabled or disabled AccountExpireDate X X X never or day.month.year LimitConcurrentConnections X X X no or number of connections allowed e.g. 5 AllowUserToChangePassword X X X no or yes RequirePassword X X X no or yes MinimumPasswordLength X X X 5 RequireUniquePasswords X X X yes or no ForcePeriodicPwdChanges X X X no or days between forced changes e.g. 30 days PasswordExpireDate X X X day.month.year LimitGraceLogins X X X no or number of grace logins allowed RemainingGraceLogins X X X number of remaining grace logins TimeRestrictions X X X none or the following additional entries SunTimeRestrictions X X X 01.00-07.30 MonTimeRestrictions X X X 01.00-07.30 TueTimeRestrictions X X X 01.00-07.30 18.00-23.00 WedTimeRestrictions X X X 01.00-07.30 18.00-23.00 ThuTimeRestrictions X X X none FriTimeRestrictions X X X 01.00-07.30 SatTimeRestrictions X X X 01.00-07.30 SecurityEqualTo X X X USER1 USER2 GROUP1 GROUP2 (maybe more than one line) MemberOfGroups X X X GROUP1 GROUP2 (maybe more than one line) (user only) GroupMembers X X X USER1 USER2 (maybe more than one line) (group only) StationRestrictions1 X X X xxxxxxxx:xxxxxxxxxxxx xxxxxxxx:xxxxxxxxxxxx (maybe more than one line) AccountBalance X X X 5000 LowBalanceLimit X X X 100 Managers X X USER1 USER2 (maybe more than one line) QueueDirectory X X X sys:system\xxxxxxx (queue only) QueueUsers X X X USER1 USER2 (maybe more than one line) (queue only) QueueServers X X X PRODUCTION (maybe more than one line) (queue only) QueueOperators X X X USER1 USER2 (maybe more than one line) (queue only) CommonName X common name (maybe more than one line) Surname X Jonny Walker (maybe more than one line) Title X Title (maybe more than one line) Location X Location (maybe more than one line) OU X Department (maybe more than one line) PhoneNumber X Phone number (maybe more than one line) DeliveryOffice X DeliveryOffice (maybe more than one line) PostalAddress X Postal Address (maybe more than one line) PostalCode X Postal Code (maybe more than one line) PostOfficeBox X Post Office Box (maybe more than one line) State X State (maybe more than one line) StreetAddress X Street Address (maybe more than one line) Organisation X Organisation (maybe more than one line) UnknownProperty X X X Name of a property unknown to report PasswordAssigned X X X yes or no (user only) { Login-Script: X X -> Contents of login script (user only) LoginScript X X -> none if there is no login script (user only) { Login-Script OS/2: X X -> Contents of login script for OS/2 (user only) LoginScriptOS2 X X -> none if there is no login script for OS/2 (user only) ManagedUsers X X USER1 USER2 (maybe more than one line) ManagedGroups X X GROUP1 GROUP2 (maybe more than one line) FileServerConsoleOperator X X X yes or no { Trustee Assignments: X X X lines with the format: [SRWCEMFA] VOL:dir/dir/file { Volume Disk Restrictions: X X X lines with the format: vol none/rest. in use: xKB 4.4 User Defaults section name: [User Defaults] entry 2 3 4 sample ------------------------------------------------------------------------------- CreateHomeDir X X no or path e.g. sys:user/ or none if no path specyfied AccountBalance X X 1000 LowBalanceLimit X X 50 AccountExpireDate X X never or day.month.year LimitConcurrentConnections X X no or number of connections allowed e.g. 5 RequirePassword X X X no or yes MinimumPasswordLength X X X 5 RequireUniquePasswords X X X yes or no ForcePeriodicPwdChanges X X X no or days between forced changes e.g. 30 days LimitGraceLogins X X X no or number of grace logins allowed TimeRestrictions X X X none or the following additional entries SunTimeRestrictions X X X 01.00-07.30 MonTimeRestrictions X X X 01.00-07.30 TueTimeRestrictions X X X 01.00-07.30 18.00-23.00 WedTimeRestrictions X X X 01.00-07.30 18.00-23.00 ThuTimeRestrictions X X X none FriTimeRestrictions X X X 01.00-07.30 SatTimeRestrictions X X X 01.00-07.30 4.5 Printserver information section name: [PRINT-SERVERS] entry 2 3 4 sample ------------------------------------------------------------------------------- PrintServer X X PS for each print server a own section is created section name: [PrintServer-%s] %s is the name of the print server entry 2 3 4 sample ------------------------------------------------------------------------------- CommonName X X common name PasswordAssigned X X yes or no ObjectID X X 435345 Status X X running (only if ps is loaded) NumPrinters X X 4 (only if ps is loaded) NumModes X X 2 (only if ps is loaded) Version X X 3.76 (only if ps is loaded) ServerType X X nlm (only if ps is loaded) Description X X description Operators X X USER1 (maybe more than one line) Device X X device (maybe more than one line) Users X X USER1 (maybe more than one line) ServicedServer X X PRODUCTION (maybe more than one line) Printer X X epson lq850 (maybe more than one line) for each defined printer a own section is created section name: [Printer-%s1-%s2] %s1 is the ps name %s2 is the printer name entry 2 3 4 sample ------------------------------------------------------------------------------- CN X X epson Type X X parallel Port X X LPT1 UseInterrupts X X yes IrqNumber X X 7 CurrentForm X X 0 BufferSize X X 3 ServiceMode X X change form as needed BannerType X X text Default Queue X X EPSON Notify X X EVERYONE[First:30][Next:60] (maybe more than one line) Owner X X SUPERVISOR Print Server X X PS Queue X X EPSON (maybe more than one line) Priority X X 1 (maybe more than one line) 4.6 Volume information section name: [Volume-%s] %s is the name of the volume entry 2 3 4 sample ------------------------------------------------------------------------------- TotalBlocks X X X 29242(467872KB) SectorsPerBlock X X X 32(16KB) AvailableBlocks X X X 6970(111520KB) TotalDirEntries X X X 36096 AvailableDirEntries X X X 19786 RemovableVolume X X X yes or no Auditing X enabled or disabled AuditFileSize X 40 AuditConfigFileSize X 232 AuditFileMaxSize X 1024000 AuditFileSizeThreshold X 921600 AuditRecordCount X 2 AuditHistoryRecordCount X 7 NumberOfVolumeSegments X 2 SegmentDeviceNumn X 1 SegmentOffsetn X 160 SegmentSizen X 462592(231296KB) LoadedNameSpace X X DOS MAC LogicalDriveNumber X 1 StartingBlock X 200 Hashing X yes or no Caching X yes or no Mounted X yes or no section name: [Volumes] entry 2 3 4 sample ------------------------------------------------------------------------------- { Volume: VolName X X X SYS (directory tree follows) direntry[dspace:xKB] X X sample directory entry with directory space restriction