Showing results for 
Search instead for 
Did you mean: 

How do I configure my Zeus instance on EC2?

Occasional Contributor

How do I configure my Zeus instance on EC2?

(Originally posted November 10, 2009)

Frequent Contributor

Re: How do I configure my Zeus instance on EC2?

Zeus Traffic Manager and Zeus Load Balancer are now available on EC2 as Amazon Machine Images (AMIs). An AMI is a template from which EC2 virtual machines, called instances, can be created. An instance is essentially a Zeus virtual appliance packaged for use on EC2. There are three main steps to getting a traffic manager up and running in EC2:

<a href="" target="_blank">Sign up to use one or more Zeus AMIs</a>
    <a href="" target="_blank">Launch an instance of your chosen AMI</a>

    Configure the new traffic manager - covered in this article

    This article assumes that you have already launched an instance of a Zeus AMI on EC2. If you have not, please launch one by following the instructions in the

    <a href="" target="_blank">article on instance management</a>

    before you continue.

    Connect to the administration interface

    In order to configure your Zeus instance you will need to know its public IP address and the password you specified when you created it. You can find out your instance's public IP address using your EC2 management tool. If you are using Amazon's command line tools, run the ec2-describe-instances command. When the instance is listed as 'running', make a note of the public DNS name or public IP address associated with it. This is the address of the Zeus Administration Server. Point your web browser at the following URL:

    1. https://admin_server_address:9090/

    Where admin_server_address is the public DNS name or IP address of your instance. The first time you connect to the administration server, your web browser will report problems with the SSL certificate (either that it cannot trust it, or that the hostname in the certificate doesn't match the hostname in the URL). You can safely ignore these warnings. These warnings appear because the administration server uses a self-signed SSL certificate, and the hostname embedded in it will not match the URL you have used to access the administration server. This happens because an instance's public DNS name and IP address are different from the private DNS name and IP address it uses within the EC2 network. After you dismiss the SSL warning, the first page of the Initial Configuration Wizard will appear. If you have ever configured a Zeus hardware appliance or virtual appliance this will be very familiar to you, although some new steps have been added to handle EC2-specific configuration.


    Enter the admin user password

    Before you can configure your traffic manager, you must enter the admin user password. This is to verify that you are the person who launched the instance and to prevent an attacker from gaining control of a newly-launched instance.

    If you pre-configured an admin user password when you launched the instance, by setting the password key in the instance's metadata, enter that password here. If you did not pre-configure an admin password, a random password will have been generated for you and printed in the instance's EC2 console log. The console log is only available to the Amazon account which created the instance, so this is a secure way to ensure that you are authorized to configure the instance. Use your Amazon management tool to display the console log, then enter the password. The wizard page shows you how to display the console log using Amazon's command line tools, using the ec2-get-console-output command. It can take several minutes for console output to become available after an instance is started up. When you have entered the password, click Next to continue.

    Accept the License Agreement

    You must agree to the terms the Zeus End User License Agreement before you can use the software. Please read the agreement fully.


    If you accept license's terms, ensure the ‘I accept the license agreement’ checkbox is selected and click Next to continue.

      1. If you do not accept the license's terms, you cannot continue to configure and use the software. Please terminate your instance. If you do not terminate your instance, you will continue to be charged for using the AMI.

      Enter your EC2 credentials


    Your Zeus traffic manager uses EC2's Elastic IP addresses to provide fault tolerant Traffic IP addresses for your services. If you want to use Traffic IP addresses, you must enter your Amazon AWS Access Key ID and Secret Access Key here, to allow the traffic manager to create, configure and delete Elastic IP addresses.

    If you do not want to use fault tolerance you can leave these fields blank. If you later decide to use fault tolerance you can enter your Access Key ID and Secret Access Key by going to the Global Settings page in the Administration Server. Click Next to continue.

    Set your timezone

    You cannot change the clock on your Zeus instance because it receives the time directly from EC2. However you can change the timezone, so that times and dates in log messages are shown in your local time.

    If you have several traffic managers and web servers running in EC2, it is a good idea to set them all to the same timezone. That will make it easier to compare events and log messages from different servers, for instance when debugging.

    Admin password


    If you did not pre-configure an admin password when you launched the instance, the wizard will prompt you to set one. The admin password is used when configuring the appliance via a web browser, or when logging into the appliance via SSH (with the username 'admin'). If you did pre-configure a password when you launched the instance, this step of the wizard will not appear and the administration server will continue to use the pre-configured password. Click Next to continue.

    Configuration summary

    You have now reached the end of the initial configuration wizard. The wizard will show you a summary of the settings you have chosen.


    If you want to change a setting, click the Back button until you reach the appropriate page, make the change, then click Next until you return to the end of the wizard. Once everything is correct, click Finish to commit these settings. You will see a confirmation page, and when the traffic manager is ready you will be redirected automatically to the administration server login page.

    What next?

    When the admin server log in page appears, log in using the username 'admin' and either the password you pre-configured when you launched the instance, or the password you set in the wizard. You are now ready to start configuring your services. For more information about how to do this, you may find the following documents helpful: