diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index bdfbb77a02..a003adcfaf 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -76,7 +76,7 @@ the default region by displaying the region in the CloudStack UI and clicking the Edit button. -Adding a Region +Adding a Second Region ~~~~~~~~~~~~~~~ Use these steps to add a second region in addition to the default @@ -93,52 +93,49 @@ region. .. parsed-literal:: - # cloudstack-setup-databases cloud:@localhost --deploy-as=root: -e -m -k -r + # cloudstack-setup-databases cloud:@localhost --deploy-as=root: -e -m -k -r 2 #. By the end of the installation procedure, the Management Server should have been started. Be sure that the Management Server installation was successful and complete. -#. Now add the new region to region 1 in CloudStack. - - #. Log in to CloudStack in the first region as root administrator - (that is, log in to :8080/client). +#. Now add the new region (2) to CloudStack of region 1 using CloudMonkey. - #. In the left navigation bar, click Regions. + .. parsed-literal:: - #. Click Add Region. In the dialog, fill in the following fields: + # cloudmonkey add region id=2 endpoint="http://:8080/client" name="Region 2" - - ID. A unique identifying number. Use the same number you set in - the database during Management Server installation in the new - region; for example, 2. + - ID. A unique identifying number. Use the same number you set in + the database during Management Server installation in the new + region; for example, 2. - - Name. Give the new region a descriptive name. + - Name. Give the new region a descriptive name. - - Endpoint. The URL where you can log in to the Management Server - in the new region. This has the format - :8080/client. + - Endpoint. The URL where you can log in to the Management Server + in the new region. This has the format + :8080/client. -#. Now perform the same procedure in reverse. Log in to region 2, and +#. Now perform the same procedure in reverse. On CloudStacl of the region 2, add region 1. -#. Copy the account, user, and domain tables from the region 1 database - to the region 2 database. + .. parsed-literal:: + + # cloudmonkey add region id=1 endpoint="http://:8080/client" name="Region 1" - In the following commands, it is assumed that you have set the root - password on the database, which is a CloudStack recommended best - practice. Substitute your own MySQL root password. +#. Copy the **account**, **user**, and **domain** tables from the region 1 database + to the region 2 database. - #. First, run this command to copy the contents of the database: + #. First, run this command to dumnp the tables into a file: .. parsed-literal:: - # mysqldump -u root -p -h cloud account user domain > region1.sql + # mysqldump -u root -p -h cloud account user domain > region1.sql #. Then run this command to put the data onto the region 2 database: .. parsed-literal:: - # mysql -u root -p -h cloud < region1.sql + # mysql -u root -p -h cloud < region1.sql #. Remove project accounts. Run these commands on the region 2 database: @@ -167,54 +164,39 @@ repeat certain steps additional times for each additional region: .. parsed-literal:: - cloudstack-setup-databases cloud:@localhost --deploy-as=root: -e -m -k -r + # cloudstack-setup-databases cloud:@localhost --deploy-as=root: -e -m -k -r -#. Once the Management Server is running, add your new region to all - existing regions by repeatedly using the Add Region button in the UI. - For example, if you were adding region 3: +#. Once the Management Server is running, add your new region into **all + existing regions** using CloudMonkey: - #. Log in to CloudStack in the first region as root administrator - (that is, log in to :8080/client), and add a - region with ID 3, the name of region 3, and the endpoint - :8080/client. + .. parsed-literal:: - #. Log in to CloudStack in the second region as root administrator - (that is, log in to :8080/client), and add a - region with ID 3, the name of region 3, and the endpoint - :8080/client. + # cloudmonkey add region id= endpoint="http://:8080/client" name="Region " #. Repeat the procedure in reverse to add all existing regions to the new region. For example, for the third region, add the other two existing regions: - #. Log in to CloudStack in the third region as root administrator - (that is, log in to :8080/client). + .. parsed-literal:: - #. Add a region with ID 1, the name of region 1, and the endpoint - :8080/client. + # cloudmonkey add region id=1 endpoint="http://:8080/client" name="Region 1" + # cloudmonkey add region id=2 endpoint="http://:8080/client" name="Region 2" - #. Add a region with ID 2, the name of region 2, and the endpoint - :8080/client. - -#. Copy the account, user, and domain tables from any existing region's +#. Copy the **account**, **user**, and **domain** tables from any existing region's database to the new region's database. - In the following commands, it is assumed that you have set the root - password on the database, which is a CloudStack recommended best - practice. Substitute your own MySQL root password. - - #. First, run this command to copy the contents of the database: + #. First, run this command to dumnp the tables into a file: .. parsed-literal:: - # mysqldump -u root -p -h cloud account user domain > region1.sql + # mysqldump -u root -p -h cloud account user domain > region1.sql #. Then run this command to put the data onto the new region's database. For example, for region 3: .. parsed-literal:: - # mysql -u root -p -h cloud < region1.sql + # mysql -u root -p -h cloud < region1.sql #. Remove project accounts. Run these commands on the region 3 database: @@ -234,20 +216,13 @@ repeat certain steps additional times for each additional region: Deleting a Region ~~~~~~~~~~~~~~~~~ -Log in to each of the other regions, navigate to the one you want to -delete, and click Remove Region. For example, to remove the third region -in a 3-region cloud: +On each of the other regions, use CloudMontey to remove the desired region: -#. Log in to :8080/client. - -#. In the left navigation bar, click Regions. - -#. Click the name of the region you want to delete. - -#. Click the Remove Region button. +.. parsed-literal:: -#. Repeat these steps for :8080/client. + # cloudmonkey remove region id= +- Only the Region ID is required. .. _adding-a-zone: