ColdFusion

9 Vertical Cluster Server Build

Author:RickZawadzki|www.heywrecker.com|rickzawadzki@gmail.com|@heywrecker

Intro
ThisdocumentmakestheassumptionthatyouwillberunningColdFusion9asamultiinstanceinstallon WindowsServer2008runningIIS.Itriedtomakeitasthoroughaspossible,butpleasekeepinmindthat itisonlyintendedtoserveasaguide.Imakenoguaranteesorpromisesthatthisdocumentwillwork, withoutmodification,inyourspecificenvironment. Goodluck!

Add Website Source Code to Physical Server

Itgoeswithoutsayingthatyoullfirstneedtoaddyourwebsitesourcecodetoyourserver. Beginbycreatingadirectoryatyourwebroot.IntestthismightbeyourC:drive;inproduction itmaybealargerD:volume.Namethedirectorywhateveryouwant.Illrefertoitasyour Projectdirectoryfromhereonout. Ifyourerunningasinglewebsite,youcandeployyoursourcecoderighthere,althoughId recommendagainstit.Inthelongrun,yourebetteroffcreatingasubfolderforyourspecific projectanddeployingyourcodetothatfolder.

Install IIS 7+
Well,youneedawebserverandifyourerunningWindowsServer2008R2,thenIISisgoingtobeit. FollowtheseinstructionsforWindowsServer2008R2andyoushouldbegolden: ClicktheStartmenu,clickAdministrativeTools,andthenclickServerManager. Inthenavigationpane,expandRoles,thenrightclickWebServer(IIS),andthenclickAdd RoleServices. ExpandWebServer(Installed)thenexpandCommonHTTPFeatures.Makesurethe followingoptionisselectedunderCommonHTTPFeatures: o HTTPRedirection ExpandWebServer(Installed)thenexpandApplicationDevelopment.Selectthefollowing optionsunderApplicationDevelopment: o ASP.NET o .NETExtensibility o ISAPIExtensions

o ISAPIFilters ExpandManagementTools(Installed)andselectthefollowingoptionsundertheIIS6 ManagementCompatibilitysection: o IIS6MetabaseCompatibility o IIS6WMICompatibility o IIS6ManagementConsole ClicktheNextbutton. ConfirmtheinstallationselectionsandpresstheInstallbutton.

If,forwhateverreason,youredeployingamultiinstanceColdFusionserverontoWindows7,youcan setupIISwiththeseinstructions: BeginbylocatingWindowsFeaturesundertheControlPanel>ProgramsandFeatures NavigatethroughthefeatureshierarchyunderInternetInformationServicesandbesurethe followingtwofeaturesareselected: o ISAPIExtensions o ISAPIFilters(needtolookintothis) o IISMetabaseandIIS6ConfigurationCompatibility ColdFusionisnowreadytorunfromIIS.

Install ColdFusion 9
Nowitstimetoinstalltheapplicationserver.Flavorofchoice?ColdFusion9EnterpriseEdition. AutoRuntheinstallationCDordoubleclicktheinstallationfileyoudownloadedfrom Adobe.com. MicrosoftVC++2008RuntimeIfpromptedtoinstallthisruntimepackage o ClickOK o Theinstallerwillneedtoberestarted AccepttermsofLicenseAgreement. SelectInstallationType o EnteryourColdFusion9Enterpriseserialnumber. SelectConfigurationType o ChoosetheEnterpriseMultiserverConfigurationoption. SubcomponentInstallation o Uncheck: ColdFusion9Documentation o Checkthefollowing: ColdFusion9ODBCServices ColdFusion9SearchServices ColdFusion9SolrServices .NETIntegrationServices

SelectInstallationDirectory o ChoosetheDrive:\JRun4datadriveandpath. ColdFusion9.NETIntegrationService o ChoosetheDrive:\ColdFusion9DotNetServicedatadriveandpath. ConfigureWebServers/Websites o ChoosetheAllIISWebsitesoption. ChooseAdobeColdFusion9AdministratorLocation o ChoosetheDrive:\inetpub\wwwrootdriveandpath. AdministratorPassword EnableRDS o DONOTcheckEnableRDSforproductionservers. PreInstallationSummary o ReviewalloftheinstallationinformationthenpresstheInstallbuttonwhenreadyto proceed. LaunchtheConfigurationWizard o EnterintheAdminPassword o Lettheconfigwizarddoitsthing,thencloseitonceitcompletesandplacesyouinthe CFAdmin

