home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / software / pelne / optionp / iis4_07.cab / ReadMe.txt1 < prev    next >
Text File  |  1997-11-01  |  13KB  |  325 lines
  1. ==============================================================================================
  2.                      Windows NT 4.0 Option Pack Sample Site - Exploration Air
  3.                                           October 1997 
  4. ==============================================================================================
  5.  
  6.                              ****************************************
  7.                              ***                                  ***
  8.                              *** Please Read This Entire Document ***
  9.                              ***                                  ***
  10.                              ****************************************
  11.  
  12.  
  13.  
  14.  
  15. ************
  16. * Contents *
  17. ************
  18.  
  19.     Overview
  20.     Requirements
  21.     Windows NT 4.0 Option Pack for Windows NT 4.0 Workstation
  22.     Setup
  23.     Using Exploration Air
  24.     Behind the Scenes
  25.     Release Notes
  26.  
  27.  
  28.  
  29.  
  30. ************
  31. * Overview *
  32. ************
  33.  
  34. The Windows NT 4.0 Option Pack includes a sample Web site called Exploration Air -- a fictitious
  35. airline company.  The purpose of this sample site is to demonstrate the use of the Windows NT
  36. 4.0 Option Pack to build rich and dynamic Web applications using a wide range of development 
  37. tools.
  38.  
  39. Please be aware that this sample site is for demonstration purposes only.  Some of the 
  40. practices and procedures found herein are not recommended for actual production sites.  In 
  41. addition, this site is not officially supported by Microsoft or any party therein.    
  42.  
  43.  
  44.  
  45.  
  46. ****************
  47. * Requirements *
  48. ****************
  49.  
  50. The Exploration Air sample site uses a variety of technologies found in the Windows NT 4.0
  51. Option Pack.  Some of these options are not included in the Typical install, such as the
  52. sample site.  If you installed the Windows NT 4.0 Option Pack without some of these options,
  53. you can run setup again and add anything you are missing. To see all the features of 
  54. Exploration Air, make sure you have all of the following installed:
  55.  
  56. Required (a majority of the site will be non-functional if these components are not
  57.           installed):
  58.     * Microsoft Internet Explorer (IE) 4.0 (release version)
  59.     * Microsoft SQL Server 6.5 SP3
  60.     * Microsoft Windows NT Option Pack with the following installed:
  61.         + Microsoft Internet Information Server (IIS) 4.0
  62.         + Microsoft Data Access Components 1.5
  63.         + Microsoft Transaction Server
  64.         + Microsoft Management Console
  65.  
  66. Recommended (a small area of the site will be unavailable if these components are not
  67.              installed):
  68.     * Microsoft Windows NT Option Pack with the following installed:
  69.         + Microsoft Internet Information Server (IIS) 4.0 SDK
  70.                   (under IIS | Documentation)
  71.             - unable to view the Fun 'n' Games page
  72.         + Certificate Server
  73.             - unable to use Secure Sockets (HTTPS) for certain areas of the site
  74.               unless you have a server certificate from a trusted authority such as 
  75.               Verisign, GTE etc.
  76.         + Index Server
  77.             - unable to search the site
  78.         + Posting Acceptor Component (under Site Server Express 2.0)
  79.             - unable to conduct a file upload to the sample site
  80.         + Remote Data Service 1.5 (RDS)
  81.             - unable to view RDS version of some pages in Benefits
  82.         
  83. Optional:
  84.     * Page Counter Component
  85.         - unable to see the Page Counter on the default page (this component can be 
  86.           downloaded from the Microsoft home page: http://www.microsoft.com/iis)
  87.  
  88.  
  89.  
  90.  
  91. *************************************************************
  92. * Windows NT 4.0 Option Pack for Windows NT 4.0 Workstation * 
  93. *************************************************************
  94.  
  95. The Windows NT 4.0 Option Pack for Windows NT 4.0 Workstation also comes with the Exploration
  96. Air sample site.  The sample site, however, requires some components that do not ship with 
  97. Windows NT 4.0 Option Pack for Windows NT 4.0 Workstation.  These components are:
  98.  
  99.     * Certificate Server
  100.         - unable to use Secure Sockets (HTTPS) for certain areas of the site
  101.     * Index Server
  102.         - unable to search the site
  103.     * Posting Acceptor Component
  104.         - unable to conduct file upload to the sample site
  105.  
  106.  
  107.  
  108.  
  109. *********
  110. * Setup *
  111. *********
  112.  
  113. Please follow these steps to setup the Exploration Air sample site.
  114.  
  115. Required:
  116. 1) Run the BuildExAir.cmd file in the ...\IISSamples\ExAir\Source\SQL directory.  This script
  117.    builds the SQL Server database for the Exploration Air sample site.  The syntax is:
  118.    
  119.         BuildExAir.cmd [-S:server] [-U:loginID] [-P:password] [-D:dir]
  120.  
  121.    where
  122.    
  123.         [server] is name of the server where SQL Server resides
  124.         [login ID] is the SQL Server admin login (default is 'sa')
  125.         [password] is the admin login password (default is no password)
  126.         [dir] is the location of SQL Server (default is 'c:\mssql')    
  127.  
  128. Recommended:
  129. 2) If you have the IIS 4.0 SDK installed, copy the .class files from the Java Component 
  130.    Framework directory in the SDK (...\IISSamples\SDK\components\java\Framework) to the 
  131.    %SystemRoot%\Java\TrustLib\AspComp directory (you may have to create the AspComp
  132.    directory).
  133.  
  134. 3) If you have Microsoft Certificate Server installed, follow these steps to enable
  135.    SSL for the Exploration Air sample site.
  136.    
  137.     * Before you begin, make sure Certificate Authority service is running
  138.         + Open Control Panel | Services.
  139.         + See that the Certificate Authority service has started.  If not, start the 
  140.           service.
  141.  
  142.     * In order to use SSL, the server must first obtain a server certificate from 
  143.       the Certificate Authority.  Begin by opening the Internet Service Manager in 
  144.       Start | Programs | Windows NT 4.0 Option Pack | Microsoft Internet Information 
  145.       Server.
  146.         + Select Internet Information Server under the Console Root
  147.         + Click Key Manager icon
  148.         + Select the WWW service
  149.         + Click Key | Create New Key
  150.             - Select the button for "Automatically send the request to an online 
  151.               authority"
  152.             - Enter Key Name and Password
  153.             - Enter Organization and Organizational Unit
  154.             - Enter in the Common Name for the fully qualified domain name as used 
  155.               for DNS 
  156.               lookups of your server (for example, "www.yourcorp.com")
  157.             - Enter Country, State/Province, City/Locality
  158.             - Click OK on the message that says the new key has been successfully
  159.                           created
  160.             - On Server Bindings dialog for the web server
  161.                 - Click Add to display the Edit Bindings dialog
  162.                     - In the IP address field, choose "Any unassigned IP 
  163.                       Address"
  164.                     - In the Port number field, choose "Any unassigned Port"
  165.                     - Click OK
  166.                 - Click OK on the Server Bindings dialog
  167.               At this point, make sure the key is listed under the WWW service.  If
  168.               not, copy the key to the WWW service.
  169.                 - Right click over the key
  170.                 - Select Copy in the pop-up menu
  171.                 - Right click over "WWW"
  172.                 - Select Paste in the popup menu
  173.                 - Click OK on the dialog 'Server Bindings' for Web server
  174.         + Close Key Manager
  175.             - Commit your changes
  176.         + Exit the Internet Service Manager
  177.         + On the same machine, open Internet Explorer 4.0 and go to the Exploration
  178.           Air default page -- http://localhost/IISSamples/ExAir/Default.asp
  179.         + Go to "Get our Certificate"
  180.             - On the Certificate Authority Certificate List page, select the 
  181.               certificate for the Certificate Authority
  182.             - On the File Download dialog
  183.                 - Select "Open the file from its current location"
  184.                 - Click OK
  185.             - On the New Site Certificate dialog
  186.                 - Ensure all the check boxes are checked
  187.                 - Click OK
  188.             - On the Root Certificate Store dialog
  189.                 - Click Yes
  190.             - Close Internet Explorer 4.0
  191.         + Open a command prompt
  192.             - Change into the directory %SystemRoot%\system32\inetsrv
  193.             - Run the command 'iisca'
  194.             - Stop the World Wide Web Publishing Service using 'net stop iisadmin /y'
  195.               This will stop all services running under IISAdmin.
  196.             - Start the World Wide Web Publishing Service using 'net start w3svc'
  197.               You can also start the other services that run under IISAdmin
  198.                           using the Internet Service Manager.
  199.  
  200.     * You can now enable SSL in the sample site.
  201.         + Open Internet Explorer 4.0 and go to the Exploration Air home page.
  202.           http://localhost/IISSamples/ExAir/Default.asp
  203.         + Go to the "Site Admin" page
  204.             - Choose "Require Secure Sockets (HTTPS) for Frequent Flyers"
  205.             - Choose "Require Client Side Certificates for Business Partners"
  206.             - Click Apply
  207.             - Return to the Exploration Air home page
  208.       At this point, SSL is enabled on the Exploration Air sample site.  Clients 
  209.       that wish to connect to the Frequent Flyer Club should obtain the Certificate
  210.       Authority's certificate before proceeding.  In addition, clients that wish to 
  211.       access the Business Partners Only page must obtain a client certificate from a 
  212.       Certificate Authority that Exploration Air trusts (such as the one on the
  213.       same server).
  214.  
  215. Optional:
  216. 4) If you have downloaded the Page Counter component from the Microsoft Web site, register 
  217.    the DLL using the regsvr32 program.  The component which comes from the Microsoft Web site
  218.    has a PROGID of "IISSample."  When using this component, make sure you that you use this
  219.    name instead of "MSWC."
  220.  
  221.  
  222.  
  223.  
  224. *************************
  225. * Using Exploration Air *
  226. *************************
  227.  
  228. Once you have completed the setup procedure, you can use IE 4.0 to begin viewing the site at:
  229.  
  230.     http://<servername>/IISSamples/ExAir/default.asp
  231.  
  232. where <servername> is the name of the Web server where you have installed IIS 4.0 and the
  233. Exploration Air sample site or "localhost" if IIS 4.0 and the sample site are installed on
  234. the same computer as IE 4.0.
  235.  
  236.  
  237. Frequent Flyer Club
  238. ===================
  239.     * When asked to join the Frequent Flyer Club, you can choose to join, or use an existing
  240.       account for testing purposes.  The existing account is:
  241.       
  242.         Account Number:    10001
  243.         Password:    password
  244.  
  245.     * A client that wishes to access the Frequent Flyer Club when SSL is enabled must 
  246.       obtain the Certificate Authority's certificate.  (NOTE: If this client, IE 4.0, 
  247.       is the same client used in the Setup procedure, this section is not necessary.)
  248.         + In the Exploration Air home page, go to "Get our Certificate"
  249.             - In the Certificate Authority Certificate List page, select the
  250.               certificate for the Certificate Authority
  251.             - On the File Download dialog
  252.                 - Select "Open the file from its current location"
  253.                 - Click OK
  254.             - On the New Site Certificate dialog
  255.                 - Ensure all the check boxes are checked
  256.                 - Click OK
  257.             - On the Root Certificate Store dialog
  258.                 - Click Yes
  259.             - Click Back to return to ExAir/Default
  260.         + Select Frequent Flyer
  261.       At this point, you should be in the Frequent Flyer page and it should say that
  262.       you are operating in a secure environment.
  263.  
  264.     * A client that wishes to access the Business Partners Only page when SSL is enabled
  265.       must obtain a client certificate from the Certificate Authority for client 
  266.       authentication by the server.
  267.         + Go to the Certificate Server enrollment page
  268.           http://<servername>/CertSrv/CertEnroll/ceenroll.asp where <servername> is 
  269.           the name of the server on which Certificate Server is installed. 
  270.             - Enter information about your client site and click "Submit Request"
  271.             - Download the newly generated certificate
  272.             - Close all instances of Internet Explorer 4.0
  273.             - Open a new instance of Internet Explorer 4.0 and return to the
  274.               Exploration Air home page
  275.             - Go to the Business Partners Only page
  276.                 - You will be asked what certificate to use in accessing the 
  277.                   site
  278.                 - Select the certificate you just downloaded and click OK.
  279.  
  280.  
  281.  
  282.  
  283. *********************
  284. * Behind the Scenes * 
  285. *********************
  286.  
  287. As the sample site uses a great deal of technology, it is worthwhile to understand
  288. what is happening during the installation process.
  289.  
  290.  
  291. 1) Microsoft Transaction Server Packages
  292. ----------------------------------------
  293. Four packages are installed into Microsoft Transaction Server - ExAir, Flight, Benefit and 
  294. TakeANumber.  These are automatically installed when the Exploration Air sample site was
  295. installed during the Windows NT 4.0 Option Pack setup (if you chose to install the sample
  296. site).  This is accomplished using the ExAirInstall.exe file located in the ...\IISSamples\
  297. ExAir\bin directory.
  298.  
  299. ExAirInstall calls Microsoft Transaction Server to register the packages.
  300.  
  301.  
  302. 2) IIS Settings
  303. ---------------
  304. IIS settings for ExAir are automatically setup by ExAirInstall.exe. This includes directory 
  305. security, process isolation, etc.
  306.  
  307.  
  308. 3) Components Registered
  309. ------------------------
  310. OneC++ COM components, ProdInfo.dll, is installed and registered using RegSvr32.exe.  
  311. One Java COM component, HiddenWords.class, is installed and registered using JavaReg.exe.  
  312. One final component, PermChk.dll, is also installed and registered using RegSrv32.exe.
  313.  
  314. IMPORTANT NOTE: Some functions listed above are called automatically during the installation
  315. of the Windows NT 4.0 Option Pack.
  316.  
  317.  
  318.  
  319.  
  320. *****************
  321. * Release Notes *
  322. *****************
  323.  
  324. Please refer to the Windows NT 4.0 Option Pack release notes for any additional issues.
  325.