mas-cli 12.0.0__py3-none-any.whl → 12.27.0__py3-none-any.whl

mas/cli/install/settings/manageSettings.py

@@ -21,7 +21,7 @@ class ManageSettingsMixin():
                 "",
                 "Maximo Spatial requires a map server provider in order to enable geospatial capabilities",
                 "You may choose your preferred map provider later or you can enable IBM Maximo Location Services for Esri now",
-                "This includes ArcGIS Enterprise as part of the Manage and Maximo Spatial bundle (Additional AppPoints required)."
+                f"This includes ArcGIS Enterprise as part of the {self.manageAppName} and Maximo Spatial bundle (Additional AppPoints required)."
             ])
 
             if self.yesOrNo("Include IBM Maximo Location Services for Esri"):
@@ -41,8 +41,8 @@ class ManageSettingsMixin():
 
     def manageSettings(self) -> None:
         if self.installManage:
-            self.printH1("Configure Maximo Manage")
-            self.printDescription(["Customize your Manage installation, refer to the product documentation for more information"])
+            self.printH1(f"Configure Maximo {self.manageAppName}")
+            self.printDescription([f"Customize your {self.manageAppName} installation, refer to the product documentation for more information"])
 
             self.manageSettingsComponents()
             self.arcgisSettings()
@@ -52,82 +52,91 @@ class ManageSettingsMixin():
             self.manageSettingsDatabase()
             self.manageSettingsCustomizationArchive()
             self.manageSettingsOther()
+            self.manageStorageAndAccessMode()
 
-            # Default to RWX storage classes, but fall back to RWO in SNO or when user
-            # has chosen not to provide a RWX storage class
-            storageClass = self.getParam("storage_class_rwx")
-            accessMode = "ReadWriteMany"
-            if self.isSNO() or self.getParam("storage_class_rwx") == "none":
-                storageClass = self.getParam("storage_class_rwo")
-                accessMode = "ReadWriteOnce"
+    def manageStorageAndAccessMode(self) -> None:
+        # Default to RWX storage classes, but fall back to RWO in SNO or when user
+        # has chosen not to provide a RWX storage class
+        storageClass = self.getParam("storage_class_rwx")
+        accessMode = "ReadWriteMany"
+        if self.isSNO() or self.getParam("storage_class_rwx") == "none":
+            storageClass = self.getParam("storage_class_rwo")
+            accessMode = "ReadWriteOnce"
 
-            self.setParam("mas_app_settings_doclinks_pvc_storage_class", storageClass)
-            self.setParam("mas_app_settings_bim_pvc_storage_class", storageClass)
-            self.setParam("mas_app_settings_jms_queue_pvc_storage_class", storageClass)
+        self.setParam("mas_app_settings_doclinks_pvc_storage_class", storageClass)
+        self.setParam("mas_app_settings_bim_pvc_storage_class", storageClass)
+        self.setParam("mas_app_settings_jms_queue_pvc_storage_class", storageClass)
 
-            self.setParam("mas_app_settings_doclinks_pvc_accessmode", accessMode)
-            self.setParam("mas_app_settings_bim_pvc_accessmode", accessMode)
-            self.setParam("mas_app_settings_jms_queue_pvc_accessmode", accessMode)
+        self.setParam("mas_app_settings_doclinks_pvc_accessmode", accessMode)
+        self.setParam("mas_app_settings_bim_pvc_accessmode", accessMode)
+        self.setParam("mas_app_settings_jms_queue_pvc_accessmode", accessMode)
 
     def manageSettingsComponents(self) -> None:
