Deploying a single-server solution
As discussed in the previous section, we can use a single-server to host all the components of Orchestrator if we're targeting a small environment and/or we have the objective of having an Orchestrator for the development and quality assessment of our Runbooks before getting them into production. If you jumped straight into this part, we strongly suggest you read the Planning the Orchestrator architecture section before proceeding.
As of the time of writing, Windows Server 2012 R2 has been out for quite a while and it's the OS selected to host our Orchestrator. So, once you have chosen the OS and deployed it, and after having joined to the domain and having done the basic configurations, we can move on with deploying the prerequisites:
- Verify that you have permissions on the SQL Server selected to host the database, that the collation is the one specified in the previous section, and finally that Windows Authentication is the authentication mechanism selected. If you choose to install the SQL Server locally, don't forget to get the Database Engine Services options and the share features by navigating to Management Tools | Basic.
- Add the Orchestrator Administrators group and the Management Service account to the local Administrators group of the server.
- Enable the Web Server (IIS) role, accept the features added, and proceed with the installation. The default settings of this role will suffice as the Orchestrator will configure it accordingly for you. If the Orchestrator installation doesn't detect this role on the server, it will install it for you.
- Install the .NET 3.5 SP1 feature. Don't forget to indicate the alternative source for the installation to occur.
- (Only if you're installing on Windows Server 2008 R2): Install the .NET 4.5 feature. If you forget to activate the ASP.NET and HTTP Activation features, the installer will take care of activating them for you.
- Install Silverlight. If you start the console without installing it, you'll be required to install it.
- Launch the installation using the
SetupOrchestrator.exe
. Select Install on the System Center 2012 R2 Orchestrator Setup section of the wizard. - On the Product registration page, enter your organization's details and product key, and then click on Next.
- Take your time to read the license terms, and if you accept them, continue the installation by clicking on Next.
- On Select features to install, by default you'll have all of them selected. As we're installing a single-server, this is the desired selection, so just press Next.
- As seen in step 4 of this installation, we didn't include the ASP.NET features on IIS, so Orchestrator will install them for us (press Next) and then it will confirm that everything's OK.
- At the Configure the service account step, we'll use the Management Service
scorchmssvc
account. The explanation on this screen can be a bit misleading, but this is the management service that we're talking about. In a multi-server deployment, this will be different. We'll get there… - Now, at Configure the database server, we'll use our server/instance (if any instance), and the port, and we'll verify the connectivity. If everything's OK, we'll move on with Next.
- Verify the database settings at the Configure the database page and specify the database name if you want something different. The default is Orchestrator. Proceed with Next.
- Now it's time to configure Orchestrators users group, but although the title of the page can be deceiving, this is not the normal users group, but rather the Administrators group. Click on Browse and select the proper group that you've defined (Scorch_Admins in this example). Click on Next when ready.
- At the Configure the ports for the web services page, usually the default ports
81
and82
are OK, but if these ports are not compliant with your environment or you wish to make the service available at some other port, this is the time to do it. If you do change the ports, don't forget to keep them in mind for the rest of this book as we'll use the default ones for every sample and configuration. Push Next. - Time to select the installation location. Usually, the default is OK, but, once again, you can specify another location that is more suitable for your needs. Push Next.
- On the Help improve Microsoft System Center Orchestrator, select the options you prefer and click on Next.
- Review Installation summary, and if everything's OK, click on Install to start the installation.
- Once the installation finishes, you'll be given the status of the installation along with a few options to consider before finishing the setup:
- Launch Windows Update.
- Visit System Center Orchestrator Online.
- When the setup closes, start Runbook Designer.
All these steps can be automated with Powershell. The following is a sample of the command line to execute in order to install it in an unattended way with the Orchestrator in a single-server:
D:\Setup\Setup.exe /DbServer:SQLSERVER\INSTANCE /DbNameNew:Orchestrator /WebServicePort:81 /WebConsolePort:82 /OrchestratorRemote /UseMicrosoftUpdate:1 /SendCEIPReports:0 /EnableErrorReporting:never /Components:all /ServiceUserName:DOMAIN\scorchmssvc /ServicePassword:IWontTellYou /OrchestratorUsersGroup:(Group's SID) /Key:XXXXX-XXXXX-XXXX-XXXX-XXXXX /Silent
As we're setting up only one server, we're only going to use the Management Service account for the Management Service and for the Runbook Service. In this type of deployment, only one account is required. The Runbook Server service account will be used for any additional Runbook Servers that we may like to deploy in the future, and it's best practice to separate the two services into separate accounts to avoid a single point of failure in the future.
If you choose to go with the command-line installation, don't forget to retrieve the Scorch_Admins
group SID. If you don't want to specify the group, it will use the default one locally called OrchestratorUsersGroup
. If you would like to install Orchestrator into another directory, you can use the InstallDir()
function and specify the directory.
In any case, you need to verify the installation logs. They will be under C:\Users\<USER>\AppData\Local\Microsoft System Center 2012\Orchestrator\Logs
.
With this complete, you will have a fully functional Orchestrator 2012 R2 deployment.