Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > ServerTemplates > v12.11 LTS > ST > Base ServerTemplate for Windows (v12.11 LTS) > Base ServerTemplate for Windows (v12.11 LTS) - Tutorial

Base ServerTemplate for Windows (v12.11 LTS) - Tutorial

 


Table of Contents    

Long Term Support

icon-lts-v1.png

Stable, tested ServerTemplate assets

    ►  Tutorial

Objective

To learn how to use the "Base ServerTemplate for Windows" ServerTemplate to launch a basic Windows 2008/2008R2 server and start developing a custom version.

Prerequisites

  • 'actor', 'designer', 'security_manager', and 'library' user roles in order to complete the tutorial.
  • For Amazon EC2 and CloudStack-based clouds, you must have a security group defined with TCP port 3389 open for Remote Desktop Connection (RDC), and any other ports required by the server (for example, the default SQL Server port, TCP port 1433, and the mirroring listener port—5022 by default), for the required security groups and IP addresses. Also remember that for clouds other than Amazon EC2, Windows Firewall is turned on by default.
  • We strongly recommend that you set up credentials for password values and any other sensitive data included as inputs. See "Create Credentials" section below.

Overview

This tutorial describes the steps for launching a basic Windows server in a cloud and demonstrates how you can start customizing it for your own purposes.

Create Credentials

Prerequisite: Requires 'actor' user role privileges in the RightScale account.

In order to securely pass sensitive information to a script at runtime, you can use Credentials as a means of variable substitution. Later in this tutorial you will select these credentials when you define your inputs.

Create the following credentials.  For more information on setting up credentials, see Create a New Credential.

  • WINDOWS_ADMIN_PASSWORD - Set a new password for the local Administrator account that will replace the initial password that's generated at boot time. You will use this password to create a Remote Desktop connection (RDP session) into the server when you login with the 'Administrator' username. It's suggested that you name the credential accordingly. 

Steps

Import and Clone the ServerTemplate

  1. Create a new deployment, which you will use for custom development. See Create a New Deployment.
  2. Go to the MultiCloud Marketplace and import the most recently published revision of the "Base ServerTemplate for Windows" ServerTemplate.
  3. Clone the ServerTemplate to create an editable version that you can customize.
  4. Rename the ServerTemplate (e.g. My Custom X) and commit the ServerTemplate so that the first revision of the ServerTemplate, which will make it easier to track and compare your changes against the original (imported) version.

Add a Server

  1. Using the HEAD version of the cloned ServerTemplate, add a server to the new deployment that you created earlier. See Add a Server to a Deployment.

Set Inputs

Set the following inputs at the deployment level.

SYSTEM

Input Name
Description
Example Value
ADMIN_PASSWORD

Set the new password for the local Administrator account. The password must satisfy Window's minimum requirements for a Windows administrator password, otherwise the random password that is generated for you at boot time (located under the server's Info tab,'Initial Admin Password' field) will be used instead. The password should be at least 7 characters long with at least one upper case letter, one lower case letter, and one digit. 

When you RDP into the server, you will use this password to log in as the Windows 'Administrator' user.

It's strongly recommended that you use a credential to hide this value. However, anyone who needs to log into the server will need to know the actual value.

cred:  WINDOWS_ADMIN_PASSWORD  
SYS_WINDOWS_TZINFO

Sets the system timezone to the timezone specified, which must be a valid Windows timezone entry. You can find a list of valid examples in "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones". Some examples have been provided in the dropdown, which you may override if you do not see your timezone listed.

text: GMT Standard Time

 

Launch the Server

  1. Launch the server and wait for it to become operational. (~15 minutes)

RDP into the Server (optional)

  1. Once the server is operational, you can use the value that you used for the ADMIN_PASSWORD input to create a Remote Desktop Connection to the server. Requires 'server_login' user role privileges.
    Note: If you did not create the credential, you will need 'admin' user role privileges to view the hidden value.
    • u: Administrator
    • p: <WINDOWS_ADMIN_PASSWORD>

Note: If the specified password does not satisfy the minimum requirements for a Windows administrator password, you must use the "Initial Admin Password" (located under the server's Info tab) that is automatically generated for you when you launch an instance. If you want to set up RDP access for a different user than the 'Administrator' user (default), use the ADMIN_ACCOUNT_NAME input to specify a different username and relaunch the server.

Rackspace only
If you try to RDP into a server and receive an error message that it's not supported from your computer, import the SYS Regenerate RDP certificate script, which regenerates an updated certificate. Run it as an 'Any Script' on the server and RDP into the instance again. This issue is resolved in the v13 release.

Develop and Test

Now that you have an operational server that was launched with the "base" ServerTemplate, you can start customizing the ServerTemplate by either adding new scripts of your own or clone and modifying the existing ones. Since you are using a HEAD version of a ServerTemplate, you can add new scripts as "operational scripts" to the ServerTemplate and instantly test them on the running server.

See Create Custom ServerTemplates for more details.

See also

You must to post a comment.
Last modified
00:31, 17 May 2013

Tags

Classifications

This page has no classifications.

Announcements

None


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.