IIS03W/IIS03S/IIS03E/IIS03DC: Installation Reference

Each IIS03y appliance is built using the following generic Windows Server appliance as a base class:

• IIS03W - WIN03W
• IIS03S - WIN0364S
• IIS03E - WIN0364E
• IIS03DC - WIN0364DC

Note that in the following instructions, the "y" placeholder in WIN03y and IIS08y is for the Windows edition that the appliance/app is based upon ("S" for Standard, "E" for Enterprise, "DC" for DataCenter, "W" for Web).

1. Create an application that contains an instance of WIN03y and branch the instance (referred to below as a singleton).
2. To speed up the appliance creation process, configure the singleton's default resources to cpu=1 and memory=1G:
   • select the singleton in the application editor
   • under the Appliance menu select Resources
   • modify the default resources as specified above
3. If necessary, resize the WIN03y boot volume to ensure that there is at least 1Gb of free disk space (use the vol resize command in the web shell).
4. Edit the class and enable the external interface:
   • select the singleton in the application editor
   • under the Appliance menu select Modify Boundary
   • select the Interfaces tab
   • check the External Interface checkbox under Raw Interfaces
5. Start the application and open up the graphic console of the singleton using the AppLogic GUI (on the Applications tab, select your application and login to the graphical console using the Login (graphic) button at the top of the page).
6. Login to the Windows appliance as the administrator.
7. If you have not already installed the .NET Framework 3.5 SP1 do so now:
   • configure the external interface with usable network settings (this is the first enumerated network interface):
     • access Control Panel=>Network Connections=>Local Area Connection X=>Properties=>Internet Protocol (TCP/IP)=>Properties; click on Use the following IP address and enter usable values for your grid (IP Address, netmask, gateway, DNS server)
     • or, in the command shell:
       • netsh interface ip set address name="Local Area Connection X" static [ip-address] [netmask] [gateway] 1
       • netsh interface ip set dns name="Local Area Connection X" static [dns-ip]
   • open Internet Explorer, search for .NET Framework 3.5 SP1; download and install it
8. Install IIS components:
   • Control panel->Add or Remove Programs->Add or Remove Windows Components
   • select Application Server and Details... and check the following:
     • Application Server Console
     • Enable network COM+ access
     • under the details section for Internet Information Services(IIS) check the following:
       • Common Files
       • File Transfer Protocol (FTP) Service
       • Internet Information Services Manager
       • SMTP Service
       • under the details section for World Wide Web Service check the following:
         • Active Server Pages
         • Remote Administration (HTML)
         • World Wide Web Service
   • Uncheck all Application Server components which are not listed above.
9. Install the IIS msi. This self-executing installer can be downloaded from the grid controller through the default interface of the singleton. This interface has already been properly configured through DHCP.
   • To find the internal IP address of the grid controller, in a command line shell execute ipconfig /all and note the IP address of the DHCP server for the last enumerated interface (e.g., Local Area Connection 5).
   • Point IE at http://IP-address:8080/download/ and download the current Windows IIS msi (e.g., IIS_Windows-1.0.0-1.msi):
     • Right-click on the msi file and select Save Target As to download the file to the desktop.
   • Double-click on the msi file on the desktop to perform the installation.
   • Delete the msi file and empty the Recycle Bin.
   • Delete the following folders after IIS is installed (these are corrupted folders and need to be deleted in order to resize the volume at a later time):
     • WINDOWS\assembly\GAC_32\System.EnterpriseServices\2.0.0.0__b03f5f7f11d50a3a\
     • WINDOWS\assembly\GAC_MSIL\IEExecRemote\2.0.0.0__b03f5f7f11d50a3a\
10. In a Cygwin bash shell remove the file /appliance/passwd.stamp; this ensures the appliance will generate a new Administrator password on the first boot after instantiation.
11. Stop the application and edit the class:
    1. change the class icon color to blue
    2. change the class name to IIS03y
    3. change the class description (e.g., Web Server Appliance - based on Windows Server 2003 Standard Edition R2 32/64-bit (v1.0.0-1); IIS and ASP.NET included)
    4. change class category to Web Servers
    5. add a placeholder volume (name: content; mount on D:\)
    6. remove the external interface
    7. modify the terminals:

       Terminal Name	Direction	Protocol
       in	In	http
       db	Out	any
       fs	Out	cifs
       log	Out	cifs
       aux	Out	any
       net	Out	any
       mon	Out	cce

       • mark the net terminal as a gateway
    8. add the following properties:

       Name	Type	Default	Constraints
       content_on_fs	string	off	on|off
       docs_dir	string	(empty)
       logs_enabled	string	off	on|off
       logs_base_dir	string	/
       index_files	string	default.htm default.asp default.aspx index.html
       max_connections	integer	(empty)	min = 1, max = 999999
       idle_timeout_sec	integer	15
       data_timeout_sec	integer	300

    9. Set resources:

       Resource	Minimum	IIS03W	IIS03S	IIS03E	IIS03DC	Default
       CPU	0.10	2	4	8	32	0.25
       MEM	256M	2G	4G	64G	64G	512M
       BW	1M	2G	2G	2G	2G	250M

12. It is recommended to verify the health of the singleton's boot volume by executing the following command from the web shell: vol fscheck name_of_volume
13. Move IIS03y to a catalog (3tera recommends system_ms).
14. The IIS03y appliance is now ready for use in your AppLogic applications.

-- Main.OlegSmolov - 08 Apr 2009