Shutdown Coldfusion Services Before Continuing

ClicktheStartmenu,clickAdministrativeTools,thenclickServices.ShutdownallJRun serverinstancescontainingColdFusion9priortoupdatingtheMultiserverinstallation: o MacromediaJRunAdminServer o MacromediaCFusionServer ClicktheStartmenu,clickAdministrativeTools,thenclickServices.Shutdownall ColdFusionODBCservicesandColdFusion9SearchServicespriortoupdatingtheMultiserver installation: o ColdFusion9.NETService(Mayalreadybeoff) o ColdFusion9ODBCAgent o ColdFusion9ODBCServer o ColdFusion9SearchServer o ColdFusion9SolrService Oncethepreviouslymentionedserviceshavebeenshutdown,proceedtotheCF9Update (9.0.1)

Install ColdFusion 9 Update 1 (9.0.1)

Updatesarealwaysapainwhendealingwithaproductionserver.Thankfully,weregettingstartedfrom scratchhere,soitsfarlesspainful.

AutoRuntheinstallationCDordoubleclicktheinstallationfilethatyoudownloadedfrom Adobe.com. AccepttermsofLicenseAgreement. SelecttheMultiserverConfiguration SelectlocationwhereColdFusion9islocated o ChoosetheDrive:\JRun4datadriveandpath. SelectlocationwhereColdFusion9CFIDEfolderislocated o ChoosetheDrive:\inetpub\wwwroot\CFIDEdatadriveandpath. PreInstallationSummary o ReviewalloftheinstallationinformationthenpresstheInstallbuttonwhenreadyto proceed. Theinstallationiscomplete.PresstheDonebuttontoclosetheinstaller.

Create ColdFusion Clusters

ThisiswherethemagicoftheEnterpriseEditionhappens.Youregoingtocreateyourapplication cluster(s).Youcancreateoneclusterwithmultipleinstancesormultipleclusterswithmultiple instances.Theonlylimitsaretheresources(read:RAM)thatareatyourserversdisposal.Keepinmind thatyoullneedsomeRAMfortheOperatingSystemandJRunoverhead. LogintotheCFusionColdFusionAdministratorbygoingtothefollowingURL: http://127.0.0.1/CFIDE/administrator/index.cfm ClickontheEnterpriseManagermenuitem,then,clickontheClusterManagermenuitem Establishyourcluster(s). EnterthenameofthefirstclusterintotheClusterNamefieldandclickAdd. Repeatthisstepforeachoftheremainingclusters.

Create ColdFusion Server Instances

Aclusterisjustashellfortheinstances.Withoutthose,itsnothing.Soletscreatesome! ClickontheEnterpriseManagermenuitem,then,clickontheInstanceManagermenu item. ClicktheAddNewInstancebutton. EnterthenameoftheserverintheServerNamefield. o (ex.Sample_001) ChecktheCreateWindowsServicebox. VerifythattheAutoRestartServiceboxischecked. PresstheSubmitbutton. Bepatient. MakeanoteoftheHTTPport. ClicktheReturntoEnterpriseManagerlink.

Repeattheaboveprocessforeachoftheserverinstancesthatneedtobecreated.

Add Instances / Servers to Clusters

Nowyouneedtotietheinstancesintotheirrespectiveclusters. ClickontheClusterManagerlinkfromtheEnterpriseManager. Clickonyourclustertobeginaddinginstances. Theboxintheleftindicatesinstances/serversthatarenotyetclustered. o ClickonthefirstSample_00*instance. o Thenclickthe>buttontomovethatinstanceovertoyourcluster. o Repeatforeachoftheremaininginstances/servers. Selectthefollowingclusteroptions: o ClusterAlgorithm: RoundRobin o StickySessions: Checked o ReplicateSessions: Checked ClicktheSubmitbutton. Repeatfortheremainingclustersandinstances.

Add / Restore ColdFusion Instance Settings

Ifyourecreatingaservercompletelyfromscratch,ignorethissectionandmoveontothenext. However,thoseofyouwhoarepreppinganewservertoreplaceanexistingonemightalreadyhavea ColdFusionArchive(.car)filethatyoudliketodeploy. LogintotheColdFusionAdministratorfortheSample_001instance. NavigatetothePackaging&DeploymentsectionoftheAdministratormenu. ClicktheColdFusionArchiveslink. SelectyourColdFusionarchivefile. ClicktheDeploybutton;aDeploymentWizardwindowwillpopup. VerifyalloftheinformationispresentintheArchiveSummary. ClickNext. ReviewthepathslistedintheDeployLocations.Bydefault,thesepathswillreferenceC:\. o IfyouareusingadriveotherthanC:,pleaserepointthesepathstothedriveassignment ofyourexternaldriveandverifythatthepathslistedintheDeploymentWizardare presentonthatdrive. o IfthereisareferencetoaspecificColdFusionserverinstance(ex.Sample_001)please updatethatinthepathnametoreflecttheserverinstanceyouarecurrentlyworking on. ClicktheDeploybutton.

ADeploySuccessfulorDeployedwithErrorspopupwillopen.ClickOktocloseit.Ifyou receiveanyerrors,makeanoteofthoseanddowhatyouneedtostraightenoutyour ColdFusionarchivedeployment.

Congratulations!YourColdFusionserverinstancesaresetup!Nowrepeatthetaskfortheremaining yourremainingclusterinstances. IMPORTANT!!! Onceallofyourinstancesettingshavebeenupdated,Restarttheserver.Thiswillensurethat theWebServerConfigurationToolrecognizesalloftheclusters.

SetUp IIS Application Pools

Ifyourerunningasingleserverwithmultiplewebapplications/projectsandthoseprojectsareeach assignedtotheirowncluster,whynotgoalloutandassignthemtotheirownIISApplicationPool?This ensuresathoroughisolationofapplications. ClickontheStartmenu,clickAdministrativeTools,andclickInternetInformationServices (IIS)Manager. Clickthe+signnexttotheservernametoexpandtheview. RightclickontheApplicationPoolsoptionandclicktheAddApplicationPoolcontextual menuoption. o Inthenamefield,enterYourAppName.ClicktheOkbutton. o WithintheApplicationPoolspane,clickontheapplicationpoolthatwasjustcreated. o ClicktheAdvancedSettingsoptionfromtheEditApplicationPoolsectionofthe ActionspaneontherighthandsideoftheIISManagerscreen. o UndertheProcessModelsectionoftheAdvancedSettingswindow,changethe IdentitythattheapplicationpoolrunsundertoNetworkService. o ClicktheOkbutton. Repeattheaboveprocessasmanytimesasyouneedtocreateapplicationpoolsforeachof yourwebapplications/projects.

SetUp IIS Sites CFIDE

WeneedaneasywaytogettotheCFIDE.Followingtheseinstructionsshouldgetyouwhereyouneed tobe. WithintheIISManager,clickthe+signtoexpandtheSitesfolderintheConnectionspane onthelefthandsideoftheIISManagerscreen. RightClickontheSitesfolderandselecttheAddSiteoptionfromthecontextualmenu. o InthesitenamefieldoftheAddWebSitewindow,enterCFIDE. o ClicktheOkbutton.

ClickthebuttonnexttothePhysicalPathfieldanddrilldownuntilyoureachthe wwwrootdirectorythatislocatedwithintheinetpubparentdirectory.Thisis whereColdFusioninstallsthedefaultCFIDEsite. o ClickthewwwrootfolderthenclicktheOkbutton. o WithintheHostNamefield,enterincfusion. o ClicktheOkbutton. DoubleclicktheDefaultDocumenticon,andusingthetoolspresent,removealldefault documentnamesotherthanindex.cfm. o

SetUp IIS Sites Your Site

Thenameofthegameisgettingyoursiteupandrunning.WevegotColdFusioninstalledandourIIS ApplicationPoolscreated.NowweneedtocreateanIISsiteforourproject. WithintheIISManager,clickthe+signtoexpandtheSitesfolderintheConnectionspane onthelefthandsideoftheIISManagerscreen. RightClickontheSitesfolderandselecttheAddSiteoptionfromthecontextualmenu. o InthenamefieldoftheAddWebSitewindow,enteranameforyoursite. o ClicktheSelectbuttonnexttotheApplicationPoolfieldandchoosetheapplication poolthatyoupreviouslycreatedforyoursite. o ClicktheOkbutton. o ClickthebuttonnexttothePhysicalPathfieldanddrilldownuntilyoulocate yourwebapplicationdirectorythatislocatedwithintheProjects\parentdirectory. o ClicktheGoToWebfolderthenclicktheOkbutton. o WithintheHostNamefield,enteringoto. o ClicktheOkbutton. Nowthatyoursitehasbeenadded,clickyoursitefromwithintheConnectionspaneoftheIIS Manager. ClicktheBindingscommandfromtheActionspane. o ClicktheAddbuttononcetheSiteBindingswindowopens. o WithintheHostNamefield,enteryourdefaultbinding. o ClicktheOkbutton. o RepeatforanyadditionalhostnamesthatyouwantyourIISsitetorespondto. ClicktheClosebuttonwithintheSiteBindingswindowtoreturntotheIISManager. DoubleclicktheDefaultDocumenticon,andusingthetoolspresent,deletealldocument namesotherthanindex.cfmandindex.htmlmovetheindex.cfmfiletypetothetopofthe DefaultDocumentlist.

