You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Apr 13, 2023. It is now read-only.
Copy file name to clipboardexpand all lines: INSTALL.md
+27-7
Original file line number
Diff line number
Diff line change
@@ -106,7 +106,7 @@ yarn install
106
106
yarn run release
107
107
```
108
108
109
-
### IAM User ARN
109
+
### IAM User ARN (LEGACY)
110
110
111
111
Create a new file in the package's root folder named
112
112
@@ -120,7 +120,24 @@ In the _serverless_config.json_ file, add the following, using the previously no
120
120
}
121
121
```
122
122
123
-
### AWS service deployment
123
+
### AWS service deployment with CDK
124
+
Using the previously noted AWS Profile, deploy the required AWS services to your AWS account. By default, the region and stage of the deployment are set to us-west-2, and dev, respectively. These can be configured by adjusting the default context values in the [cdk.json](./cdk.json) file.
125
+
126
+
```sh
127
+
yarn deploy --profile <AWS PROFILE>
128
+
```
129
+
130
+
Or you can deploy with a custom stage (default: dev) and/or region (default: us-west-2)
Retrieve auto-generated IDs or instance names by checking in the [Info Output](./INFO_OUTPUT.log) file.
137
+
138
+
All of the stack's outputs will be located in this file, for future reference.
139
+
140
+
### AWS service deployment (LEGACY)
124
141
125
142
Using the previously noted AWS Profile, deploy the required AWS services to your AWS account using the default setting of stage: dev and region: us-west-2. To change the default stage/region look for the stage/region variable in the [serverless.yaml](./serverless.yaml) file under the provider: object.
126
143
@@ -227,14 +244,15 @@ If you lose this URL, it can be found in the `Info_Output.log` file under the "E
227
244
228
245
##### Accessing Elasticsearch Kibana server
229
246
230
-
> NOTE: Kibana is only deployed in the default 'dev' stage; if you want Kibana set up in other stages, like 'production', please remove `Condition: isDev` from [elasticsearch.yaml](./cloudformation/elasticsearch.yaml)
247
+
> NOTE: Kibana is only deployed in the default 'dev' stage; if you want Kibana set up in other stages, like 'production', please remove `Condition: isDev` from [elasticsearch.yaml](./cloudformation/elasticsearch.yaml) if using serverless, or in the [elasticsearch.ts](./lib/elasticsearch.ts) file if using CDK.
231
248
232
249
The Kibana server allows you to explore data inside your Elasticsearch instance through a web UI.
233
250
234
251
In order to be able to access the Kibana server for your Elasticsearch Service Instance, you need to create and confirm a Cognito user. This Cognito user must also have an email address associated with it. Run the below command or create a user from the Cognito console.
235
252
236
253
```sh
237
-
# Find ELASTIC_SEARCH_KIBANA_USER_POOL_APP_CLIENT_ID in the printout
254
+
# Find ELASTIC_SEARCH_KIBANA_USER_POOL_APP_CLIENT_ID in the Info_Output.log, Or
255
+
# Find ELASTIC_SEARCH_KIBANA_USER_POOL_APP_CLIENT_ID in the printout (LEGACY)
After the Cognito user is created and confirmed you can now log in with the username and password, at the ELASTIC_SEARCH_DOMAIN_KIBANA_ENDPOINT (found with the `serverless info --verbose` command). **Note** Kibana will be empty at first and have no indices, they will be created once the FHIR server writes resources to the DynamoDB
293
+
After the Cognito user is created and confirmed you can now log in with the username and password, at the ELASTIC_SEARCH_DOMAIN_KIBANA_ENDPOINT (found within the [Info Output](./INFO_OUTPUT.log) or with the `serverless info --verbose` command). **Note** Kibana will be empty at first and have no indices, they will be created once the FHIR server writes resources to the DynamoDB
275
294
276
295
#### DynamoDB table backups
277
296
278
297
Daily DynamoDB Table back-ups can be optionally deployed via an additional 'fhir-server-backups' stack. The installation script will deploy this stack automatically if indicated during installation.
298
+
You can enable this by passing in the context parameter during the deployment process (`-c enableBackup=true`).
279
299
280
300
The reason behind multiple stacks is that backup vaults can be deleted only if they are empty, and you can't delete a stack that includes backup vaults if they contain any recovery points. With separate stacks it is easier for you to operate.
281
301
282
302
These back-ups work by using tags. In the [serverless.yaml](./serverless.yaml) you can see ResourceDynamoDBTableV2 has a `backup - daily` & `service - fhir` tag. Anything with these tags will be backed-up daily at 5:00 UTC.
283
303
284
-
To deploy the stack and start daily backups (outside of the install script):
304
+
To deploy the stack and start daily backups (outside of the install script) (LEGACY):
0 commit comments