Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

W-16622164-configure-pce4-studio-kt #575

Merged
merged 18 commits into from
Nov 1, 2024
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 4 additions & 2 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -83,8 +83,10 @@
* xref:eu-cloud-configuration.adoc[Configure EU Cloud in Studio]

* xref:pce-configuration.adoc[Configure Private Cloud Edition in Studio]
** xref:pce-configuration-macos.adoc[MacOS]
** xref:pce-configuration-windows.adoc[Windows]
** xref:pce4-configuration.adoc[Configure PCE 4 in Studio]
** xref:pce3-configuration.adoc[Configure PCE 3 in Studio]
*** xref:pce-configuration-macos.adoc[MacOS]
*** xref:pce-configuration-windows.adoc[Windows]

* xref:login-platform-from-studio.adoc[]
** xref:set-credentials-in-studio-to.adoc[]
Expand Down
8 changes: 3 additions & 5 deletions modules/ROOT/pages/pce-configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,7 @@ ifndef::env-site,env-github[]
include::_attributes.adoc[]
endif::[]

Anypoint Studio 7.12 and later supports native integration with PCE version 3.0.0, 3.0.1, and 3.0.2.
To configure Anypoint Private Cloud Edition (Anypoint Platform PCE) in Anypoint Studio, follow the instructions for the version you are installing:

The following articles show you how to configure Studio to access your PCE instance according to your operative system:

* xref:pce-configuration-macos.adoc[MacOS]
* xref:pce-configuration-windows.adoc[Windows]
* xref:pce4-configuration.adoc[Configure Anypoint Platform PCE 4.x in Studio]
* xref:pce3-configuration.adoc[Configure Anypoint Platform PCE 3.x in Studio]
6 changes: 6 additions & 0 deletions modules/ROOT/pages/pce3-configuration.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
= Configure Anypoint Platform PCE 3.x in Studio

Anypoint Studio 7.12 and later supports native integration with PCE version 3.0.0, 3.0.1, and 3.0.2. Review the following articles for the configuration according to your operative system:

* xref:pce-configuration-macos.adoc[MacOS]
* xref:pce-configuration-windows.adoc[Windows]
57 changes: 57 additions & 0 deletions modules/ROOT/pages/pce4-configuration.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
= Configure Anypoint Platform PCE 4.x in Studio

Anypoint Studio 7.19 and later supports native integration with Anypoint Platform PCE version 4.0.0.

== Configure Your PCE Certificates into Studio

Follow these steps to integrate your Studio installation with Anypoint Platform PCE 4.0 in a MacOS environment:

=== Determine the Java Version and Location

. Open Anypoint Studio.
. Navigate to *Anypoint Studio > Settings...> Preferences > Java > Installed JRES*.
. Check the location of the JRE you use: Java 8 or Java 17.

image::pce4-jre-location.png["JRE location in Anypoint Studio"]

=== Export the Certificate using the Platform DNS

To export the certificate, run the following command by replacing `<ANYPOINT_DNS>` with your actual server URL:

`keytool -printcert -sslserver <ANYPOINT_DNS>:443 -rfc > /tmp/PCE_Certificate.cer`

For example:

[source,xml,linenums]
----
keytool -printcert -sslserver $ANYPOINT_DNS:443 -rfc > /tmp/PCE_Certificate.cer
----

=== Import the Certificate

To import the certificate, run the following command by replacing `<JAVA_HOME>` with the path to your embedded Java in Anypoint Studio:

`sudo keytool -import -trustcacerts -keystore <JAVA_HOME>/lib/security/cacerts -storepass changeit -file /tmp/PCE_Certificate.cer`

For example when using embedded Java 17:

[source,xml,linenums]
----
sudo keytool -import -trustcacerts -keystore /Applications/AnypointStudio.app/Contents/Eclipse/plugins/org.mule.tooling.jdk.macosx.x86_64_1.3.0/Contents/Home/jre/lib/security/cacerts -storepass changeit -file /tmp/PCE_Certificate.cer`
----

=== Set a Private Cloud Instance URL

. In Studio, open the preferences view. +
Navigate to *Anypoint Studio* > *Preferences...* or press `cmd + ,`.
. Expand *Anypoint Studio* in the left navigation bar, and select *Anypoint Platform*.
+
image::reuse::studio-anypoint-platform-settings.png[alt="Anypoint Studio highlighted in the navigation bar."]
. Select the *Use a Private Cloud Instance URL*.
. Type the URL of your PCE installation in the *Private Cloud Instance URL* field.
+
image::studio::pce-properties.png["*Private Cloud Instance URL* field highlighted in the in the *PCE Settings* section."]
. Click *Apply and Close*.
. Restart Studio.

include::studio::partial$pce-configuration-macos.adoc[tag=pce-user-config]