-        self.printH2("Maximo Manage Components")
-        self.printDescription(["The default configuration will install Manage with Health enabled, alternatively choose exactly what industry solutions and add-ons will be configured"])
-
-        self.params["mas_appws_components"] = "base=latest,health=latest"
-        if self.yesOrNo("Select components to enable"):
-            self.params["mas_appws_components"] = "base=latest"
-            if self.yesOrNo(" - Asset Configuration Manager"):
-                self.params["mas_appws_components"] += ",acm=latest"
-            if self.yesOrNo(" - Aviation"):
-                self.params["mas_appws_components"] += ",aviation=latest"
-            if self.yesOrNo(" - Civil Infrastructure"):
-                self.params["mas_appws_components"] += ",civil=latest"
-            if self.yesOrNo(" - Envizi"):
-                self.params["mas_appws_components"] += ",envizi=latest"
-            if self.yesOrNo(" - Health"):
-                self.params["mas_appws_components"] += ",health=latest"
-            if self.yesOrNo(" - Health, Safety and Environment"):
-                self.params["mas_appws_components"] += ",hse=latest"
-            if self.yesOrNo(" - Maximo IT"):
-                self.params["mas_appws_components"] += ",icd=latest"
-            if self.yesOrNo(" - Nuclear"):
-                self.params["mas_appws_components"] += ",nuclear=latest"
-            if self.yesOrNo(" - Oil & Gas"):
-                self.params["mas_appws_components"] += ",oilandgas=latest"
-            if self.yesOrNo(" - Connector for Oracle Applications"):
-                self.params["mas_appws_components"] += ",oracleadapter=latest"
-            if self.yesOrNo(" - Connector for SAP Application"):
-                self.params["mas_appws_components"] += ",sapadapter=latest"
-            if self.yesOrNo(" - Service Provider"):
-                self.params["mas_appws_components"] += ",serviceprovider=latest"
-            if self.yesOrNo(" - Spatial"):
-                self.params["mas_appws_components"] += ",spatial=latest"
-            if self.yesOrNo(" - Strategize"):
-                self.params["mas_appws_components"] += ",strategize=latest"
-            if self.yesOrNo(" - Transportation"):
-                self.params["mas_appws_components"] += ",transportation=latest"
-            if self.yesOrNo(" - Tririga"):
-                self.params["mas_appws_components"] += ",tririga=latest"
-            if self.yesOrNo(" - Utilities"):
-                self.params["mas_appws_components"] += ",utilities=latest"
-            if self.yesOrNo(" - Workday Applications"):
-                self.params["mas_appws_components"] += ",workday=latest"
-            logger.debug(f"Generated mas_appws_components = {self.params['mas_appws_components']}")
-
-            if ",icd=" in self.params["mas_appws_components"]:
-                self.printH2("Maximo IT License Terms")
-                self.printDescription([
-                    "For information about your Maximo IT License, see <Orange><u>https://ibm.biz/MAXIT81-License</u></Orange>",
-                    "To continue with the installation, you must accept these additional license terms"
-                ])
-
-                if not self.yesOrNo("Do you accept the license terms"):
-                    exit(1)
+        # Only ask to install Manage components if this is a full Manage installation
+        # If this is a Manage Foundation installation, leave mas_appws_components blank
+        if self.isManageFoundation:
+            self.params["mas_appws_components"] = ""
+        else:
+            self.printH2(f"Maximo {self.manageAppName} Components")
+            self.printDescription([f"The default configuration will install {self.manageAppName} with Health enabled, alternatively choose exactly what industry solutions and add-ons will be configured"])
+
+            self.params["mas_appws_components"] = "base=latest,health=latest"
+            if self.yesOrNo("Select components to enable"):
+                self.params["mas_appws_components"] = "base=latest"
+                if self.yesOrNo(" - Asset Configuration Manager"):
+                    self.params["mas_appws_components"] += ",acm=latest"
+                if self.yesOrNo(" - Aviation"):
+                    self.params["mas_appws_components"] += ",aviation=latest"
+                if self.yesOrNo(" - Civil Infrastructure"):
+                    self.params["mas_appws_components"] += ",civil=latest"
+                if self.yesOrNo(" - Envizi"):
+                    self.params["mas_appws_components"] += ",envizi=latest"
+                if self.yesOrNo(" - Health"):
+                    self.params["mas_appws_components"] += ",health=latest"
+                if self.yesOrNo(" - Health, Safety and Environment"):
+                    self.params["mas_appws_components"] += ",hse=latest"
+                if self.yesOrNo(" - Maximo IT"):
+                    self.params["mas_appws_components"] += ",icd=latest"
+                if self.yesOrNo(" - Nuclear"):
+                    self.params["mas_appws_components"] += ",nuclear=latest"
+                if self.yesOrNo(" - Oil & Gas"):
+                    self.params["mas_appws_components"] += ",oilandgas=latest"
+                if self.yesOrNo(" - Connector for Oracle Applications"):
+                    self.params["mas_appws_components"] += ",oracleadapter=latest"
+                if self.yesOrNo(" - Connector for SAP Application"):
+                    self.params["mas_appws_components"] += ",sapadapter=latest"
+                if self.yesOrNo(" - Service Provider"):
+                    self.params["mas_appws_components"] += ",serviceprovider=latest"
+                if self.yesOrNo(" - Spatial"):
+                    self.params["mas_appws_components"] += ",spatial=latest"
+                if self.yesOrNo(" - Strategize"):
+                    self.params["mas_appws_components"] += ",strategize=latest"
+                if self.yesOrNo(" - Transportation"):
+                    self.params["mas_appws_components"] += ",transportation=latest"
+                if self.yesOrNo(" - Tririga"):
+                    self.params["mas_appws_components"] += ",tririga=latest"
+                if self.yesOrNo(" - Utilities"):
+                    self.params["mas_appws_components"] += ",utilities=latest"
+                if self.yesOrNo(" - Workday Applications"):
+                    self.params["mas_appws_components"] += ",workday=latest"
+                if self.yesOrNo(" - AIP"):
+                    self.params["mas_appws_components"] += ",aip=latest"
+                logger.debug(f"Generated mas_appws_components = {self.params['mas_appws_components']}")
+
+                if ",icd=" in self.params["mas_appws_components"]:
+                    self.printH2("Maximo IT License Terms")
+                    self.printDescription([
+                        "For information about your Maximo IT License, see <Orange><u>https://ibm.biz/MAXIT81-License</u></Orange>",
+                        "To continue with the installation, you must accept these additional license terms"
+                    ])
+
+                    if not self.yesOrNo("Do you accept the license terms"):
+                        exit(1)
 
     def manageSettingsDatabase(self) -> None:
         if self.showAdvancedOptions:
