Skip to content

Revised region management instructions in configuration.rst #659

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
daviftorres wants to merge 1 commit into
base: main
Choose a base branch
from
+37 −62
Open

Revised region management instructions in configuration.rst #659

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 37 additions & 62 deletions source/installguide/configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -93,52 +93,49 @@ region.

.. parsed-literal::

# cloudstack-setup-databases cloud:<dbpassword>@localhost --deploy-as=root:<password> -e <encryption_type> -m <management_server_key> -k <database_key> -r <region_id>
# cloudstack-setup-databases cloud:<dbpassword>@localhost --deploy-as=root:<password> -e <encryption_type> -m <management_server_key> -k <database_key> -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 <region.1.IP.address>: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://<region.2.IP.address>: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
<region.2.IP.address>:8080/client.
- Endpoint. The URL where you can log in to the Management Server
in the new region. This has the format
<region.2.IP.address>: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://<region.1.IP.address>: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<mysql_password> -h <region1_db_host> cloud account user domain > region1.sql
# mysqldump -u root -p -h <region1_db_host> 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<mysql_password> -h <region2_db_host> cloud < region1.sql
# mysql -u root -p -h <region2_db_host> cloud < region1.sql

#. Remove project accounts. Run these commands on the region 2 database:

Expand Down Expand Up @@ -167,54 +164,39 @@ repeat certain steps additional times for each additional region:

.. parsed-literal::

cloudstack-setup-databases cloud:<dbpassword>@localhost --deploy-as=root:<password> -e <encryption_type> -m <management_server_key> -k <database_key> -r <region_id>
# cloudstack-setup-databases cloud:<dbpassword>@localhost --deploy-as=root:<password> -e <encryption_type> -m <management_server_key> -k <database_key> -r <region_id>

#. 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 <region.1.IP.address>:8080/client), and add a
region with ID 3, the name of region 3, and the endpoint
<region.3.IP.address>:8080/client.
.. parsed-literal::

#. Log in to CloudStack in the second region as root administrator
(that is, log in to <region.2.IP.address>:8080/client), and add a
region with ID 3, the name of region 3, and the endpoint
<region.3.IP.address>:8080/client.
# cloudmonkey add region id=<region_id> endpoint="http://<region.IP.address>:8080/client" name="Region <region_id>"

#. 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 <region.3.IP.address>:8080/client).
.. parsed-literal::

#. Add a region with ID 1, the name of region 1, and the endpoint
<region.1.IP.address>:8080/client.
# cloudmonkey add region id=1 endpoint="http://<region.1.IP.address>:8080/client" name="Region 1"
# cloudmonkey add region id=2 endpoint="http://<region.2.IP.address>:8080/client" name="Region 2"

#. Add a region with ID 2, the name of region 2, and the endpoint
<region.2.IP.address>: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<mysql_password> -h <region1_db_host> cloud account user domain > region1.sql
# mysqldump -u root -p -h <region1_db_host> 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<mysql_password> -h <region3_db_host> cloud < region1.sql
# mysql -u root -p -h <region3_db_host> cloud < region1.sql

#. Remove project accounts. Run these commands on the region 3 database:

Expand All @@ -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 <region.1.IP.address>: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 <region.2.IP.address>:8080/client.
# cloudmonkey remove region id=<region_id>

- Only the Region ID is required.

.. _adding-a-zone:

Expand Down
Loading