-------------------------------------------------------------------------------
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
