Difference between revisions of "Servers"

Revision as of 15:49, 30 September 2009

Adding a New Server

We have prepared a video tutorial for this section @ http://www.whmcs.com/tutorials.php?i=5

You can add new servers by going to Setup > Servers and selecting Add New Server. All fields are optional but you should at least enter a name and IP for each server you add:

Name - should be unique to allow you to identify this server
Hostname - this is the primary domain of the server - used to link to the server by certain modules
IP Address - this is the primary IP address of the server - used to connect to it
Monthly Cost - optional field - used in reports to calculate profit if entered
Datacenter/NOC - optional field - used only for you to remember where the server is located
Maximum No. of Accounts - a value used to work out the percentage usage of the server (must be entered, can be very large)
Primary/Secondary/Tertiary/Quaternary Nameservers - these are the nameservers for this server, eg. ns1.yourdomain.com and ns2.yourdomain.com - used in welcome email and when registering domains
Primary/Secondary/Tertiary/Quaternary Nameserver IPs - these are the ips for each of the nameservers, can be used in emails
Server Type, Username, Access Hash and Password - should be the login (root/reseller) details for your server (Or Username/Access Hash for cPanel/WHM Servers)
Server Status URL - This is the url to the status folder. See Status Monitoring below.

Status Monitoring

Status monitoring allows you to view the load and uptime for each of your linux based servers from within the WHMCS client/admin area.

To enable this, you must upload the status folder supplied in the WHMCS zip file download to each of your servers. And then enter the URL to that folder into the server setup Server Status URL field.

You can leave the field blank, which simply disables monitoring for that server.

Deleting a Server

To delete a server, go to Setup > Servers and then click the red X icon on the same row as the server you wish to delete
If it is allowed to be deleted you'll get a confirmation popup confirming you want to delete it and once you click Ok it will be removed
You cannot delete a server while there are any accounts assigned to it. This includes terminated and cancelled accounts.

Server Groups

Server groups allow you to configure servers into sets where products can then be assigned to automatically based on your requirements & provisioning settings. For example you may want shared accounts on certain servers, and resellers on another, with accounts being distributed evenly between all the servers you have. Server groups makes this possible.

Creating a Group

Begin by going to Setup > Servers
Next click Create New Group under the Options heading
On the screen that appears, enter a name for your group
Next choose whether to assign new orders to the least full server or fill the default server until it reaches the number of accounts limit you've set for it and then move to the next least used.
Finally, select the servers you want to assign to this group in the box on the left and click Add to move them to the box on the right which contains the servers for this group.
Then click Save Changes to complete the process

Editing/Deleting a Group

When editing a group you get exactly the same interface & options as when you create one.
Servers can be added or removed from a group at any time.
The maximum number of accounts to assign to a server is set on a per server basis when editing the setup of the individual server

@@ Line 2: / Line 2: @@
 We have prepared a video tutorial for this section @ http://www.whmcs.com/tutorials.php?i=5
-You can add new servers by going to Configuration > Servers > Add New Server.  You should fill out all the fields.  They are as follows:
+You can add new servers by going to '''Setup > Servers''' and selecting '''Add New Server'''.  All fields are optional but you should at least enter a name and IP for each server you add:
 *Name - should be unique to allow you to identify this server
+*Hostname - this is the primary domain of the server - used to link to the server by certain modules
 *IP Address - this is the primary IP address of the server - used to connect to it
 *Monthly Cost - optional field - used in reports to calculate profit if entered
 *Datacenter/NOC - optional field - used only for you to remember where the server is located
 *Maximum No. of Accounts - a value used to work out the percentage usage of the server (must be entered, can be very large)
-*Server Status Address - described below
 *Primary/Secondary/Tertiary/Quaternary Nameservers - these are the nameservers for this server, eg. ns1.yourdomain.com and ns2.yourdomain.com - used in welcome email and when registering domains
 *Primary/Secondary/Tertiary/Quaternary Nameserver IPs - these are the ips for each of the nameservers, can be used in emails
 *Server Type, Username, Access Hash and Password - should be the login (root/reseller) details for your server (Or Username/Access Hash for cPanel/WHM Servers)
-*Server Status URL - This is the url to the status folder.  The status folder allows WHMCS to monitor each of your servers load's and uptime.  You can upload the status folder to every one of your servers and then enter the url to this folder in each servers configuration section.  This way, when clients go to the Server Status page, they will be able to see the load and uptime for the servers.  If this field is left blank, the server is not displayed on the server status page.  The status folder is included in the WHMCS Zip File download.
+*Server Status URL - This is the url to the status folder. See Status Monitoring below.
+==Status Monitoring==
+Status monitoring allows you to view the load and uptime for each of your linux based servers from within the WHMCS client/admin area.
+To enable this, you must upload the status folder supplied in the WHMCS zip file download to each of your servers. And then enter the URL to that folder into the server setup '''Server Status URL''' field.
+You can leave the field blank, which simply disables monitoring for that server.
 ==Deleting a Server==
-You cannot delete a server while there are any accounts assigned to it.  That includes terminated and cancelled accounts.  You should not consider deleting a server that is/has been used.  To actually delete it, go to Configuration > Servers and then click the red X icon on the same row as the server you wish to delete.  If it is allowed to be deleted you'll get a confirmation popup confirming you want to delete it and once you click Ok it will be removed.
+*To delete a server, go to '''Setup > Servers''' and then click the red X icon on the same row as the server you wish to delete
+*If it is allowed to be deleted you'll get a confirmation popup confirming you want to delete it and once you click Ok it will be removed
+*You cannot delete a server while there are any accounts assigned to it.  This includes terminated and cancelled accounts.
+==Server Groups==
+Server groups allow you to configure servers into sets where products can then be assigned to automatically based on your requirements & provisioning settings.  For example you may want shared accounts on certain servers, and resellers on another, with accounts being distributed evenly between all the servers you have.  Server groups makes this possible.
+===Creating a Group===
+#Begin by going to '''Setup > Servers'''
+#Next click '''Create New Group''' under the Options heading
+#On the screen that appears, enter a name for your group
+#Next choose whether to assign new orders to the least full server '''or''' fill the default server until it reaches the number of accounts limit you've set for it and then move to the next least used.
+#Finally, select the servers you want to assign to this group in the box on the left and click Add to move them to the box on the right which contains the servers for this group.
+#Then click Save Changes to complete the process
+===Editing/Deleting a Group===
+#When editing a group you get exactly the same interface & options as when you create one.
+#Servers can be added or removed from a group at any time.
+#The maximum number of accounts to assign to a server is set on a per server basis when editing the setup of the individual server

Documentation