TABLE OF CONTENTS 1. Installing Hidden Object Locator 2. Main Screen 3. Changing Parameters 4. Configuring 5. Discovering a name 6. Locating Hidden Objects 7. Using the Logfile 8. SNMP Trap information ---------------------------------------------------------------------------- 1. Installing Hidden Object Locator To install the hidden object locator copy HOBJLOC.NLM to the SYS:SYSTEM directory of a 4.1x file server. Note: the tree that you want to search must be on the file server that you copy HOBJLOC.NLM to. After copying the NLM, type LOAD HOBJLOC.NLM at the console prompt. If you see a message saying, "Loader cannot find public symbol: SACTrap", it means that you have not loaded SNMP.NLM. You can simply load SNMP.NLM to resolve this error, but if you want to receive traps you must configure your server and workstation. See your SNMP reference manual for more information on configuring SNMP. ---------------------------------------------------------------------------- 2. Main Screen The following is a picture of the main screen for the HOBJLOC.NLM. Other sections will refer to this screen. ЙНННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННН» є Context: O=Novell є єBegin At: [Root] є є User: Admin є є Search: OU=Mktg.O=Novell є єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє є є є є є є є є є є є є є є ИННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННј ЙНННННННННННННННННННН» є Options є МНННННННННННННННННННН№ є іChange Parameters є є іConfigure є є іDiscover Name є є іStart Locating є є іView/Clear Logfileє ИННННННННННННННННННННј ---------------------------------------------------------------------------- 3. Changing Parameters Choosing the Change Parameters option from the main menu allows you to change your context and starting location in the DS tree. The following is a menu that will be displayed when you choose this option. ЙННННННННННННННННННННННН» є Options є МННННННННННННННННННННННН№ є іChange Context є є іChange Start Locationє ИНННННННННННННННННННННННј The context is displayed on the first line in the main screen portal and will look similar to: Context: O=Novell The Start Location is displayed on the second line in the main screen portal and will look similar to: Begin At: [Root] By default the context is set to the servers context and the start location is set to [Root]. Choosing either of these options presents an edit box that will allow you to change the chosen parameter. NOTE: The Start Location must be specified using a fully distinguished name. For example: OU=Marketing.OU=Non_Engineering.O=Novell is acceptable, whereas: Marketing.Non_Engineering.Novell is not. This only applies to the start location. ---------------------------------------------------------------------------- 4. Configuring Choosing the Configure option from the main menu allows you to change the following variables: Editor - StartAtBottom (default=YES) Log Files - Purge After (default=20 days) SNMP - EnterpriseID (default=1.3.6.1.4.1.23.2.7777) - VarBindID (default=1.3.6.1.4.1.23.2.7777.1) You can configure the editor to start at the top or at the bottom. The default is to start at the bottom. You can configure Log Files to purge (delete) old log files after a specified number of days. This allows you the ability to keep old Log Files from encumbering your hard drive. You can configure SNMP to send traps to any specified enterprise ID. You can also change your variable binding. If you change the SNMP variables then you must unload and reload HOBJLOC.NLM for them to take effect. For information on SNMP IDs you should consult your SNMP administrator or your reference manual. ---------------------------------------------------------------------------- 5. Discovering a name Choosing the Discover Name option from the main menu allows you to discover the name of any hidden objects directly under a specified container. When you choose this option two prompts will appear. One prompt will ask for a container object and the other prompt will ask for the name of the user that may have hidden objects in the specified container. For example, to see all the objects hidden from user admin you would type: Container: Novell User: Admin.network_division.Novell Note: The container and user name are based on the context shown on the first line in the main portal screen. Note: You can obtain containers with hidden objects by using the Start Locating option from the main menu (See section 6). ---------------------------------------------------------------------------- 6. Locating Hidden Objects Choosing the Start Locating option from the main menu allows you to begin locating objects that are hidden from a specified user. When you choose this option an edit box will appear prompting for a user and password. Note: The user name is based on the context shown on the first line in the main portal screen. After you enter the user name and password the NLM will begin locating objects from the location displayed next to the Begin At: prompt on the main portal screen. To change the Begin At location see section 3 Changing Parameters. If the NLM finds any hidden objects, they will be displayed on the main screen and logged to today's logfile. They will also be sent via an SNMP Trap. The information displayed, logged and sent via SNMP trap can then be used with the Discover Name option (See section 5) to Discover the name of the hidden object. Also, a server name is given that the NLM must be run on to reveal the name of the hidden object. Note: If the object exists on the server that the NLM is running on it will automatically discover the name. ---------------------------------------------------------------------------- 7. Using the Logfile Choosing View/Clear Logfile from the main menu will bring up a list box similar to the following: ЙННННННННННННННННННННННННННННННННННННННННННН» є View Logfile є МННННННННННННННННННННННННННННННННННННННННННН№ є іHL951208.LOG (Fri. December 08, 1995 є є іHL951211.LOG (Mon. December 11, 1995 є є іHL951212.LOG (Tue. December 12, 1995 є є іHL951213.LOG (Wed. December 13, 1995 є є іHL951214.LOG (Thu. December 14, 1995 є є іHL951215.LOG (Fri. December 15, 1995 є є іHL951216.LOG (Sat. December 16, 1995 є є і є є і є є і є є і є є і є є і є є і є є і є ИНННННННННННННННННННННННННННННННННННННННННННј Choosing one of the days listed will allow you to view the contents of the logfile for that day. The last one listed should be the most recent logfile. To delete a logfile position the highlighted bar on one of the days listed and press the delete key. A prompt will be displayed asking to verify that you really want to delete the log file. Note: If the logfile has today's date on it the logfile will be cleared, but not deleted. When you are view a logfile the following keys are operational: key action HOME - Takes you to the beginning of the logfile. END - Takes you to the end of the logfile. PAGE-UP - Takes you up one page. If you are at the beginning it beeps. PAGE-DOWN - Takes you down one page. If you are at the end it beeps. UP-ARROW - Takes you up one line. If you are at the beginning it beeps. DOWN-ARROW - Takes you down one line. If you are at the end it beeps. RIGHT-ARROW - Moves the cursor one to the right. LEFT-ARROW - Moves the cursor one to the left. CTL-RIGHT-ARROW - Moves the cursor ten spaces to the right. CTL-LEFT-ARROW - Moves the cursor ten spaces to the left. ---------------------------------------------------------------------------- 8. SNMP Trap Information The following is information relating to the SNMP traps sent by HOBJLOC.NLM. Variable bindings are defined by using the VarBindID from the Configure option on the main menu (See Section 4 Configuring) and adding the following number to the specific variable. The Number of hidden Objects VarBindID.1 A Container Object VarBindID.2 A Server Name VarBindID.3 A Directory Services Object VarBindID.4 The rights a user does not have to an object VarBindID.5 --- The specific types are as follows: ------------------ SPECIFIC TYPE 1 ------------------ VarBindID.4 (Object Name (ie. User Name) - Octet String) VarBindID.1 (Number of Hidden objects - Integer) VarBindID.2 (Container - Octet String) VarBindID.3 (Server Name - Octet String) A message similar to the following could be displayed: User <VarBindID.4> has <VarBindID.1> hidden objects in container <VarBindID.2> on server <VarBindID.3> ------------------ SPECIFIC TYPE 2 ------------------ VarBindID.4 (Object Name - Octet String) VarBindID.5 (Rights - Octet String) VarBindID.4 (Object Name - Octet String) A message similar to the following could be displayed: Object <VarBindID.4> does not have <VarBindID.5> rights to object <VarBindID.4> ------------------ SPECIFIC TYPE 3 ------------------ VarBindID.4 (Object Name - Octet String) VarBindID.3 (Server Name - Octet String) A message similar to the following could be displayed: Object <VarBindID.4> does not exist on this server. Try server <VarBindID.3>