Engineering Product Documents : .NET 2007.

2 Install Functional
Requirements

This page last changed on Jun 30, 2007 by BWint.

Confidential
Infragistics® Confidential and Proprietary - For Internal Use Only

The Problem

Create an install for NetAdvantage for .NET 2007 Volume 2 CLR 2.0.

Use Cases

1. The user performs a standard complete install of the product.

2. The user performs a custom install of the product to install parts of the product.
3. The user installs on Windows XP, Windows Server 2003 or Windows Vista.
4. The user installs as licensed when using a valid license key and as trial with an invalid license key.

The Proposed Solution

Create a Windows Install-based install for the product. Each installer will be a .exe file (with the .msi and
.ini compiled into this exe).

There will be separate installers for product, help and samples:

• NA for .NET Product

• NA for .NET Docs
• NA for .NET SDK
• NA for WinForms Product
• NA for ASPNET Product
• NA AppStylist for .NET Product (same as 71)

Note: The AppStylist chms must be installed along with AppStylist in the Product installers, not
the Help installer.

To be provided as the following zipped bundle downloads:

• NA for .NET Package (Product, Docs, & SDK)

• NA for ASP.NET Package (Product, Docs, & SDK)
• NA for Windows Forms Package (Product, Docs, & SDK)

Basic Product Information

Document generated by Confluence on Jul 02, 2007 04:13 Page 1

 • NA for .NET Product:
Installer Name: NetAdvantage_NET_20072_CLR20.exe
Product Name: Infragistics NetAdvantage for .NET 2007 Vol. 2 CLR 2.0
Key Prefix: 9304
Root Installation Directory: [INSTALLDIR]\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0

• NA for ASPNET Product:

Installer Name: NetAdvantage_ASPNET_20072_CLR20.exe
Product Name: Infragistics NetAdvantage for ASP.NET 2007 Vol. 2 CLR 2.0
Key Prefix: 9304
Root Installation Directory: [INSTALLDIR]\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0

• NA for WinForms Product:

Installer Name: NetAdvantage_WinForms_20072_CLR20.exe
Product Name: Infragistics NetAdvantage for Windows Forms 2007 Vol. 2 CLR 2.0
Key Prefix: 9304
Root Installation Directory: [INSTALLDIR]\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0

• NA AppStylist for .NET:

Installer Name: NetAdvantage_AppStylist_20072.exe.
Product Name: Infragistics NetAdvantage AppStylist for .NET 2007 Vol. 2.
Key Prefix: 9304
Root Installation Directory: [INSTALLDIR]\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0

• NA for .NET Docs:

Installer Name: NetAdvantage_NET_20072_CLR20_Help.exe
Product Name: Infragistics NetAdvantage for .NET 2007 Vol. 2 CLR 2.0 Help
Root Installation Directory: [INSTALLDIR]\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0\

• NA for .NET SDK:

Installer Name: NetAdvantage_NET_20072_CLR20_SDK.exe
Product Name: Infragistics NetAdvantage for .NET 2007 Vol. 2 CLR 2.0 SDK
Root Installation Directory: [COMMONDOCUMENTS]\Infragistics\NetAdvantage for .NET 2007
Vol. 2 CLR 2.0\SDK
[COMMONDOCUMENTS] = "C:\Documents and Settings\All Users\Documents" on WinXP.
"C:\Users\Public\Documents" on Vista.

Installer Prerequisites

This list describes the assets the user must have installed prior to being able to install NetAdvantage for
.NET.

• Windows Installer 3.0 (to allow for patching support)

License Keys

The install should support the following license keys:

• 9104, 9104, 9106 - NetAdvantage Enterprise, which licenses all NA products.

Document generated by Confluence on Jul 02, 2007 04:13 Page 2

 • 9204, 9205, 9206 - NetAdvantage for .NET Platform, which licenses WinForms, ASP.NET and WPF.
• 9304, 9305, 9306 - NetAdvantage for .NET Full, which licenses .NET, ASP.NET, and Windows Forms.
• 9404 - NetAdvantage for ASP.NET, which licenses ASP.NET
• 9504 - NetAdvantage for Windows Forms which licenses Windows Forms
• 9804 - NetAdvantage AppStylist for .NET which licenses AppStylist

See DevDrops for more info:

• Files\20072\NetAdvantage Licenses vs Installs (v72+).xlsx contains details on how licenses should

work.
• Files\20072\TestLicense Keys - NA20072.txt contains test license keys.

New Controls

SourceSafe Locations

This list describes the Source Control location of the installer assets:

Gauge Presets (EW)

$/Web Elements/20072_CLR2/WinPresets/UltraGauge
$/Web Elements/20072_CLR2/WebGauge/Presets/

Others (EW)
$/Installation Automation/Shared Resources/Readme/20072/Install - Vol
$/Installation Automation/Shared Resources/Readme/20072/QuickStart

Critical Changes From Previous Versions

• Update installer UI logos to 72 versions.

• Update license file with updated version.
• New set of 'WebUI.Design.Win....' assemblies (see
http://wiki/display/IGProdDocs/WebUI.Design+2007.2+Implementation+History).
• No separate trial assemblies for ASP.NET. The same set of assemblies will be installed for both
licensed and trial installs. This will result in the Trial notification dialog no longer being displayed for
ASP.NET applications at run-time. There are no changes to the ASP.NET design-time experience so
this should act similar to WinForms and previous releases.
• Fix for 'App Styling Configuration Dialog Issue BR22378: Infragistics2.Web.AppStylingConsole.AddIn
and Infragistics2.Web.AppStylingConsole.v7.1.dll names incorrect'.
• Allow copy & paste into Product Key field (Fix for NA for .NET Volume Install Issue BR20955: Key
Pasting).
• Changes requested in 'NA for .NET Volume Install Issue BR20957: Install Types'.
• The toolbox utility will be run automatically as the last part of the install (after all other dlls and
prior to the Finish dialog).
• Remove Toolbox Utility link from the Start menu, but keep a mention of it in the quick start and
modify QuickStart to say "if you're not seeing the controls in the toolbox...".
• A new dialog named 'Installation Notes' will be added to the installer as early in the UI sequence as
possible to display the critical install notes in RTF format. This file should also be installed to the
same folder as the QuickStart.
• Install samples to '[COMMONDOCUMENTS]\Infragistics\NetAdvantage for .NET 2007 Vol. 2 CLR

Document generated by Confluence on Jul 02, 2007 04:13 Page 3

 2.0\Samples'.
• No virtual folders should be created for the Samples. They will no longer depend on IIS.
• No special permissions need to be set for the Samples subfolders.
• Add a shortcut to the Samples folder in the start menu and include a reference in the QuickStart.
• A new registry key "Infragistics\NetAdvantage\Net\Full\CLR2x\Version7.2\ProductFolderName" with
value "Infragistics\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0" will be created during install. This
key must always be added to the registry regardless of the license key used to install NA.
• Any other apps that need to write data files will save to [USERDOCUMENTS]\Infragistics\<Product>
([USERDOCUMENTS] = 'My Documents' of current user) using the new ProdutFolderName registry
key above. See BR23447 and BR22039 for more details.
• Fix for 'AppStylist for ASP.NET Issue BR22039: AppStylist Crashing on Non-Admin User'.
• Fix for 'AppStylist for Windows Forms Issue BR23447: AppStylist dat file location not writable with
Vista UAC'.
• Separate Project Upgrade Readme will be removed. Information contained in the file is already in
the Help.
• Separate APTCA Readme will be removed. Information contained in the file is already in the Help.
• Complete UAC support with Trial to Licensed issue resolved
(From BrianW's email: I've resolved the issue involving going from a trial to licensed version on
Vista with UAC enabled. In the past, when you hit the next button on the User Information dialog
where you entered your CDKey, we would make a call to a wisescript that writes a SerialNumber
key in the registry. For whatever reason, with UAC enabled it decided to throw an error saying you
have to run the install as an admin (other wisescripts don't seem to have this problem and we are
running the install as admin). To fix this, I made the call to the exe in the Execute Deferred
sequence as opposed to in the UI sequence.)
• No need to create a special MSPortal install. MSPortal license key will be generated and provided to
the PM and Martketing to hand out to Microsoft.
• APTCA and signed copies of the assemblies will be installed regardless of installing a trial or licensed
version.
• The WebSchedule database files will be installed to
[COMMON_DOCUMENTS]\Infragistics\NetAdvantage for .NET 2007 Vol. 2 CLR
2.0\WebSchedule\Data. The WebDataDir registry key will refer to this location so that WebSchedule
can connect to the database there by default.

Installer Assets and Install Directory Structure

File System

This list describes the files that will be included in the installer, and their placement on the destination file
system (starting from the install root)

\NetAdvantage for .NET Quick Start.htm

\quickstart_images\

\NetAdvantage_NET_Installation_Notes.rtf

\ASP.NET\APTCA
\ASP.NET\APTCA\ASPNET_20072_CLR20_APTCA.zip (zip containing signed copies of all control
assemblies in the \Bin folder)

Document generated by Confluence on Jul 02, 2007 04:13 Page 4

\ASP.NET\Bin - Signed
\ASP.NET\Bin - Signed\ASPNET_20072_CLR20_Bin_Signed.zip (zip containing signed copies of all control
assemblies in the \Bin folder)

\ASP.NET\APTCA - Signed
\ASP.NET\APTCA - Signed\ASPNET_20072_CLR20_APTCA_Signed.zip (zip containing signed copies of all
control assemblies in the \Bin folder)

\Windows Forms\Bin - Signed

\Windows Forms\Bin - Signed\WinForms_20072_CLR20_Bin_Signed.zip (zip containing signed copies of
all control assemblies in the \Bin folder)

COMMON_DOCS\Infragistics\NET 2007.2CLR20\Samples\WinForms (copy the SamplesBrowser.html for

WinForms, which provides links to run/browse dirs)

COMMON_DOCS\Infragistics\NET 2007.2CLR20\Samples\ASP.NET\Binaries\ (copy the batch files and

webserver executable here to start the ASP.NET browsers)
COMMON_DOCS\Infragistics\NET 2007.2CLR20\Samples\ASP.NET\WebShowcase (copy the webshowcase
project files here)
COMMON_DOCS\Infragistics\NET 2007.2CLR20\Samples\ASP.NET\WebFeatureBrowser (copy
the webfeaturebrowser project files here)

Programs Menu

[ProgramFiles]\Infragistics
[ProgramFiles]\Infragistics\NetAdvantage for .NET 2007 Vol. 2 CLR 2.0

Product Installs

Structure under the above menu should be as follows (tooltips are marked purple):

• Experience NetAdvantage for .NET

° Get the SDK -> shortcut to http://www.infragistics.com/dotnet/netadvantagedownloads.aspx
(Download the Samples in Our SDK!)
° Browse ASP.NET Samples Online -> shortcut to http://samples.infragistics.com (Explore
the NetAdvantage for ASP.NET Samples Online! )
• Get Going
° Quick Start (Get started, learn more, get help, and get connected!)
° Register Your Product (Online) -> shortcut to http://www.infragistics.com/register (Register
for our many online services and support.)
• Get Help
° Documentation (Local) -> shortcut to local docs if applicable (Read the docs!)
° Documentation (Online) -> points to http://help.infragistics.com (Get the latest documentation
online.)
° Get Help (Online) -> shortcut to http://www.infragistics.com/gethelp (Check out the many
ways we can help you!)
• NetAdvantage AppStylist for .NET <- copy from previous setup
• NetAdvantage for .NET Tools <- copy from previous setup
• NetAdvantage for .NET Downloads -> shortcut to
http://www.infragistics.com/dotnet/netadvantagedownloads.aspx (Check Out NetAdvantage for

