Getting started with Managed Service for OpenSearch
To get started with the service:
Getting started
-
Log in to the management console
or register if you haven't yet. -
You can connect to an OpenSearch cluster from both inside Nebius AI and the internet:
-
To connect from inside Nebius AI, create a Linux VM in the same network as the cluster.
-
To connect to a cluster from the internet, request public access to nodes with the
DATA
role when creating the cluster.
-
Note
These instructions assume that you're connecting to the cluster from the internet.
Create a cluster
-
In the management console
, select the folder where you want to create a cluster. -
Select Managed Service for OpenSearch.
-
Click Create cluster. This process is described in detail in Creating a OpenSearch cluster.
-
Set the cluster parameters.
-
Click Create cluster.
-
Wait until the cluster is ready: its status on the Managed Service for OpenSearch dashboard changes to Creating and then to Alive. This may take some time.
Connect to the cluster
It is assumed that all the steps below are performed on Linux.
To connect to a cluster:
-
Install an SSL certificate:
Linux (Bash) and macOS (Zsh)Windows (PowerShell)mkdir -p ~/.opensearch && \ wget "https://storage.nemax.nebius.cloud/certs/CA.pem" \ --output-document ~/.opensearch/root.crt && \ chmod 0600 ~/.opensearch/root.crt
The certificate is saved to the
~/.opensearch/root.crt
file.mkdir $HOME\.opensearch; curl -o $HOME\.opensearch\root.crt https://storage.nemax.nebius.cloud/certs/CA.pem
The certificate is saved to the
$HOME\.opensearch\root.crt
file. -
Connect to the cluster using cURL
:curl \ --user admin:<password> \ --cacert ~/.opensearch/root.crt \ --request GET 'https://<ID of OpenSearch node with DATA role>.mdb.nemax.nebius.cloud:9200/'
To connect, enter the
admin
username and password used when creating the cluster.A message like this is displayed if the connection is successful:
{ "name" : "....mdb.nemax.nebius.cloud", "cluster_name" : "...", "cluster_uuid" : "...", "version" : { "distribution" : "opensearch", ... }, "tagline" : "The OpenSearch Project: https://opensearch.org/" }
Connect to OpenSearch Dashboards
-
In the browser, connect to the OpenSearch Dashboards
web interface:-
Make sure that nodes with the
DASHBOARDS
role are publicly accessible. -
Install the SSL certificate
in the browser's trusted root certificate store (instructions for Mozilla Firefox). -
On the cluster page, in the management console, click OpenSearch Dashboards or go to
https://c-<OpenSearch cluster ID>.rw.mdb.nemax.nebius.cloud>
in your browser. -
Enter the
admin
username and password that you set when creating the cluster.
-
-
Explore a set of sample data:
- On the OpenSearch Dashboards welcome screen, click Add sample data.
- Next, click View data for the desired dataset.
Learn more about working with OpenSearch Dashboards, in the OpenSearch documentation
What's next
- Read about service concepts.
- Learn more about creating a cluster and connecting to a cluster.