-            self.printH2("Maximo Manage Settings - Database")
-            self.printDescription(["Customise the schema, tablespace, indexspace, and encryption settings used by Manage"])
+            self.printH2(f"Maximo {self.manageAppName} Settings - Database")
+            self.printDescription([f"Customise the schema, tablespace, indexspace, and encryption settings used by {self.manageAppName}"])
 
             if self.yesOrNo("Customize database settings"):
                 self.promptForString("Schema", "mas_app_settings_db2_schema", default="maximo")
@@ -142,80 +151,83 @@ class ManageSettingsMixin():
                     self.yesOrNo("Override database encryption secrets with provided keys", "mas_app_settings_override_encryption_secrets_flag")
 
     def manageSettingsServerBundleConfig(self) -> None:
-        if self.showAdvancedOptions:
-            self.printH2("Maximo Manage Settings - Server Bundles")
-            self.printDescription([
-                "Define how you want to configure Manage servers:",
-                " - You can have one or multiple Manage servers distributing workload",
-                " - Additionally, you can choose to include JMS server for messaging queues",
-                "",
-                "Configurations:",
-                "  1. Deploy the 'all' server pod only (workload is concentrated in just one server pod but consumes less resource)",
-                "  2. Deploy the 'all' and 'jms' bundle pods (workload is concentrated in just one server pod and includes jms server)"
-            ])
-
-            if not self.isSNO():
+        if not self.isManageFoundation:
+            if self.showAdvancedOptions:
+                self.printH2(f"Maximo {self.manageAppName} Settings - Server Bundles")
                 self.printDescription([
-                    "  3. Deploy the 'mea', 'report', 'ui' and 'cron' bundle pods (workload is distributed across multiple server pods)",
-                    "  4. Deploy the 'mea', 'report', 'ui', 'cron' and 'jms' bundle pods (workload is distributed across multiple server pods and includes jms server)"
+                    f"Define how you want to configure {self.manageAppName} servers:",
+                    f" - You can have one or multiple {self.manageAppName} servers distributing workload",
+                    " - Additionally, you can choose to include JMS server for messaging queues",
+                    "",
+                    "Configurations:",
+                    "  1. Deploy the 'all' server pod only (workload is concentrated in just one server pod but consumes less resource)",
+                    "  2. Deploy the 'all' and 'jms' bundle pods (workload is concentrated in just one server pod and includes jms server)"
                 ])
 