Document generated by Confluence on Jul 02, 2007 04:13 Page 5

 .NET Downloads!)
• License Agreement -> shortcut to license.txt (Read the NetAdvantage license agreement.)

Help Install

Structure under the above menu should be as follows (tooltips are marked purple):

• Get Help
° Documentation (Local) -> shortcut to local docs if applicable (Read the docs!)
° Documentation (Online) -> points to http://help.infragistics.com (Get the latest documentation
online.)
° Get Help (Online) -> shortcut to http://www.infragistics.com/gethelp (Check out the many
ways we can help you!)
• NetAdvantage for .NET Downloads -> shortcut to
http://www.infragistics.com/dotnet/netadvantagedownloads.aspx (Check Out NetAdvantage for
.NET Downloads!)
• License Agreement -> shortcut to license.txt (Read the NetAdvantage license agreement.)

SDK Install

Structure under the above menu should be as follows (tooltips are marked purple):

• Experience NetAdvantage for .NET (Note: work with Tony on the ASP.NET samples; Ed on the
WinForms.)
° WinForms Samples -> shortcut to \Samples\WinForms\SamplesBrowser.html (Browse the
NetAdvantage for Windows Forms Samples!)
° ASP.NET Samples -> shortcut to \Samples\ASP.NET\Binaries\Infragistics.Guidance.Web.Start
/auto /path:<path to samples> (Explore the NetAdvantage for ASP.NET Samples!)
° Browse ASP.NET Samples Online -> shortcut to http://samples.infragistics.com (Explore
the NetAdvantage for ASP.NET Samples Online! )
° Dig into the Code -> shortcut to \Samples (Dive into the Code for our Samples!)
• Get Going
° Quick Start (Get started, learn more, get help, and get connected!)
° Visual Studio 2005 Starter Kits -> shortcut to \Starter Kits\StarterKits.html (Get going fast
with these VS starter kits!)
• Get Help
° Documentation (Online) -> points to http://help.infragistics.com (Get the latest documentation
online.)
° Get Help (Online) -> shortcut to http://www.infragistics.com/gethelp (Check out the many
ways we can help you!)
• NetAdvantage for .NET Downloads -> shortcut to
http://www.infragistics.com/dotnet/netadvantagedownloads.aspx (Check Out NetAdvantage for
.NET Downloads!)
• License Agreement -> shortcut to license.txt (Read the NetAdvantage license agreement.)
• NetAdvantage CAB Extensibility Kit <- copy from previous setup

Limitations (Non-Goals)

Describe what we do not plan to solve, non-goals for this feature.

Document generated by Confluence on Jul 02, 2007 04:13 Page 6

Document generated by Confluence on Jul 02, 2007 04:13 Page 7