Skip to content

Commit cb39ce2

Browse files
authored
Merge pull request #95490 from uhabiba04/master
content fixes
2 parents 568142c + 9280668 commit cb39ce2

File tree

1 file changed

+29
-39
lines changed

1 file changed

+29
-39
lines changed

articles/industry/agriculture/prepare-for-deployment.md

Lines changed: 29 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -77,14 +77,13 @@ You need the following permissions for deploying Azure FarmBeats:
7777
Before initiating the deployment, ensure you've the following:
7878

7979
- Sentinel account
80-
- Azure Active Directory (app registration)
81-
- Azure FarmBeats
80+
- Azure Active Directory (AD) app registration
8281

8382
## Create a sentinel account
8483

8584
An account with sentinel helps you to download the sentinel satellite imagery from their official website to your device. Follow these steps to create a free account:
8685

87-
1. Go to https://scihub.copernicus.eu/dhus/#/self-registration. In the registration page, provide a first name, last name, username, password, and email.
86+
Go to https://scihub.copernicus.eu/dhus/#/self-registration. In the registration page, provide a first name, last name, username, password, and email.
8887
A verification email will be sent to the registered email address for confirmation. Select the link and confirm. Your registration process is complete.
8988

9089
## Create Azure AD app registration
@@ -98,7 +97,7 @@ For authentication and authorization on Azure FarmBeats, you must have an Azure
9897

9998
If you already have a subscription, you can directly moved to the next procedure.
10099

101-
**Case 2**: This method is the preferred step when you don't have enough rights to create and configure an Azure AD app registration within your subscription. Request your admin to use the [custom script](https://aka.ms/FarmBeatsMarketplace), which will help IT admin automatically generate and configure the Azure AD app registration on the Azure portal. As an output to running this custom script using PowerShell environment the IT admin needs to share an Azure Active Directory Application Client ID and password secret with you. Make a note of these values.
100+
**Case 2**: This method is the preferred step when you don't have enough rights to create and configure an Azure AD app registration within your subscription. Request your admin to use the [custom script](https://aka.ms/FarmBeatsAADScript), which will help IT admin automatically generate and configure the Azure AD app registration on the Azure portal. As an output to running this custom script using PowerShell environment the IT admin needs to share an Azure Active Directory Application Client ID and password secret with you. Make a note of these values.
102101

103102
Use the following steps to run the Azure AD application registration script:
104103