-            manageServerBundleSelection = self.promptForString("Select a server bundle configuration")
-
-            if manageServerBundleSelection == "1":
-                self.setParam("mas_app_settings_server_bundles_size", "dev")
-            elif manageServerBundleSelection == "2":
-                self.setParam("mas_app_settings_server_bundles_size", "snojms")
-                self.setParam("mas_app_settings_persistent_volumes_flag", "true")
-            elif manageServerBundleSelection == "3":
-                self.setParam("mas_app_settings_server_bundles_size", "small")
-            elif manageServerBundleSelection == "4":
-                self.setParam("mas_app_settings_server_bundles_size", "jms")
-                self.setParam("mas_app_settings_persistent_volumes_flag", "true")
+                if not self.isSNO():
+                    self.printDescription([
+                        "  3. Deploy the 'mea', 'report', 'ui' and 'cron' bundle pods (workload is distributed across multiple server pods)",
+                        "  4. Deploy the 'mea', 'report', 'ui', 'cron' and 'jms' bundle pods (workload is distributed across multiple server pods and includes jms server)"
+                    ])
+
+                manageServerBundleSelection = self.promptForString("Select a server bundle configuration")
+
+                if manageServerBundleSelection == "1":
+                    self.setParam("mas_app_settings_server_bundles_size", "dev")
+                elif manageServerBundleSelection == "2":
+                    self.setParam("mas_app_settings_server_bundles_size", "snojms")
+                    self.setParam("mas_app_settings_persistent_volumes_flag", "true")
+                elif manageServerBundleSelection == "3":
+                    self.setParam("mas_app_settings_server_bundles_size", "small")
+                elif manageServerBundleSelection == "4":
+                    self.setParam("mas_app_settings_server_bundles_size", "jms")
+                    self.setParam("mas_app_settings_persistent_volumes_flag", "true")
+                else:
+                    self.fatalError("Invalid selection")
             else:
-                self.fatalError("Invalid selection")
-        else:
-            self.setParam("mas_app_settings_server_bundles_size", "dev")
+                self.setParam("mas_app_settings_server_bundles_size", "dev")
 
     def manageSettingsJMS(self) -> None:
         if self.getParam("mas_app_settings_server_bundles_size") in ["jms", "snojms"]:
             self.printDescription([
-                "Only Manage JMS sequential queues (sqin and sqout) are enabled by default.",
+                f"Only {self.manageAppName} JMS sequential queues (sqin and sqout) are enabled by default.",
                 "However, you can enable both sequential (sqin and sqout) and continuous queues (cqin and cqout)"
             ])
 
-            self.yesOrNo("Enable both Manage JMS sequential and continuous queues", "mas_app_settings_default_jms")
+            self.yesOrNo(f"Enable both {self.manageAppName} JMS sequential and continuous queues", "mas_app_settings_default_jms")
 
     def manageSettingsCustomizationArchive(self) -> None:
-        self.printH2("Maximo Manage Settings - Customization")
-        self.printDescription([
-            "Provide a customization archive to be used in the Manage build process"
-        ])
+        # Only ask about customization archive in full Manage installation
+        if not self.isManageFoundation:
+            self.printH2(f"Maximo {self.manageAppName} Settings - Customization")
+            self.printDescription([
+                f"Provide a customization archive to be used in the {self.manageAppName} build process"
+            ])
 
