Installation of the Jamroom Cluster Server is fairly straight-forward and easy to implement - just make sure and follow all of the steps outlined below and you should have no problem getting your new Jamroom Cluster Server on line. First, please ensure that you have read and fully understand the following Server Requirements section before attempting to install the Jamroom Cluster server:

1. Your Jamroom Cluster Server must meet the Jamroom Minimum Requirements, with the additional requirement that your cluster server must be running Linux with a kernel newer then 2.4.27.
    
2. MySQL is not required to be running on the Jamroom Cluster Server, however, support for connecting to a MySQL database must be compiled into the PHP that will run on the Cluster Server, since it will need to have the ability to connect to the Master Jamroom Server.
    
3. A valid DNS name for your new Jamroom Cluster Server (i.e. “www2.yourdomain.com”). You want to ensure that you have set this up with your domain registrar or hosting provider before going live with your new Cluster Server.  This domain must be a subdomain of your Jamroom domain, or your user sessions will not work across the servers.  For example, if your main website is located at "http://www.example.com", your Cluster Server should be located at "http://cluster.example.com".  Note that the Jamroom Cluster and Conversion server can also be installed into a sub directory of your Jamroom directory.

The following recommendations are not requirements, but will go a long way in helping you make the installation of the cluster server easier, as well as making management of your entire Jamroom easier going forward.

1. Currently the Jamroom Cluster Solution does not work with the “Imports” of songs turned on. It still functions, but only artists whose Artist Page is located on the Master Server will be able to see the contents of their jamroom/uploads directory. Therefore it is recommended that you do not use the “Show Imports” option from the Jamroom Config.
    
2. It is highly recommended that you run the same web server, and version of web server on all of your Jamroom servers, including the Master Server (MySQL database server / web server). The Jamroom Cluster Server was designed and tested on the Apache Web Server, and makes an optimal platform for running Jamroom.
    
3. It is highly recommended that you run the same version of PHP on all of your Jamroom servers (preferably PHP version 5.2.x or newer due to security concerns with older versions). Jamroom is developed on PHP 5.2.x.
    
4. It is highly recommended that the Master Jamroom Server and the Jamroom Cluster Server(s) be located in the same data center! The Jamroom Cluster Server(s) must be able to send SQL commands to the Jamroom Master Server MySQL installation, and therefore a very low-latency network is recommended to ensure an optimal experience for your visitors.

• Make sure you have downloaded the latest version of the Jamroom Cluster Server software from the Jamroom Downloads Page.

• Unzip the downloaded Jamroom Cluster Server software to a temporary directory on your local compter - inside you will see 2 directories - "MASTER" and "CLUSTER".  Upload the contents of the “CLUSTER” directory into the directory on the Cluster Server (or sub directory of your main Jamroom install) where you want the cluster to be installed at.

• Upload the contents of the "MASTER" directory into the Jamroom directory on your Jamroom Master Server (i.e. "public_html" or "httpdocs").

• Next, log in as the Master Admin into your Jamroom.

• Click on the "Jamroom Config" -> "Cluster Settings" and enter your Cluster Key and Code,and save.

• Click on "Create Server" from the "Cluster Admin" link in the Jamroom admin menu.

• Enter the required information and submit - Jamroom will install the Cluster Server.  If you receive any permission errors while installing, fix the permission error and try again.

Now that you have your new Jamroom Cluster Server installed and ready to go, The next step in the process is to become familiar with the new choices you will see in your Jamroom Admin Menu.

After logging in to your Jamroom as the Master Admin, you will see a new option called “Cluster Admin”. This menu can grow to include the following features:

• Create Server - Selecting this option will take you to the create server form, where you can enter information about and configure a new Jamroom Cluster Server. NOTE: This option will not be available unless your Jamroom Cluster Server license still has room for another server in it. For example - if you have purchased a 3 server Jamroom Cluster Server license, then you will only see the “Create Server” choice if you have less than 3 Cluster Servers configured.
• Modify Server - After you have already created a Jamroom Cluster Server, this is where you can come to modify information about this Cluster Server.
• Delete Server - Selecting this option will allow you to delete a Jamroom Cluster Server. NOTE: You cannot delete a Jamroom Cluster Server until all artist accounts have either been deleted or moved from the server.
• Move Artists - Selecting this option will take you in to the Move Artist interface where you can move your Jamroom Artist accounts from server to server.

Both the “Create Server” and “Modify Server” have the same form interface for creating or changing information about your Jamroom Cluster Server:

