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
Copy file name to clipboardExpand all lines: content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md
+35-28Lines changed: 35 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,11 @@
1
1
---
2
2
title: "Running the Mendix Operator in Global Mode"
3
3
url: /developerportal/deploy/global-operator/
4
-
description: "Describes the processes of installing and configuring the Mendix Operator in the Private Cloud in Global mode"
4
+
description: "Describes the processes of installing and configuring the Mendix Operator in the Private Cloud in Global Mode"
5
5
weight: 30
6
6
beta: true
7
7
---
8
8
9
-
{{% alert color="info" %}}
10
-
This feature is currently in beta. For more information, see [Beta Releases](/releasenotes/beta-features/).
11
-
{{% /alert %}}
12
-
13
9
## Introduction
14
10
15
11
When running the Mendix Operator in Global mode, one installation of the Mendix Operator and Agent is sufficient to manage applications across multiple namespaces. This Operator mode is recommended for new customers, or customers that want to streamline and simplify their deployments and operations. For existing customers, and for use cases that require having a separate Operator instance for every namespace, the [Standard mode](/developerportal/deploy/standard-operator/) is still available and supported.
@@ -40,7 +36,7 @@ To install and configure the Global Operator, perform the following steps:
40
36
41
37
4. After the Global Operator cluster is created, click **Add Global Operator Main Namespace**.
42
38
43
-
{{% alert color="warning" %}}Ensure that you do not use a namespace that is intended to be a managed namespace, that is, a namespace where you plan to deploy a Mendix app. The Global Operator namespace must be separate from managed namespaces, otherwise you may encounter unexpected results.{{% /alert %}}
39
+
{{% alert color="warning" %}}Ensure that you do not use a namespace that is intended to be a managed namespace, that is, a namespace where you plan to deploy a Mendix app. The Global Operator main namespace must be separate from managed namespaces, otherwise you may encounter unexpected results.{{% /alert %}}
4. You can apply the custom TLS and proxy settings in the Global Operator main namespace by just selecting only the **Custom TLS** and **Proxy** options in the Configuration Tool.
56
+
59
57
7. Verify that the installation was successful by using the following command:
60
58
61
59
```shell
@@ -68,57 +66,64 @@ To install and configure the Global Operator, perform the following steps:
68
66
kubectl -n {globalOperatorNamespace} get pods
69
67
```
70
68
71
-
9. In the Private Cloud Portal, verify that the status of the Global Operator namespace is *Connected*, as in the following figure:
69
+
9. In the Private Cloud Portal, verify that the status of the Global Operator main namespace is *Connected*, as in the following figure:
11. Install the managed namespace under the Global Operator namespace by clicking **Add Managed Namespace**.
77
+
11. Once the Global Operator main namespace is connected, the **Convert Namespace** and **Add Managed Namespace** buttons are enabled and you can install the managed namespace under the Global Operator namespace by clicking **Add Managed Namespace**.
{{% alert color="warning" %}}Ensure that you use the same name forthe managed namespacein the Portal and in the cluster. Using different names may result in unwanted issues.{{% /alert %}}
81
+
{{% alert color="warning" %}}Ensure that you use the same name forthe managed namespacein the Portal and in the clusterwhile running the command. Using different names may result in unwanted issues.{{% /alert %}}
84
82
85
-
12. Open the managed namespace and click **Done**.
83
+
12. Provide the managed namespace name under which you want to deploy the mendix application and click **Done**.
86
84
87
-
13. [Configure the namespace](/developerportal/deploy/standard-operator/#configure-namespace).
85
+
{{% alert color="warning" %}}Ensure that you do not use the name of a main namespace {{% /alert %}}
88
86
89
-
14. On the **Configuration** page, selectthe**Operating system** and run the **Configuration**command under the **Configuration** section.
87
+
13. On the **Configuration** page, selectthe**Operating system** and run the **Configuration**command under the **Configuration** section.
90
88
91
-
{{% alert color="warning" %}}Ensure that you do not use a namespace that is already used as a Global Operator namespace. The Global Operator namespace must be separate from managed namespaces, otherwise you may encounter unexpected results.{{% /alert %}}
89
+
{{% alert color="warning" %}}Ensure that you do not use a namespace that is already used as a Global Operator main namespace. The Global Operator namespace must be separate from managed namespaces, otherwise you may encounter unexpected results.{{% /alert %}}
92
90
93
-
15. Click **Configure Namespace** and selectthe items which you want to configure.
94
-
16. In the **Global Operator** section, enter the **Global Operator namespace name**.
95
-
96
-
{{% alert color="warning" %}}Ensure that you do not use the name of a managed namespace (that is, a namespace where you plan to deploy a Mendix app).{{% /alert %}}
97
-
98
-
17. [Configure any remaining namespace settings](/developerportal/deploy/standard-operator/#configure-namespace) and apply the configuration.
91
+
14. Click **Configure Namespace**. Under **Global Operator** section in the cli, provide the main namespace name and selectthe resources which need to be configured in the managed namespace. Follow [Configure the namespace](/developerportal/deploy/standard-operator/#configure-namespace) for more information. Once the information is provided, under **Review and Apply** section, click **Apply Configuration**
99
92
100
93
### Results
101
94
102
95
After you configure the managed namespace, the Agent and Operator pod are restarted automatically, so that the Global Operator namespace can process the newly added managed namespace. The managed namespace is added to the Operator configuration forthe Global Operator namespace, and the required storage plans are createdin the managed namespace.
103
96
104
-
The Operator configuration for the managed namespace is created as well. The configuration changes inside the managed namespace will take precedence over the global configuration.
97
+
The Operator configuration for the managed namespace is created as well.
98
+
99
+
{{% alert color="info" %}}The configuration changes inside the managed namespace will take precedence over the global configuration.{{% /alert %}}
105
100
106
101
After configuration, the status of managed namespace changes to **Configured**.
107
102
108
-
Once the managed namespace is configured, you can find the list with all the namespaces managed by the globally installed operator in**Addition Information** section of Global Operator Namespace.
103
+
Once the managed namespace is configured, you can find the list with all the namespaces managed by the globally installed operator in**Additional Information** section of the main namespace. The list is displayed in the **Global Installation Managed Namespaces** section.
109
104
110
105
{{% alert color="info" %}}
111
-
If the managed namespaces are deleted from the portal, the namespaces will not be deleted from the cluster. The managed namespaces needs to be manually deleted from the cluster. Additionally, you also need to remove the managed namespace from the list of managed namespaces in the Operator configuration of the main namespace.
106
+
If you delete the managed namespaces from the portal, they are not deleted from the cluster. You must delete them from the cluster manually. You must also remove the managed namespace from the list of managed namespaces in the Operator configuration of the main namespace.
107
+
108
+
The main namespace cannot be deleted from the portal until the managed namespaces are deleted from the cluster.
112
109
{{% /alert %}}
113
110
114
111
### Next Steps
115
112
116
-
After everything is configured, you can deploy the application. For more information, see [Deploy Application](/developerportal/deploy/private-cloud-deploy/).
113
+
After everything is configured, you can deploy the application. For more information, see [Deploy Application](/developerportal/deploy/private-cloud-deploy/). The application is deployed within the managed namespace.
117
114
118
115
## Convert Namespace from Standard to Global Operator {#convert-standard-operator-to-global-operator}
119
116
120
117
You can convert a namespace which currently uses the standard operator to be a Global Operator managed namespace by completing the following steps.
121
118
119
+
{{% alert color="info" %}}
120
+
Ensure that the namespace to be converted is in the same cluster as the main namespace. Additionally, ensure that both namespaces have the same operator version; otherwise, the conversion will not be performed.
121
+
{{% /alert %}}
122
+
123
+
{{% alert color="info" %}}
124
+
Currently, there is no API support to convert a namespace from standard to global operator.
125
+
{{% /alert %}}
126
+
122
127
1. On the Cluster Overview page, click **Convert Namespace**.
4. Run the command and make sure that you are logged in to the cluster where the conversion must be done.
135
140
136
141
Once the command has been run successfully, your namespace will be converted to managed namespace as part of Global Operator installation on the cluster side.
137
142
@@ -141,8 +146,10 @@ You can convert a namespace which currently uses the standard operator to be a G
141
146
142
147
5. Once the conversion command runs successfully, click **Next** to be redirected to the Conversion Summary pop-up page, which will confirm the successful conversion. This step will also ensure that the namespace conversion is visible on the portal side as well.
143
148
149
+
6. Click **Done** to return to the Namespaces Overview page.
150
+
144
151
{{% alert color="info" %}}
145
-
Once all the standard namespaces within a cluster created on portal side are converted to Global Operator Managed namespace, thenthe status of the cluster would be changed to **Conversion Finalized**, otherwise it will show **Conversion in Progress**if not all the namespaces within that cluster are converted.
152
+
After the standard namespaces are converted to Global Operator Managed namespace, the status of the cluster in which the standard namespace was present before conversion is changed to **Conversion Finalized**. If not all the namespaces within the cluster are converted yet, the status shows **Conversion in Progress**.
146
153
{{% /alert %}}
147
154
148
155
## Licensing
@@ -152,11 +159,11 @@ Once all the standard namespaces within a cluster created on portal side are con
152
159
Configure Private Cloud License Management (PCLM) in the Global Operator namespace. For more information, see [Private Cloud License Manager](/developerportal/deploy/private-cloud/private-cloud-license-manager/).
153
160
154
161
{{% alert color="info" %}}
155
-
For Global Operator installations, execute the above commandin both the Global Operator namespace and its managed namespaces where the license is intended to be applied. Make sure that identical PCLM license details are configured for both the Managed and Global Operator namespaces to avoid unexpected outcomes.
162
+
For Global Operator installations, execute the commands from the PCLM section in both the Global Operator namespace and its managed namespaces where the license must be applied. Make sure that identical PCLM license details are configured for both the Managed and Global Operator namespaces to avoid unexpected outcomes.
156
163
{{% /alert %}}
157
164
158
165
{{% alert color="warning" %}}
159
-
It is crucial to maintain consistent Operator configuration forPCLMin both the Global Operator and managed namespaces. This requires uniformity in server URLs and credential secret names used both in managed and Global Operator namespaces. Any deviations from this practice may lead to unexpected and undesired outcomes.
166
+
It is crucial to maintain consistent Operator configuration forPCLMin both the Global Operator main namespace and managed namespaces. This requires uniformity in server URLs and credential secret names used both in managed and Global Operator namespaces. Any deviations from this practice may lead to unexpected and undesired outcomes.
160
167
{{% /alert %}}
161
168
162
169
Licenses imported in the PCLM Server appear in the PCLM Statistics section of the Global Operator main namespace. You can see both **Runtime** and **Operator** license.
@@ -165,4 +172,4 @@ Claimed licenses are visible in the PCLM Statistics section of the Managed names
165
172
166
173
## Upgrading Managed Namespaces
167
174
168
-
Currently, the upgrade procedure is not available formanaged namespaces.
175
+
When you [upgrade](/developerportal/deploy/private-cloud-upgrade-guide/#upgrade-cluster) the Global Operator main namespace, the managed namespaces within the global operator namespace are also automatically upgraded.
0 commit comments