@@ -127,7 +126,7 @@ Use the following steps to run the Azure AD application registration script:
127126
128127
As part of the installation, create an input.json file as follows:
129128
130-
```json
129+
```
131130
{
132131
"sku":"both",
133132
"subscriptionId":"da9xxxec-dxxf-4xxc-xxx21-xxx3ee7xxxxx",
@@ -145,24 +144,22 @@ As part of the installation, create an input.json file as follows:
145144
This file is your input file to Azure Cloud Shell and parameters whose values are used during the installation. All params in the json needs to be replaced with appropriate values or removed; if removed, installer will prompt you during installation
146145
147146
148-
> [!NOTE]
149-
> This file inputs values to Azure Cloud Shell. To save time, during deployment you won’t be prompted for parameters you add to this file. You will be prompted for missed parameters.
150-
151147
Review the parameters before preparing the file.
152148
153149
|Command | Description|
154150
|--- | ---|
155151
|sku | Provides a choice to download either or both the components of Azure FarmBeats. Specifies which components to download. To install only Data hub, use “onlydatabhub”. To install Data hub and Accelerator, use “both”|
156-
|“subscriptionId” | Specifies the subscription for installing FarmBeats|
157-
|“datahubResourceGroup” | Resource group name for Data hub resources|
158-
|“acceleratorWebsiteName” |Unique URL prefix to name your Data hub|
159-
|“acceleratorResourceGroup” | Unique URL prefix to name your accelerator website.|
160-
|“datahubWebsiteName” | UUnique URL prefix to name your Data hub website. |
161-
|''sentinelUsername'' | user name to sign into: https://scihub.copernicus.eu/dhus/#/self-registration.|
162-
|“notificationEmailAddress” | Email address to receive the notifications for any alerts that you configure within Data hub.|
163-
|“updateIfExists" " |[Optional] Parameter to be included within Input.Json only if you want to upgrade an existing FarmBeats instance. For upgrade, other details eg. the resource group names, locations etc. need to be the same.|
164-
|"aadAppClientId" | [**Optional**] Parameter to be included within Input.Json only if Azure AD app already exists. |
165-
|"aadAppClientSecret" | [**Optional**] Parameter to be included within Input.Json only if Azure AD app already exists.|
152+
|subscriptionId | Specifies the subscription for installing FarmBeats|
153+
|datahubResourceGroup| Resource group name for Data hub resources|
154+
|location |Location where you would like to create the resources|
155+
|acceleratorWebsiteName |Unique URL prefix to name your Data hub|
156+
|acceleratorResourceGroup | Unique URL prefix to name your accelerator website.|
157+
|datahubWebsiteName | UUnique URL prefix to name your Data hub website. |
158+
|sentinelUsername | user name to sign into: https://scihub.copernicus.eu/dhus/#/self-registration.|
159+
|notificationEmailAddress | Email address to receive the notifications for any alerts that you configure within Data hub.|
160+
|updateIfExists|[Optional] Parameter to be included within Input.Json only if you want to upgrade an existing FarmBeats instance. For upgrade, other details eg. the resource group names, locations etc. need to be the same.|
161+
|aadAppClientId | [**Optional**] Parameter to be included within Input.Json only if Azure AD app already exists. |
162+
|aadAppClientSecret | [**Optional**] Parameter to be included within Input.Json only if Azure AD app already exists.|
166163
167164
## Deploy within Cloud Shell browser-based command line
168165
@@ -188,17 +185,15 @@ Sample JSON input:
188185
```json
189186
{  
190187
   "sku":"both", 
191-
   "subscriptionId": "da9xxxec-dxxf-4xxc-xxx21-xxx3ee7xxxxx", 
192-
   "datahubResourceGroup": "dummy-test-dh1", 
193-
   "datahubLocation": "westus2", 
194-
   "datahubWebsiteName": "dummy-test-dh1", 
195-
   "acceleratorResourceGroup": "dummy-test-acc1", 
196-
   "acceleratorLocation": "westus2", 
197-
   "acceleratorWebsiteName": "dummy-test-acc1", 
198-
   "sentinelUsername": "dummy-dev", 
199-
   "farmbeatsAppId": "c3cb3xxx-27xx-4xxb-8xx6-3xxx2xxdxxx5c", 
200-
   "notificationEmailAddress": "[email protected]", 
201-
   "updateIfExists": true
188+
   "subscriptionId":"da9xxxec-dxxf-4xxc-xxx21-xxx3ee7xxxxx", 
189+
   "datahubResourceGroup":"dummy-test-dh1", 
190+
   "location":"eastus2", 
191+
   "datahubWebsiteName":"dummy-test-dh1", 
192+
   "acceleratorResourceGroup":" dummy-test-acc1", 
193+
   "acceleratorWebsiteName":" dummy-test-acc1", 
194+
   "sentinelUsername":"dummy-dev", 
195+
   "notificationEmailAddress":" [email protected]", 
196+
   "updateIfExists":true 
202197
}
203198
```
204199
@@ -208,10 +203,10 @@ Sample JSON input:
208203
![Project Farm Beats](./media/prepare-for-deployment/bash-2-1.png)
209204
210205
4. Go to your home directory in the cloud shell. By default, it is /home/<username>
211-
5. Type or paste the following two commands into the Cloud Shell. Make sure to modify the path to input. Json file and press enter.
206+
5. Type or paste the following command into the Cloud Shell. Make sure to modify the path to input. Json file and press enter.
212207
213208
```azurepowershell-interactive
214-
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScriptbash farmbeats-installer.sh /home/<username>/input.json
209+
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScript && bash farmbeats-installer.sh /home/<username>/input.json
215210
```
216211
The installer automatically downloads all dependencies and builds the deployer. You will be prompted to agree to the Azure FarmBeats End-user license agreement (EULA).
217212
@@ -264,10 +259,10 @@ Follow the rest of the steps:
264259
![Project Farm Beats](./media/prepare-for-deployment/bash-2-1.png)
265260

266261
4. Go to your home directory in the cloud shell. By default, it is /home/<username>
267-
5. Type or paste the following two commands into the Cloud Shell. Make sure to modify the path to input. Json file and press enter.
262+
5. Type or paste the following command into the Cloud Shell. Make sure to modify the path to input. Json file and press enter.
268263

269264
```azurepowershell-interactive
270-
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScriptbash farmbeats-installer.sh /home/<username>/input.json
265+
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScript && bash farmbeats-installer.sh /home/<username>/input.json
271266
```
272267
273268
Follow the onscreen instructions.
@@ -309,11 +304,6 @@ Once the Accelerator installation is complete, you'll receive the URL to access
309304
310305
1. To sign in from Accelerator, copy and paste the URL in the browser.
311306
2. Sign in with Azure portal credentials.
312-
3. Run an optional sanity test.
313-
314-
- Check if you are able to successfully sign in to the Accelerator portal using the Accelerator link that you received as an output to a successful deployment.
315-
- Select **Create farm**.
316-
- Under the icon "?" open the FarmBeats guides using the **Get started** button.
317307
318308
## Upgrade
319309
@@ -330,7 +320,7 @@ The steps for upgrade are similar to the first-time installation. Follow these s
330320
6. Type or paste the following two commands into the Cloud Shell. Make sure to modify the path to input.json file and press enter.
331321
332322
```azurepowershell-interactive
333-
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScriptbash farmbeats-installer.sh /home/<username>/input.json
323+
wget -O farmbeats-installer.sh https://aka.ms/AzureFarmbeatsInstallerScript && bash farmbeats-installer.sh /home/<username>/input.json
334324
```
335325
Follow the onscreen instructions:
336326

0 commit comments

Comments
 (0)