Administering Jira Data Center on AWS
While working with your Jira Data Center on AWS, you can expand your environment by adding additional nodes, upgrade the existing Jira instances, or connect to them over SSH.
Setting custom DNS name
When deploying Jira Data Center on AWS, you get a default domain name that points to the Amazon's load balancer. You'll be using it to access Jira. This domain name depends on the load balancer's name and the AWS region, but in general it looks like this:
my-loadbalancer-1234567890.us-west-2.elb.amazonaws.com. You can change it to something more familiar, e.g. j
ira.atlassian.com, by entering your own domain name in the Existing DNS (optional) parameter in the Quick Start. You'll need a domain name to do this, if you don't have one already, you can register it here.
To set the custom DNS name:
- When deploying Jira with the Quick Start, enter your domain name (FQDN) in the Existing DNS (optional) parameter. It'll be saved in the
proxyNameparameter in Apache Tomcat, which is a web server used by Jira. All nodes will be using this domain name.
- After the deployment, when you know the address of the Amazon's load balancer, associate it with your domain name. To do this, you'll need to use your DNS service to create a CNAME record where you enter the source and target URLs, creating an alias. See Associating your custom domain name with your load balancer name.
If you have already deployed Jira, you can still change the parameters that are used by your stack, be it the instance type or the domain name. See Changing resource properties.
Scaling up and down
To change the number of nodes in the cluster:
- Set the desired range, so the minimum and maximum number of nodes that can be started in your stack.
- In the AWS console, go to Services > CloudFormation, select the stack, and click Update Stack.
- Change the Minimum number of cluster nodes and Maximum number of cluster nodes parameters as desired. After this step, the number of nodes (controlled by the Auto Scaling group) will be set to the minimum number.
- Change the size of the Auto Scaling group to increase the number of available nodes.
- In the AWS console, under Auto Scaling, select Auto Scaling Groups.
- Select your Auto Scaling group.
- On the Details tab, choose Edit.
- For Desired, increase the desired capacity by one. For example, if the current value is
The desired capacity must be less than or equal to the maximum size of the group. If your new value for Desired is greater than Max, update Max.
- Click Save.
Connecting to your nodes over SSH
Sooner or later you will need to SSH to your Jira cluster node(s) and file server to perform configuration or maintenance tasks. Note that you must keep your SSH private key file (the PEM file you downloaded from Amazon and specified as the Key Name parameter) in a safe place. This is the key to all the nodes in your instance, and if you lose it you may find yourself "locked out".
Note: JiraDataCenter.template deploys all EC2 instances in the Subnets specified by the Internal subnets parameter. If you have specified Internal subnets that are completely unreachable from outside, then you may need to launch an EC2 instance with SSH running and accessible in one of the the External subnets, and use this as a "jump box" to SSH to any instances in your Internal subnets. That is, you SSH first to your "jump box", and from there to any instance deployed in the Internal subnets.
When connecting to your instance over SSH, use
ec2-user as the user name, for example:
ssh -i keyfile.pem firstname.lastname@example.org
sudo access. SSH access is by
root is not allowed.
We recommend you use the AWS native backup facility, which utilizes snapshots to back up your Jira Data Center.
Migrating your existing instance into AWS
To migrate an existing instance into AWS:
- Migrate its database to PostgreSQL (if not already).
- Take a backup of your existing home directory and database.
- Copy the backup file to your file server EC2 instance.
- Unpack the backup file under
/media/atl/jira/sharedof your file server.
- Restore the PostgreSQL database dump contained in the backup file to your RDS instance with