Connect ColdFusion Instances to Website

Wereinthehomestretchnow.Togetyourwebsitesupandrunningweneedtodoonelastthing connectColdFusiontoyourIISwebsite.

ClicktheStartmenu,clickAllPrograms,clickAdobe,clickColdFusion9(Multiserver version),thenclicktheWebServerConfigurationTooltolaunchit. ClicktheAddbutton. UndertheJRunServerPropertiessection, o verifythattheJRunHostfieldreadslocalhost o selectyourclusterfromtheJRunServerfielddropdown. o Note:Ifclustersdonotshowuponthislist,pleaserestarttheserverbecauseyou missedastepaboveyoushouldlearntoreadbetter. UndertheWebServerPropertiessection, o VerifythattheInternetInformationServer(IIS)dropdownisselectedfromtheWeb Serverfield. o SelectyourwebapplicationentryfromtheIISWebSitefielddropdown. ChecktheConfigurewebserverforColdFusion9Applicationsbox. ClicktheOKbutton. AConfirmwindowwillpopup.ClickYestocontinue. AConfirmwindowwillpopuppromptingtorestartthewebserver.ClickYestocontinue withthewebserverrestart. Repeatfortheanyadditionalwebsites.Besuretoassignthemtotheappropriatecluster. ClicktheExitbuttononceallsiteshavebeenconfiguredtotheirrespectiveclusters. Restarttheserver.

Need SSL? Install the Certman PlugIn for CFusion Administrator

TheserverbuildthatthisdocumentwasbasedoffofwasbuiltinsideaDMZ.ThatmeantthatIhadto installtheSSLkeyfileintheColdFusionadministrator.So,ifyoureinasimilarsituation,followingthe instructionsbelowshouldhelp. MakesurethatyouhavetheCertmanresourcesandtheSSLkeyfile(.cer)availableonyour server. Copythefollowingresources: o Certman(dir) o Custommenu.xml(file) Pastetheseresourcesintotheadministratordirectorylocatedyourserver: o Drive:\inetpub\wwwroot\CFIDE\administrator OpenupawebbrowseronAtlantisandlogintothefollowingURL: o http://cfusion/CFIDE/administrator/index.cfm LogintotheCFusionAdministratorandclickontheSSLCertificatesmenuiteminthelefthand menutoexpandit. ClicktheCertificateManagementlink. ClicktheAddaNewCertificateButton. Enterthefollowinginformation:

o Alias: NameofyourSSLCert ClicktheBrowsebuttontonavigatetotheKeyFile(.cer). ClickonyourKeyFileandthenclicktheOpenbutton. ClicktheAddbutton. Tocompletetheprocedure,restarttheMacromediaJRunCFusionServer: o ClicktheStartmenu. o ClickAdministrativeTools. o ClickServices. o LocatetheMacromediaJRunCFusionServeroptionintheServiceslistandclickonitto highlightit. o PresstheRestartbuttonintheServiceswindow. OncetheMacromediaJRunCFusionServerservicehasbeenrestarted,reloadthefollowingURL andlogbackin: o http://cfusion/CFIDE/administrator/index.cfm YoucanverifythatthecertificatehasbeenaddedbynavigatingtotheSSL>Certificate Managementmenuitemandlocatingyourcertificateinthelist. Atthispoint,youmayremovetheSSL>CertificateManagementmenuoptionbygoingtothe followingfilelocation: o Drive:\inetpub\wwwroot\CFIDE\administrator Then,locatethefollowingfilesanddeletethem: o Certman(dir) o Custommenu.xml(file) Optionally,youmaychoosetosimplycommentoutthemenuadditionswithinthe Custommenu.xmlfileandthiswillremovetheoptionfromtheCFusionAdministratoraswell.