windows-server-2003/enduser/netmeeting/nmrk/readme.txt

-------------------------------------------------------------------------------
NMRK- NetMeeting Resource Kit wizard										  |
-------------------------------------------------------------------------------
author: ryanha																  |
-------------------------------------------------------------------------------


----------
Overview:
----------
NetMeeting can be configured via the registry.  There are several registry
keys that can be tweaked. Because of the fact that tweaking the registry is 
error-prone by nature, we do not support users directly tweaking the registry.
With prior releases of the NetMeeting Resource kit, the appropriate registry 
keys and values could be tweaked via the Policy Editor, and .POL files.  This
was not an effective solution for all of our customers, because many of them
did not use the policy functionality for a variety of reasons.  The NMRK 
wizard is the solution to this problem.  A user is able to create a custom
distributable file of NetMeeting that has the selected properties enabled
based on the information gathered in the Wizard. In short, the user enters 
information in a series of dialogs, and the wizard creates a file called
nm21c.exe.  This is a custom distributable that the users can use for 
deployment in their corporation.


---------------
Implementation
---------------

1.) Gather information from the user through a series of dialogs
2.) Find the nm21.exe original distributable
3.) Clean up our stuff from the temp directory in case we terminated
	abnormally in a previous run
4.) Create the directory %TEMP%\nmrktmp
5.) Extract the old distributable to the %TEMP%\nmrktmp directory
6.) Find the MsNetMtg.inf file in the %TEMP%\nmrktmp directory
7.) Alter the MsNetMtg.inf file to contian the new registry settings
		based on the information gathered from the wizard dialogs
8.) Copy the nm21.exe file to the output directory with the new filename, 
		this defaults to:

		<nmrk root>\output\nm21c.exe

9.) Use updfile.exe ( from <nmrk root>\tools\ ) to add the new inf file
		to the <nmrk root>\output\nm21c.exe file.
10.) Delete the files that we created in the %TEMP%\nmrktmp directory
11.) Delete the directory %TEMP%\nmrktmp
12.) MessageBox to the user that we have successfully created the custom
		distributable file.
		

//////////////////////////////////////////////////////////////////////
SEE: in file NmAkWiz.cpp: bool CNmAkWiz::_CreateNewInfFile( void )
//////////////////////////////////////////////////////////////////////
in section [DefaultInstall]
	in subsection AddReg add NetMtg.Install.Reg.NMRK section to the end
	in subsiction DelReg add NetMtg.Install.DeleteReg.NMRK

in section [DefaultInstall.NT]
	in subsection AddReg add NetMtg.Install.Reg.NMRK section to the end
	in subsiction DelReg add NetMtg.Install.DeleteReg.NMRK

create section [NetMtg.Install.Reg.NMRK]
	add the registry keys to be added here

create section [NetMtg.Install.DeleteReg.NMRK]
	add the registry keys to be deleted here


There are some keys in section [NetMtg.Install.DeleteReg.NMRK] that may
also be in an AddReg section elsewhere in the .inf file. In section 
[NetMtg.Install.Reg.PerUser], the keys that start with
	HKCU,\"%KEY_CONFERENCING%\\UI\\Directory\",\"Name"
and	HKCU,\"%KEY_CONFERENCING%\\UI\\Directory\",\"Count"

must all be deleted because we add them based on information from the 
NMRK wizard.  The keys are located in the [NetMtg.Install.Reg.NMRK] section.
In section [NetMtg.Install.Reg.PerUser].


--------------
Dependencies |
--------------
1.) The distributable is assumed to be called nm21.exe
	If there is a new version of NetMeeting that is distributed ( nm22.exe ),
	there are going to be some issues to make sure that nmrk.exe works with
	the new distributable.


2.) INF file dependencies ( See item #7 in imelplementation section above )
	To locate the keys:
	HKCU,\"%KEY_CONFERENCING%\\UI\\Directory\",\"Name"
and	HKCU,\"%KEY_CONFERENCING%\\UI\\Directory\",\"Count"
	from the default .inf file, the locations of these keys relative to
	their section is hard-coded. Also,the names of the keys is hard-coded.
	This was done in the interest of simplicity.  However, NMRK is sensitive
	to changes in the distributable .inf file. The following assumptions are
	made:

	1.) Every netmeeting setup environment executes at least one of the sections
			[DefaultInstall], or [DefaultInstall.NT]. 
	2.) The order in which the above sections appear is [DefaultInstall], 
			then [DefaultInstall.NT].
	3.) In each of the above sections, there are two subsections, AddReg and
			DelReg.
	4.) The order in which these subsections appear is AddReg, then DelReg
	5.) The default .inf file does not have sections titled 
			[NetMtg.Install.Reg.NMRK] or [NetMtg.Install.DeleteReg.NMRK]
	6.) The default .inf file uses the section [NetMtg.Install.Reg.PerUser]
			for all installtion environments.
	7.) The default .inf file has the following format for 
			section [NetMtg.Install.Reg.PerUser]:

------------------------------------------------------------------------------
// somewhere in the MsNetMtg.inf file


[NetMtg.Install.Reg.PerUser]
<WHITE SPACE>
HKCU,"%KEY_CONFERENCING%\\UI\\Directory","Count<ANYCHAR*><ENDLINE>
HKCU,"%KEY_CONFERENCING%\\UI\\Directory","Name<ANYCHAR*><ENDLINE>
HKCU,"%KEY_CONFERENCING%\\UI\\Directory","Name<ANYCHAR*><ENDLINE>
HKCU,"%KEY_CONFERENCING%\\UI\\Directory","Name<ANYCHAR*><ENDLINE>
...
[Strings]

------------------------------------------------------------------------------
// END /* somewhere in the MsNetMtg.inf file */ 


//////////////////////////////////////////////////////////////////////
SEE: in file NmAkWiz.cpp: bool CNmAkWiz::_CreateNewInfFile( void )
//////////////////////////////////////////////////////////////////////

3.) NMRK will fail if the following registry key is not there:
		HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NMRK\InstallationDirectory
		NMRK expects to find that registry key.  If it is not present, 
			NMRK will fail with a message stating that the NetMeeting
			Resource Kit was not properly installed				
4.) File locations:
		
		<nmrk root path> == 
			   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NMRK\InstallationDirectory
			
			nmrk.exe is located in this directory

		<nmrk root path>\tools
			updfile.exe is located in this directory and is used to update
				the .INF file in the custom distributable

		<nmrk root path>\output
			This is the default location for the nm21c.exe custom distributable
		
		<nmrk root path>\source
			This is the default location for the nm21.exe original dist. file
			
		%TEMP%\nmrktmp
			This directory is a temp directory that NMRK creates to extract the
			files needed to create the custom distributable