Doc Feedback:

Location : https://apim.docs.wso2.com/en/latest/install-and-setup/setup/distributed-deployment/product-profiles/

I followed the steps in the document correctly, but none of them worked, and I even encountered errors. It's really difficult to understand your documentation, and it's challenging to follow because it's very fragmented.

[root@wso2-am-01-ext bin]# ./profileSetup.sh -Dprofile=control-plane [2023-06-11 18:02:13] INFO - Starting to optimize API Manager for the Control Plane profile [2023-06-11 18:02:13] INFO - Starting to optimize configs in deployment.toml [2023-06-11 18:02:13] INFO - Renamed the existing ../repository/conf/deployment.toml file as deployment.toml.backup [2023-06-11 18:02:13] INFO - Copied the existing ../repository/resources/conf/deployment-templates/control-plane.toml file as ../repository/conf/deployment.toml [2023-06-11 18:02:13] INFO - Removed the inbound-endpoints directory from ../repository/deployment/server/synapse-configs/default [2023-06-11 18:02:13] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/axis2/axis2.xml.j2 file as axis2.xml.j2.backup [2023-06-11 18:02:13] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/axis2/axis2_ControlPlane.xml.j2 file as axis2.xml.j2 [2023-06-11 18:02:13] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/axis2/tenant-axis2.xml.j2 file as tenant-axis2.xml.j2.backup [2023-06-11 18:02:13] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/axis2/tenant-axis2_ControlPlane.xml.j2 file as tenant-axis2.xml.j2

[root@wso2-am-01-ext bin]# ./api-manager.sh -Dprofile=control-plane ./api-manager.sh: line 135: warning: command substitution: ignored null byte in input JAVA_HOME environment variable is set to /app/jdk-17.0.7/ CARBON_HOME environment variable is set to /app/wso2am_cp Using Java memory options: -Xms256m -Xmx1024m [2023-06-11 18:02:49,786] SEVERE {org.wso2.carbon.server.Main handleConfiguration} - Error while performing configuration changes org.wso2.config.mapper.ConfigParserException: Error while reading metadata at org.wso2.config.mapper.MetaDataParser.readLastModifiedValue(MetaDataParser.java:76) at org.wso2.config.mapper.MetaDataParser.getChangedFiles(MetaDataParser.java:164) at org.wso2.config.mapper.ConfigParser.parse(ConfigParser.java:108) at org.wso2.carbon.server.Main.handleConfiguration(Main.java:235) at org.wso2.carbon.server.Main.main(Main.java:106) at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77) at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.base/java.lang.reflect.Method.invoke(Method.java:568) at org.wso2.carbon.bootstrap.Bootstrap.loadClass(Bootstrap.java:69) at org.wso2.carbon.bootstrap.Bootstrap.main(Bootstrap.java:51) Caused by: java.io.FileNotFoundException: /app/wso2am_cp/repository/deployment/server/synapse-configs/default/inbound-endpoints/SecureWebhookServer.xml (No such file or directory) at java.base/java.io.FileInputStream.open0(Native Method) at java.base/java.io.FileInputStream.open(FileInputStream.java:216) at java.base/java.io.FileInputStream.<init>(FileInputStream.java:157) at org.wso2.config.mapper.MetaDataParser.getMetadata(MetaDataParser.java:97) at org.wso2.config.mapper.MetaDataParser.readLastModifiedValue(MetaDataParser.java:74) ... 10 more

Start with the product-profiles documentation at the linked URL and reproduce the reported control-plane commands, profileSetup.sh and api-manager.sh. Investigate the missing SecureWebhookServer.xml error and the documented sequence; the work is done when the distributed-deployment steps are verified or the prerequisites and limitations are clearly documented.