-        if self.yesOrNo("Include customization archive"):
-            self.promptForString("Customization archive name", "mas_app_settings_customization_archive_name")
-            self.promptForString("Customization archive path/url", "mas_app_settings_customization_archive_url")
-            if self.yesOrNo("Provide authentication to access customization archive URL"):
-                self.promptForString("Username", "mas_app_settings_customization_archive_username")
-                self.promptForString("Password", "mas_app_settings_customization_archive_password", isPassword=True)
+            if self.yesOrNo("Include customization archive"):
+                self.promptForString("Customization archive name", "mas_app_settings_customization_archive_name")
+                self.promptForString("Customization archive path/url", "mas_app_settings_customization_archive_url")
+                if self.yesOrNo("Provide authentication to access customization archive URL"):
+                    self.promptForString("Username", "mas_app_settings_customization_archive_username")
+                    self.promptForString("Password", "mas_app_settings_customization_archive_password", isPassword=True)  # pragma: allowlist secret
 
     def manageSettingsDemodata(self) -> None:
         self.yesOrNo("Create demo data", "mas_app_settings_demodata")
 
     def manageSettingsTimezone(self) -> None:
-        self.promptForString("Manage server timezone", "mas_app_settings_server_timezone", default="GMT")
+        self.promptForString(f"{self.manageAppName} server timezone", "mas_app_settings_server_timezone", default="GMT")
         # Set Manage dedicated Db2 instance timezone to be same as Manage server timezone
         self.setParam("db2_timezone", self.getParam("mas_app_settings_server_timezone"))
 
     def manageSettingsLanguages(self) -> None:
-        self.printH2("Maximo Manage Settings - Languages")
+        self.printH2(f"Maximo {self.manageAppName} Settings - Languages")
         self.printDescription([
-            "Define the base language for Maximo Manage"
+            f"Define the base language for Maximo {self.manageAppName}"
         ])
         self.promptForString("Base language", "mas_app_settings_base_lang", default="EN")
 
         self.printDescription([
-            "Define the additional languages to be configured in Maximo Manage. provide a comma-separated list of supported languages codes, for example: 'JA,DE,AR'",
+            f"Define the additional languages to be configured in Maximo {self.manageAppName}. provide a comma-separated list of supported languages codes, for example: 'JA,DE,AR'",
             "A complete list of available language codes is available online:",
             "    <Orange><u>https://www.ibm.com/docs/en/mas-cd/mhmpmh-and-p-u/continuous-delivery?topic=deploy-language-support</u></Orange>"
         ])
@@ -225,7 +237,7 @@ class ManageSettingsMixin():
     def manageSettingsCP4D(self) -> None:
         if self.getParam("mas_app_channel_manage") in ["8.7.x", "9.0.x"] and self.showAdvancedOptions:
             self.printDescription([
-                "Integration with Cognos Analytics provides additional support for reporting features in Maximo Manage, for more information refer to the documentation online: ",
+                f"Integration with Cognos Analytics provides additional support for reporting features in Maximo {self.manageAppName}, for more information refer to the documentation online: ",
                 " - <Orange><u>https://ibm.biz/BdMuxs</u></Orange>"
             ])
             self.yesOrNo("Enable integration with Cognos Analytics", "cpd_install_cognos")
@@ -235,44 +247,27 @@ class ManageSettingsMixin():
                 self.configCP4D()
 
     def manageSettingsOther(self) -> None:
-        self.printH2("Maximo Manage Settings - Other")
-        self.printDescription([
-            "Configure additional settings:",
-            "  - Demo data",
-            "  - Base and additional languages",
-            "  - Server timezone",
-            "  - Cognos integration (install Cloud Pak for Data)",
-            "  - Watson Studio Local integration (install Cloud Pak for Data)"
-        ])
-
-        if self.yesOrNo("Configure Additional Settings"):
-            self.manageSettingsDemodata()
-            self.manageSettingsTimezone()
-            self.manageSettingsLanguages()
-            self.manageSettingsCP4D()
-
-    def aibrokerSettings(self) -> None:
-        if self.installAiBroker:
-            self.printH2("Maximo AI Broker Settings - Storage, WatsonX, MariaDB details")
-            self.printDescription(["Customise AI Broker details"])
-            self.promptForString("Storage provider", "mas_aibroker_storage_provider")
-            self.promptForString("Storage access key", "mas_aibroker_storage_accesskey")
-            self.promptForString("Storage secret key", "mas_aibroker_storage_secretkey")
-            self.promptForString("Storage host", "mas_aibroker_storage_host")
-            self.promptForString("Storage port", "mas_aibroker_storage_port")
-            self.promptForString("Storage ssl", "mas_aibroker_storage_ssl")
-            self.promptForString("Storage region", "mas_aibroker_storage_region")
-            self.promptForString("Storage pipelines bucket", "mas_aibroker_storage_pipelines_bucket")
-            self.promptForString("Storage tenants bucket", "mas_aibroker_storage_tenants_bucket")
-            self.promptForString("Storage templates bucket", "mas_aibroker_storage_templates_bucket")
-
-            self.promptForString("Watsonxai api key", "mas_aibroker_watsonxai_apikey")
-            self.promptForString("Watsonxai machine learning url", "mas_aibroker_watsonxai_url")
-            self.promptForString("Watsonxai project id", "mas_aibroker_watsonxai_project_id")
-
-            self.promptForString("Database host", "mas_aibroker_db_host")
-            self.promptForString("Database port", "mas_aibroker_db_port")
-            self.promptForString("Database user", "mas_aibroker_db_user")
-            self.promptForString("Database name", "mas_aibroker_db_database")
-            self.promptForString("Database Secretname", "mas_aibroker_db_secret_name")
-            self.promptForString("Database password", "mas_aibroker_db_secret_value")
+        self.printH2(f"Maximo {self.manageAppName} Settings - Other")
+        if self.isManageFoundation:
+            self.printDescription([
+                "Configure additional settings:",
+                "  - Base and additional languages",
+                "  - Server timezone"
+            ])
+            if self.yesOrNo("Configure Additional Settings"):
+                self.manageSettingsTimezone()
+                self.manageSettingsLanguages()
+        else:
+            self.printDescription([
+                "Configure additional settings:",
+                "  - Demo data",
+                "  - Base and additional languages",
+                "  - Server timezone",
+                "  - Cognos integration (install Cloud Pak for Data)",
+                "  - Watson Studio Local integration (install Cloud Pak for Data)"
+            ])
+            if self.yesOrNo("Configure Additional Settings"):
+                self.manageSettingsDemodata()
+                self.manageSettingsTimezone()
+                self.manageSettingsLanguages()
+                self.manageSettingsCP4D()

mas/cli/install/settings/mongodbSettings.py

@@ -19,7 +19,7 @@ class MongoDbSettingsMixin():
             "The installer can setup mongoce in your OpenShift cluster (available only for amd64) or you may choose to configure MAS to use an existing mongodb"
         ])
 
-        if self.architecture != "s390x" and self.yesOrNo("Create MongoDb cluster using MongoDb Community Edition Operator"):
+        if (self.architecture != "s390x" and self.architecture != "ppc64le") and self.yesOrNo("Create MongoDb cluster using MongoDb Community Edition Operator"):
             if self.showAdvancedOptions:
                 self.promptForString("MongoDb namespace", "mongodb_namespace", default="mongoce")
             else:

mas/cli/install/settings/turbonomicSettings.py

@@ -8,8 +8,6 @@
 #
 # *****************************************************************************
 
-from mas.devops.mas import isAirgapInstall
-
 
 class TurbonomicSettingsMixin():
 
@@ -21,7 +19,7 @@ class TurbonomicSettingsMixin():
                 " - Learn more: <Orange><u>https://www.ibm.com/products/turbonomic</u></Orange>"
             ])
 
-            if isAirgapInstall(self.dynamicClient):
+            if self.isAirgap():
                 self.printHighlight("The Turbonomic Kubernetes Operator does not support disconnected installation at this time")
             elif self.yesOrNo("Configure IBM Turbonomic integration"):
                 self.promptForString("Turbonomic Target Name", "turbonomic_target_name")