• Server Name - This is the name of the server as you want to call it in the Jamroom Interface. This name will appear in the “Move Artists” section of the Admin Menu, as well as other places throughout Jamroom (i.e. several places in the Tools menu). Its best here to choose a descriptive name - i.e. “Server2” to make it easier in the future to know what server this is.
• Server IP - this needs to be the Server’s IP Address. Jamroom will use this IP Address internally when communicating with the Jamroom Cluster Server.
• Server URL - this needs to be the full URL to your new Jamroom Cluster Server. You want to ensure that you have set up your new Jamroom Cluster Server with a qualified host name and domain name with your domain registrar or hosting provider in order for the communication between the Jamroom Master Server and the Cluster Server to work.
• Server Active - this setting allows you to tell Jamroom whether or not this Cluster Server is active. NOTE: Setting this to “no” WILL NOT make this Cluster Server stop working, it will merely make it so it is no longer a choice in the “Move Artists” screen. This in effect becomes an easy way to “lock” a server with a specific number of Artist Pages on it.
• Default Server - This option allows you to define if this new Cluster Server will be the default Jamroom server when it comes to creating new Artist Accounts. If this is set to “yes”, the any new artist account that is created by the Jamroom Signup System or by the Master Admin will be located on this new Cluster Server. If you already have another Jamroom Cluster Server that is set as the Default Server, by selecting “yes” for a new Cluster Server, the old Default Server will have its setting changed to “no”.
• Converter Server - Setting this option to "yes" will designate the Cluster Server as a "Converter Server" - it will become the Cluster Server that media conversions are performed on.  Note that while a cmedia conversion is in process it will use almost 100% of a single CPU on the server, so it is recommended that the server you activate as the Conversion Server be powerful enough to handle the conversions.

Select the Jamroom Cluster Server that you would like to delete from the chooser list and press the Delete button.

NOTE: A Jamroom Cluster Server will not show up in the list of available servers to delete unless there are ZERO (0) Artist Accounts on the Cluster Server, and it is not designated as the Default Server.

Moving Jamroom Artist Accounts between servers is a very easy and straight-forward process. By selecting the “Move Artists” option from the Jamroom Admin Menu, you are placed in to the Move Artists form. This form gives you everything you need to balance the load on your Jamroom System by moving Artist Pages between your Master Jamroom Server and your Jamroom Cluster Server(s). On the Move Artist page you are presented with a “Filter” box, a List of all of the Artists in your Jamroom, and finally a list of Jamroom Servers that are available for having Artist Pages moved to them (i.e. they are the Master Jamroom Server, or a Cluster Server that is active).

To Move an artist account from one server to another server, simply select the Artist Name from the Choose Artist(s) window, then select the Cluster Server from the list that you would like to move the Artist Page to. Simply press the “Move Artists” button and the account will be moved between servers. Note that you can select more than one artist from the “Choose Artist(s)” window that you would like to move, making it easy to move hundreds of Artist Accounts between servers in one easy step.

You’ll also note that in the “Choose Artist(s)” and “Cluster Server” selection areas, that the Number of Plays is shown for each artist as well as the TOTAL for the entire Server. This can help you “balance” the number of plays between servers so bandwidth usage is more consistent between servers.

• How many Artist Accounts can be supported on a Jamroom Cluster server?
• The number of Jamroom Artist Accounts that can be supported on a single Jamroom Cluster Server varies depending on the power of the hardware you put the Cluster Server on, and the amount of bandwidth available to the Cluster Server. A good recommendation is no more than 5,000 artist accounts on a single Pentium 4 2.0 ghz server with 1 gigabyte of RAM. Depending on how many plays and page views your Artist Pages receive on the Cluster Server, the number of Artist Accounts you can actually host may be lower or higher than this number.

• Is the communication between the Jamroom Master Server and Cluster Server secure?
• Yes - Jamroom uses a special “lock and key” method of communicating information between the Jamroom Master Server and a Jamroom Cluster Server. This method ensures that the Cluster Server software will only respond to requests that are initiated by the Jamroom Master Server. Also, the Jamroom Cluster Server software does not require any special “sockets” or “ports” be left open, since all communication is done via HTTP calls using the web server port.

• Can I move an Artist Account between 2 Cluster Servers?
• Yes - you can move and Artist Account between 2 servers without issue and in the same way that you would move an Artist Account from your Jamroom Master Server to a Cluster Server. Simply select the Artist Account(s) you want to move from the “Choose Artist(s)” selection box, then select the Cluster Server you want to move them too. Regardless of their current server location, they will be moved to the specified server.