Novell Cool Solutions: Cool Tool
Change the Host Device attribute value of a Print Server object without having to delete the object.
|Posted:||25 Apr 2002|
Please read the note from our friends in legal before using this file.
The HostEditor utility can change the Host Device attribute value of a PrintServer object without having to delete the Print Server object and recreate it. In addition, this utility can change the Host Device/Host Server attribute value of Directory Map, Print Queue, and Volume objects. As an added bonus, this utility can be used to change the Volume and Queue Directory attributes of a Print Queue object (for the purpose of "moving" a print queue from oneserver/volume to another)!
HostEditor is specifically designed to address the following four issues:
- Print Server objects. (Per Novell TID# 2951096) When a print server object is created, a HostDevice will be assigned where the PSERVER.LOG file will be stored. The HostDevice will default to the creating user's Default Server (see User Details :Environment : Default Server in NWAdmin). If the user creating the Print Server has no Default Server, the Host Device will be the server in the same partition as the Print Server that is closest to the top of the tree. If multiple servers exist in the same OU as the PSERVER, the PSERVER.LOG file will be created on the server in that OU that is closest to the top of the tree. This "random"assignment of Host Device can result in one of the following error conditions:
"PSERVER-4.10-214: The print server was unable to login to server <servername> specified in the print server's Directory Services (DS) attribute list as the host device. Warning, the job audit logging feature may not function properly. Program execution may not continue normally."
One of these above errors will be displayed if the server that the HostDevice attribute of the Print Server is set to is not available or does not respond (e.g. the server is down or that the server is across a WAN link and the WAN is down). HostEditor has been written to change the Host Device attribute of the Print Server to a different server. Prior to the availability of HostEditor,the only way to eliminate the above errors was to use Novell's HSTDEV utility (Novell TID# 2906116) or to delete the Print Server and recreate while only attached to the desired server.
"PSERVER-4.10-29: A host device was not specified in the print server's Directory Services attribute list, the print server will attempt to use the local server as a host device. Warning, the job audit logging feature may not function properly. Program execution may not continue normally."
- Print Queue objects. In a recent server migration project, we needed to move a large number of Print Queues from one server to a different server and to a different volume name. In order to not have to recreate the Queue objects, this utility was enhanced to allow the changing of Volume and Queue Directory attributes of a Queue object. This way, all you need is to create a QDR directory on the new server/volume with the same name as the old one, change the Volume and Queue Directory attribute values in the Queue object to point to the new server's Volume object, restart the Print Server and viola!(If you need to change a large number of queues, we're in the process of finishing up a pair of batch-mode based utilities so you can use text files to drive the changes. Stay tune!)
- Directory Map objects. The additional support for Directory Mapobjects was added as a fix to the problem that occurred if a server that is referenced by a DM object is deleted. When a DM is initially created, its HostServer attribute value points to the server that hosts the Volume where the DM's path is. If you later change the path setting, NWAdmin does not update the Host Server attribute. So if the server is later removed from the tree,Directory Map might get invalid mappings. (Novell DeveloperNet has a sample application that does this--called D3MAPOBJ--but since its not supported, we decided to add that functionality to HostEditor as well.) HostEditor verifies that the Host Server property matches the Path attribute and updates the HostServer attribute on request.
- Volume objects. Every Volume object has a mandatory Host Server attribute. If for some reason the server pointed to by this attribute is incorrect, this utility can make the change without you having to delete and recreate the Volume object.
So, why HostEditor if there are already free Novell utilities that can perform similar tasks? Unlike HostDev and D3MAPOBJ, HostEditor is a supported utility. HostEditor has been tested and extensively used in real-world situations. HostEditor runs on Windows 9x and Windows NT workstations, using Client32. Comparing to HostDev, HostEditor is very "lightweight"consisting of a single 32-bit Windows EXE that's only 400KB in size (c.f.HSTDEV.EXE which is 1MB in size). Furthermore, HostEditor can work with four different object types whereas HSTDEV and D3MAPOBJ are "single-typed".
- Submitted to Novell for NetWare 5 certification.
- You can specify an object name by manually typing it in or use the browser button; the browsing starts at the workstation's current context. When manually entering the object name, ensure to use the absolute name path (i.e.starting with a leading period); the name can be typeful or typeless. The same applies to the server and volume names.
- After you have entered or browsed for the desired object (say, PrintQueue), you must "select" it and the current settings are displayed.
- If the object names for the "Current Host Value", "CurrentVolume Value", and "Queue Directory" are longer than can be displayed in their respective fields, simply move the cursor to the display box and you can cursor-right to see the rest of the object name.
- Some of the options have tool tips and you can enable them by checking the "Showtooltips" box at the bottom of the dialog screen.
Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com