diff --git a/_install-and-configure/install-dashboards/debian.md b/_install-and-configure/install-dashboards/debian.md index 43720492301..73aba46cd41 100644 --- a/_install-and-configure/install-dashboards/debian.md +++ b/_install-and-configure/install-dashboards/debian.md @@ -131,3 +131,44 @@ By default, OpenSearch Dashboards, like OpenSearch, binds to `localhost` when yo 1. From a web browser, navigate to OpenSearch Dashboards. The default port is 5601. 1. Log in with the default username `admin` and the default password `admin`. (For OpenSearch 2.12 and later, the password should be the custom admin password) 1. Visit [Getting started with OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/index/) to learn more. + + +## Upgrade to a newer version + +OpenSearch Dashboards instances installed using `dpkg` or `apt-get` can be easily upgraded to a newer version. + +### Manual upgrade with DPKG + +Download the Debian package for the desired upgrade version directly from the [OpenSearch Project downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. + +Navigate to the directory containing the distribution and run the following command: + +```bash +sudo dpkg -i opensearch-dashboards-{{site.opensearch_version}}-linux-x64.deb +``` +{% include copy.html %} + +### APT-GET + +To upgrade to the latest version of OpenSearch Dashboards using `apt-get`, run the following command: + +```bash +sudo apt-get upgrade opensearch-dashboards +``` +{% include copy.html %} + +You can also upgrade to a specific OpenSearch Dashboards version by providing the version number: + +```bash +sudo apt-get upgrade opensearch-dashboards= +``` +{% include copy.html %} + +### Automatically restart the service after a package upgrade (2.13.0+) + +To automatically restart OpenSearch Dashboards after a package upgrade, enable the `opensearch-dashboards.service` through `systemd`: + +```bash +sudo systemctl enable opensearch-dashboards.service +``` +{% include copy.html %} diff --git a/_install-and-configure/install-dashboards/rpm.md b/_install-and-configure/install-dashboards/rpm.md index d250c4c1f39..cc5974c91e7 100644 --- a/_install-and-configure/install-dashboards/rpm.md +++ b/_install-and-configure/install-dashboards/rpm.md @@ -89,4 +89,41 @@ YUM, the primary package management tool for Red Hat-based operating systems, al 1. Once complete, you can run OpenSearch Dashboards. ```bash sudo systemctl start opensearch-dashboards - ``` \ No newline at end of file + ``` + +## Upgrade to a newer version + +OpenSearch Dashboards instances installed using RPM or YUM can be easily upgraded to a newer version. We recommend using YUM, but you can also choose RPM. + + +### Manual upgrade with RPM + +Download the RPM package for the desired upgrade version directly from the [OpenSearch Project downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. + +Navigate to the directory containing the distribution and run the following command: + +```bash +rpm -Uvh opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm +``` +{% include copy.html %} + +### YUM + +To upgrade to the latest version of OpenSearch Dashboards using YUM, run the following command: + +```bash +sudo yum update opensearch-dashboards +``` +{% include copy.html %} + +You can also upgrade to a specific OpenSearch Dashboards version by providing the version number: + + ```bash + sudo yum update opensearch-dashboards- + ``` + {% include copy.html %} + +### Automatically restart the service after a package upgrade + +The OpenSearch Dashboards RPM package does not currently support automatically restarting the service after a package upgrade. + diff --git a/_install-and-configure/install-opensearch/debian.md b/_install-and-configure/install-opensearch/debian.md index 6f9167a12c4..72ae05d87c6 100644 --- a/_install-and-configure/install-opensearch/debian.md +++ b/_install-and-configure/install-opensearch/debian.md @@ -528,7 +528,7 @@ OpenSearch instances installed using `dpkg` or `apt-get` can be easily upgraded ### Manual upgrade with DPKG -Download the Debian package for the desired upgrade version directly from the [OpenSearch downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. +Download the Debian package for the desired upgrade version directly from the [OpenSearch Project downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. Navigate to the directory containing the distribution and run the following command: ```bash @@ -550,6 +550,15 @@ sudo apt-get upgrade opensearch= ``` {% include copy.html %} +### Automatically restart the service after a package upgrade (2.13.0+) + +To automatically restart OpenSearch after a package upgrade, enable the `opensearch.service` through `systemd`: + +```bash +sudo systemctl enable opensearch.service +``` +{% include copy.html %} + ## Related links - [OpenSearch configuration]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/) diff --git a/_install-and-configure/install-opensearch/rpm.md b/_install-and-configure/install-opensearch/rpm.md index ac3ff4e0e98..a22ea96d618 100644 --- a/_install-and-configure/install-opensearch/rpm.md +++ b/_install-and-configure/install-opensearch/rpm.md @@ -500,7 +500,7 @@ OpenSearch instances installed using RPM or YUM can be easily upgraded to a newe ### Manual upgrade with RPM -Download the RPM package for the desired upgrade version directly from the [OpenSearch downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. +Download the RPM package for the desired upgrade version directly from the [OpenSearch Project downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. Navigate to the directory containing the distribution and run the following command: ```bash @@ -512,7 +512,7 @@ rpm -Uvh opensearch-{{site.opensearch_version}}-linux-x64.rpm To upgrade to the latest version of OpenSearch using YUM: ```bash -sudo yum update +sudo yum update opensearch ``` {% include copy.html %} @@ -522,6 +522,10 @@ sudo yum update ``` {% include copy.html %} +### Automatically restart the service after a package upgrade + +The OpenSearch RPM package does not currently support automatically restarting the service after a package upgrade. + ## Related links - [OpenSearch configuration]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/)