A lot of setup and administration tasks have gotten a lot easier in Communications
Server 14; one of them is building an application
server to develop and run your UCMA 3.0 applications on. In this post, Ill walk you through installing the UCMA 3.0 Core SDK and creating a Trusted Application Pool on the
server, thus adding it
to the Communications
Server 14 topology and allowing you
to host and run UCMA 3.0 applications on it. Note: These instructions will change slightly as the bits get updated for the eventual Beta release I will update this post as soon as I get a chance
to run this setup on a more recent build. Im doing the install on a simple Communications
Server 14 topology consisting of the following Windows
Server 2008 R2 Hyper-V images: DC Domain Controller ExchangeUM Exchange
Server 2010 CS-SE Microsoft Communications
Server 2010 Standard Edition TS Development machine Ill walk through setting up UCMA 3.0 on the TS VM, which is a fully patched Windows
Server 2008 R2 machine that is joined
to the Fabrikam domain. Im also running Visual Studio 2010 on this VM because I intend
to use it as a development machine. In a future post, Ill walk through installing just the UCMA 3.0 run time
to build a true production UCMA application
server. Im making a couple of assumptions here: You have an existing CS 2010 site and cluster configured(well look at this in a future post) Youre starting with a fully patched Windows
Server 2008 R2 machine The machine is joined
to your domain This walkthrough was done in my Fabrikam VM environment but can easily be modified for your own environment. Installing the UCMA 3.0 SDK Lets start by installing the UCMA 3.0 SDK. Run UcmaSdkWebDownload.msi
to kick off the SDK installer package extract process. The installed package is extracted
to C: >> Program Files >> Microsoft UCMA 3.0 >> SDK Installer Package. Browse there and run setup.exe. Click Install
to install the UCMA 3.0 Core SDK and Workflow SDK. Install Communications
Server Core Components UCMA 3.0 introduces a new concept called Auto-provisioning, which is most easily explained from the developer point of view. Remember what your app.config looked it in UCMA 2.0? You had
to store the application GRUU, the trusted contact SIP Uri, the port for your application, and the name of the certificate authority. Thats all gone with auto-provisioning all you need in your app.config is your ApplicationId, e.g.: urn:application:MyApplication. How does CS 2010 do this? All of the applications configuration data is associated with the applications id. UCMA also queries a replicated copy of the Central Management Database
to retrieve the applications configuration data and also the configuration data for any endpoints. In this step, well run Bootstrapper.exe
to install the CS Core components, this checked for the following components and installs them if they are not already present: VcRedist Sqlexpress Sqlnativeclient Sqlbackcompat Ucmaredist OcsCore.msi Open a command window at C: >> Program Files >> Microsoft Communications
Server 2010 >> Deployment and run the following command: Bootstrapper.exe /BootstrapReplica /MinCache /SourceDirectory:"%ProgramFiles%\Microsoft UCMA 3.0\SDK Installer Package\Prereq\BootstrapperCache"
Create a New Trusted Application Pool
The next step is
to create a new trusted application pool for the new
server. Fire up the Communications
Server Management Shell from Start >> Microsoft Communications
Server 2010 >> Communications
Server Management Shell and enter the following PowerShell command:
New-CsTrustedApplicationPool -Identity <FQDN of Server> -Registrar <FQDN of CS Server> -Site <CS Site Name>
Verify that the new
server was added
to the CS topology by running the following PowerShell command:
(Get-CsTopology -AsXml).ToString() > Topology.xml
This created a file called Topology.xml in the directory that you ran the command from. Open the file and find the Clusters section and look for a node for the new
server.
The Cluster Fqdn is the name of your
server, and note the name of the Site that this Cluster is a part of.
<Cluster Fqdn="appsrv.fabrikam.com" RequiresReplication="true" RequiresSetup="true">
<ClusterId SiteId="UcMarketing2" Number="5" />
<Machine OrdinalInCluster="1" Fqdn="appsrv.fabrikam.com">
<NetInterface InterfaceSide="Primary" InterfaceNumber="1" IPAddress="0.0.0.0" />
</Machine>
</Cluster>
Configure CS Management Store Replication
At this point, we have the CS Core components installed and the
server configured as a trusted application pool. We now need
to set up replication so that the Central Management Store replicates down
to the new
server.
From the Communications
Server Management Shell, run the following PowerShell command
to enable the Replica service on the new server:
Enable-CSReplica
The Replica service is enabled, but hasn't done anything yet. This can be verified by running the following PowerShell command
to check the replication status for the various servers in the topology:
Get-CSManagementStoreReplicationStatus
You can see in the screenshot below that the UpToDate property of the new
server is still False
Run the following PowerShell command
to force the replication
to run:
Invoke-CSManagementStoreReplicationStatus
Run Get-CSManagementStoreReplicationStatus again
to verify that the new service is now up
to date
Request and Set a New Certificate
The last step in the process is
to request a new certificate from the certificate authority on the domain and assign it
to the new
server.
From the Communications
Server Management Shell, run the following PowerShell command
to request a new certificate:
Request-CSCertificate -Action new -Type default -CA <Domain Controller FQDN>\<Certificate Authority>
Setting the -Verbose switch on the cmdlet creates an Xml file with its output. Open the Xml file and copy the thumbprint of the generated certificate.
<?xml version="1.0" encoding="utf-8"?>
<Action Name="Request-CsCertificate" Time="20100512T212258">
<Action Name="Request-CsCertificate" Time="20100512T212258">
<Info Title="Connection" Time="20100512T212258">Data Source=(local)\rtclocal;Initial Catalog=xds;Integrated Security=True</Info>
<Action Time="20100512T212258">
<Info Title="Certificate use" Time="20100512T212258">urn:certref:default</Info>
<Info Title="Subject distinguished name" Time="20100512T212258">CN="appsrv2.fabrikam.com"</Info>
<Info Time="20100512T212259">The certificate request is submitted
to the Certification Authority dc.fabrikam.com\FabrikamCA.</Info>
<Info Time="20100512T212259">The certificate was issued.</Info>
<Info Time="20100512T212259">The certificate was imported with thumbprint AFC3C46E459C1A39AD06247676F3555826DBF705.</Info>
<Complete Time="20100512T212259" />
</Action>
<Info Title="command status" Time="20100512T212259">Command execution processing completed</Info>
<Action Name="DeploymentXdsCmdlet.SaveCachedItems" Time="20100512T212259">
<Info Time="20100512T212259">0 updates</Info>
<Complete Time="20100512T212259" />
</Action>
<Info Title="command status" Time="20100512T212259">Command has completed</Info>
</Action>
</Action>
Run the following PowerShell command
to set the certificate:
Set-CsCertificate -Type Default -Thumbprint <Thumbprint>
Wrapping Up
You now have a new UCMA 3.0 application
server in your Communications
Server 2010
server topology. You can provision trusted applications and trusted application endpoints on the new
server using the Communications
Server 2010 Management Shell. Well take a look at how
to do that in another post. Did you know that DotNetSlackers also publishes .net articles written by top known .net Authors? We already have over 80 articles in several categories including Silverlight. Take a look: here.
