Skip to content

Commit 3d1d041

Browse files
committed
all doc reviewed
1 parent 994c788 commit 3d1d041

File tree

2 files changed

+40
-17
lines changed

2 files changed

+40
-17
lines changed

content/en/docs/2025.3/getting-started/on-premise/add-configuration-portal-to-cortex/installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -312,7 +312,7 @@ It may take a few minutes for the `Code` package to restart.
312312
### Set up User Access Control
313313

314314
{{< alert color="warning" title="Important" >}}
315-
The {{% ctx %}} Configuration Portal should be viewed as a repository of sensitive information which will most likely contain usernames and passwords. Therefore consideration should be given to security when granting access to the portal, it is advised that access is limited following the practice of least privilege.
315+
The {{% ctx %}} Configuration Portal should be treated as a repository of sensitive information which will most likely contain usernames and passwords. Therefore consideration should be given to security when granting access to the portal, it is advised that access is limited following the practice of least privilege.
316316
{{< /alert >}}
317317

318318
On the Web Application Server:

content/en/docs/2025.3/getting-started/on-premise/add-configuration-portal-to-cortex/post-installation/try-it-out.md

Lines changed: 39 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
22
title: "Try it out"
33
linkTitle: "Try it out"
4-
description: "Information about trying out {{% ctx %}} for the first time."
4+
description: "Information about trying out {{% ctx %}} Configuration Portal for the first time."
55
weight: 10
66
---
77

88
# {{% param title %}}
99

10-
This guide describes how to try out a new {{% ctx %}} Configuration Portal installation to make sure it is working. Please ensure that [Setup Gateway][] has been completed before taking these steps.
10+
This guide describes how to try out a new {{% ctx %}} Configuration Portal installation to make sure it is working.
1111

1212
## Test Access to Configuration Portal
1313

14-
1. Open a web browser and navigate to the URL of the Configuration Portal. This is typically in the format `http://<server-name>/ConfigurationPortal`.
15-
1. Log in using your Active Directory credentials. Ensure that the account you are using is part of one of the Active Directory groups specified during installation.
14+
1. Open a web browser and navigate to `<protocol>://<host>:<port>/<webapplicationname>`, e.g. `https://sever.domain.com/configurationportal`.
15+
1. Log in using your Active Directory credentials. Ensure that the account you are using is a member of one of the Active Directory groups specified during installation.
1616

1717
## Test adding a new Configuration Container and Data
1818

@@ -21,7 +21,7 @@ This guide describes how to try out a new {{% ctx %}} Configuration Portal insta
2121
1. Fill in the `Name` field with the value `TestContainer`.
2222
1. Click `Confirm` to create the container.
2323
1. Click the container you just created.
24-
1. Using the values of the table below, add a some data to the created container as follows:
24+
1. Using the values of the table below, add data to the created container as follows:
2525
| Name | Value | Type |
2626
|---------------|------------------------|---------|
2727
| `TestText` | `This is a test value` | Text |
@@ -35,28 +35,51 @@ This guide describes how to try out a new {{% ctx %}} Configuration Portal insta
3535
1. Click `CONFIRM` to add the parameter/value pair.
3636

3737
{{< alert type="note" title="Note" >}}
38-
The CORTEX Configuration Portal should be viewed as a repository of sensitive information which will most likely contain usernames and passwords. We recommend that any sensitive data is {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.Advanced.EncryptText" title="CORTEX Encrypted" >}} before it is added to the portal.
38+
The {{% ctx %}} Configuration Portal should be treated as a repository of sensitive information which will most likely contain usernames and passwords. We recommend that any sensitive data is {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.Advanced.EncryptText" title="CORTEX Encrypted" >}} before it is added to the portal.
3939
{{< /alert >}}
4040

4141
## Test exporting an existing Container
4242

4343
1. You should be able to export a container by doing as follows:
44+
1. Click on `Home` to navigate back.
4445
1. Tick the `Export` checkbox next to the container you created in the previous section.
4546
1. Click on the `Export Containers` button.
4647

4748
The file should be downloaded to your computer.
4849

50+
## Test importing an existing Container
51+
52+
1. Modify some parameters from the `TestContainer` by doing as follows:
53+
1. Click on the `TestContainer` to open it.
54+
1. Click on the `Delete` button for `TestText`.
55+
1. Confirm the deletion by clicking `OK` on the pop-up.
56+
1. Click on the `Edit` button for `TestInteger`.
57+
1. Change the value to `33`.
58+
1. Click `CONFIRM` to save the changes.
59+
60+
1. You should be able to import a container by doing as follows:
61+
1. Click on `Home` to navigate back.
62+
1. Click on the `Import Containers` button.
63+
1. Select the previously exported container `zip` file.
64+
1. Click `Open` to load the container.
65+
1. On the confirmation page, click `IMPORT`.
66+
1. Please confirm the import by clicking the`OK` button on the pop-up.
67+
68+
1. Verify that the container has been imported by doing as follows:
69+
1. Click on the `TestContainer` to open it.
70+
1. Verify that the parameter `TestText` has been re-added and that the value of `TestInteger` retained the modified value of `33`.
71+
4972
{{< alert type="note" title="Note" >}}
50-
Once you have confirmed the exported file contains the expected data, it is recommended to delete it.
73+
Once you have successfully imported containers, it is recommended to always delete all the `zip` files.
5174
{{< /alert >}}
5275

5376
## Test reading data from Configuration Portal
5477

55-
1. Open a web browser and navigate to the URL of {{% ctx %}} Gateway. This is typically in the format `http://<server-name>/gateway`.
78+
1. Open a web browser and navigate to `<protocol>://<host>:<port>/<webapplicationname>`, e.g. `https://server.domain.com/gateway`
5679
1. Log in using your Active Directory credentials.
57-
1. Click on the `Dev` charms, then search for `CM-Get-Config`.
80+
1. Click on the `Dev` charm, then search for `CM-Get-Config`.
5881
1. Click on the flow `CM-Get-Config`.
59-
1. Once the flow opened, in the Settings tab, set the `ContainersNames` field to `["TestContainer"]`.
82+
1. Once the flow has opened, in the Settings tab, set the `ContainersNames` property to `["TestContainer"]`.
6083
1. Add a breakpoint to the `End Flow` block.
6184
1. Click on the `Run` button to execute the flow.
6285
1. When the flow hits the breakpoint, click on the `Variables` tab.
@@ -69,12 +92,7 @@ Once you have confirmed the exported file contains the expected data, it is reco
6992
{
7093
"ParamID": "e440c1ee-29ee-4b70-9660-60f518a10339",
7194
"ParamName": "TestInteger",
72-
"ParamValue": 22
73-
},
74-
{
75-
"ParamID": "b0cedd5c-e832-4fd2-8292-462be9b0ab71",
76-
"ParamName": "TestText",
77-
"ParamValue": "This is a test value"
95+
"ParamValue": 33
7896
},
7997
{
8098
"ParamID": "5f760269-41e4-4f99-8b82-96ac1ccfbb49",
@@ -87,6 +105,11 @@ Once you have confirmed the exported file contains the expected data, it is reco
87105
"ParamValue": {
88106
"test": 22
89107
}
108+
},
109+
{
110+
"ParamID": "b0cedd5c-e832-4fd2-8292-462be9b0ab71",
111+
"ParamName": "TestText",
112+
"ParamValue": "This is a test value"
90113
}
91114
]
92115
}

0 commit comments

Comments
 (0)