9.14. Configuring Districts

Procedure 9.13. To Create a District and Add a Node Host:

1. Create an empty district and specify the gear profile with:

   # oo-admin-ctl-district -c create -n district_name -p gear_profile

   Copy to Clipboard Toggle word wrap
2. Add an empty node host to the district. Only node hosts that do not have any gears can be added to a district, and the node host must have the same gear profile as the district:

   # oo-admin-ctl-district -c add-node -n district_name -i hostname

   Copy to Clipboard Toggle word wrap
   The following example shows how to create an empty district, then add an empty node host to it.

   Example 9.8. Creating an Empty District and Adding a Node Host

   # oo-admin-ctl-district -c create -n small_district -p small
   				
   Successfully created district: 7521a7801686477f8409e74f67b693f4
   
   {"active_server_identities_size"=>0,
   "node_profile"=>"small",
   "creation_time"=>"2012-10-24T02:14:48-04:00",
   "name"=>"small_district",
   "externally_reserved_uids_size"=>0,
   "uuid"=>"7521a7801686477f8409e74f67b693f4",
   "max_capacity"=>6000,
   "available_uids"=>"<6000 uids hidden>",
   "max_uid"=>6999,
   "available_capacity"=>6000,
   "server_identities"=>{}}
   

   Copy to Clipboard Toggle word wrap

   # oo-admin-ctl-district -c add-node -n small_district -i node1.example.com
   				
   Success!
   {...
   "server_identities"=>{"node1.example.com"=>{"active"=>true}},
   "uuid"=>"7521a7801686477f8409e74f67b693f4",
   "name"=>"small_district",
   ...}
   

   Copy to Clipboard Toggle word wrap

   Note

   The command outputs in the previous example show the JSON object representing the district in the MongoDB.