diff --git a/docs/INSTALL.kali.md b/docs/INSTALL.kali.md index e7d93384a..1ba0f6e64 100644 --- a/docs/INSTALL.kali.md +++ b/docs/INSTALL.kali.md @@ -1,8 +1,8 @@ # INSTALLATION INSTRUCTIONS -## for Kali Linux 2020.4 +## for Kali Linux 2021.1 # 0/ Quick MISP Instance on Kali Linux - Status -This has been tested by @SteveClement on 20210203 +This has been tested by @SteveClement on 20210331 # 1/ Prepare Kali with a MISP User diff --git a/docs/INSTALL.rhel7.md b/docs/INSTALL.rhel7.md index 7ba24651f..146bbd3cb 100644 --- a/docs/INSTALL.rhel7.md +++ b/docs/INSTALL.rhel7.md @@ -25,7 +25,7 @@ wget -O /tmp/INSTALL.sh https://raw.githubusercontent.com/MISP/MISP/2.4/INSTALL/INSTALL.sh bash /tmp/INSTALL.sh -c ``` - **The above does NOT work yet** + **The above does NOT fully work yet** !!! notice If the next line is `[!generic/community.md!]()` [click here](https://misp.github.io/MISP/INSTALL.rhel7/). @@ -37,18 +37,15 @@ {!generic/rhelVScentos.md!} !!! warning - The core MISP team cannot verify if this guide is working or not. Please help us in keeping it up to date and accurate. + The core MISP team cannot easily verify if this guide is working or not. Please help us in keeping it up to date and accurate. Thus we also have difficulties in supporting RHEL issues but will do a best effort on a similar yet slightly different setup. -!!! notice - This document also serves as a source for the [INSTALL-misp.sh](https://github.com/MISP/MISP/blob/2.4/INSTALL/INSTALL.sh) script. - Which explains why you will see the use of shell *functions* in various steps. - Henceforth the document will also follow a more logical flow. In the sense that all the dependencies are installed first then config files are generated, etc... - !!! notice Maintenance for CentOS 7 will end on: June 30th, 2024 [Source[0]](https://wiki.centos.org/About/Product) [Source[1]](https://linuxlifecycle.com/) CentOS 7-1908 [NetInstallURL](http://mirror.centos.org/centos/7/os/x86_64/) +{!generic/manual-install-notes.md!} + This document details the steps to install MISP on Red Hat Enterprise Linux 7.x (RHEL 7.x) and CentOS 7.x. At time of this writing it was tested on versions 7.6 for both. This is a joint RHEL/CentOS install guide. The authors tried to make it contextually evident what applies to which flavor. diff --git a/docs/INSTALL.rhel8.md b/docs/INSTALL.rhel8.md index 34ff4d280..6d47df160 100644 --- a/docs/INSTALL.rhel8.md +++ b/docs/INSTALL.rhel8.md @@ -44,6 +44,8 @@ Maintenance for CentOS 8 will end on: December 31st, 2021 [Source[0]](https://wiki.centos.org/About/Product) [Source[1]](https://linuxlifecycle.com/) CentOS 8 [NetInstallURL](http://mirrorlist.centos.org/?release=8&arch=x86_64&repo=BaseOS) +{!generic/manual-install-notes.md!} + This document details the steps to install MISP on Red Hat Enterprise Linux 8.x (RHEL 8.x) and CentOS 8.x. At time of this writing it was tested on versions 8.0 for RHEL. This is a joint RHEL/CentOS install guide. The authors tried to make it contextually evident what applies to which flavor. diff --git a/docs/INSTALL.ubuntu1804.md b/docs/INSTALL.ubuntu1804.md index 7fd3791a3..d7bf1a408 100644 --- a/docs/INSTALL.ubuntu1804.md +++ b/docs/INSTALL.ubuntu1804.md @@ -1,11 +1,11 @@ # INSTALLATION INSTRUCTIONS -## for Ubuntu 18.04.4-server +## for Ubuntu 18.04.5-server ### -1/ Installer and Manual install instructions Make sure you are reading the parsed version of this Document. When in doubt [click here](https://misp.github.io/MISP/INSTALL.ubuntu1804/). -To install MISP on a fresh Ubuntu 18.04, all you need to do is the following: +To install MISP on a *fresh* Ubuntu 18.04, all you need to do is the following: ```bash # Please check the installer options first to make the best choice for your install @@ -20,12 +20,9 @@ bash /tmp/INSTALL.sh -c ### 0/ MISP Ubuntu 18.04-server install - status ------------------------- !!! notice - Installer tested working by [@SteveClement](https://twitter.com/SteveClement) on 20210324 (works with **Ubuntu 18.10/19.04** too) + Installer tested working by [@SteveClement](https://twitter.com/SteveClement) on 20210324 (works with **Ubuntu 19.04/20.04/21.04** too) -!!! notice - This document also serves as a source for the [INSTALL-misp.sh](https://github.com/MISP/MISP/blob/2.4/INSTALL/INSTALL.sh) script. - Which explains why you will see the use of shell *functions* in various steps. - Henceforth the document will also follow a more logical flow. In the sense that all the dependencies are installed first then config files are generated, etc... +{!generic/manual-install-notes.md!} !!! notice If the next line is `[!generic/core.md!]()` [click here](https://misp.github.io/MISP/INSTALL.ubuntu1804/). @@ -37,7 +34,7 @@ bash /tmp/INSTALL.sh -c #### Install a minimal Ubuntu 18.04-server system with the software: - OpenSSH server -- This guide assumes a user name of 'misp' with sudo working +- This guide assumes a user name of 'misp' with sudo working but can be overwritten by setting the environment variable: *${MISP_USER}* #### Make sure your system is up2date ```bash diff --git a/docs/INSTALL.ubuntu2004.md b/docs/INSTALL.ubuntu2004.md index 22bc00ff2..ec243d6ea 100644 --- a/docs/INSTALL.ubuntu2004.md +++ b/docs/INSTALL.ubuntu2004.md @@ -1,11 +1,11 @@ # INSTALLATION INSTRUCTIONS -## for Ubuntu 20.04-server +## for Ubuntu 20.04.2.0-server ### -1/ Installer and Manual install instructions -Make sure you are reading the parsed version of this Document. When in doubt [click here](https://misp.github.io/MISP/INSTALL.ubuntu1804/). +Make sure you are reading the parsed version of this Document. When in doubt [click here](https://misp.github.io/MISP/INSTALL.ubuntu2004/). -To install MISP on a fresh Ubuntu 20.04, all you need to do is the following: +To install MISP on a *fresh* Ubuntu 20.04, all you need to do is the following: ```bash # Please check the installer options first to make the best choice for your install @@ -20,12 +20,9 @@ bash /tmp/INSTALL.sh -c ### 0/ MISP Ubuntu 20.04-server install - status ------------------------- !!! notice - Installer tested working by [@SteveClement](https://twitter.com/SteveClement) on 20200501 + Installer tested working by [@SteveClement](https://twitter.com/SteveClement) on 20210331 -!!! notice - This document also serves as a source for the [INSTALL-misp.sh](https://github.com/MISP/MISP/blob/2.4/INSTALL/INSTALL.sh) script. - Which explains why you will see the use of shell *functions* in various steps. - Henceforth the document will also follow a more logical flow. In the sense that all the dependencies are installed first then config files are generated, etc... +{!generic/manual-install-notes.md!} !!! notice If the next line is `[!generic/core.md!]()` [click here](https://misp.github.io/MISP/INSTALL.ubuntu2004/). @@ -37,7 +34,7 @@ bash /tmp/INSTALL.sh -c #### Install a minimal Ubuntu 20.04-server system with the software: - OpenSSH server -- This guide assumes a user name of 'misp' with sudo working +- This guide assumes a user name of 'misp' with sudo working but can be overwritten by setting the environment variable: *${MISP_USER}* #### Make sure your system is up2date ```bash diff --git a/docs/generic/manual-install-notes.md b/docs/generic/manual-install-notes.md new file mode 100644 index 000000000..f7d9cd573 --- /dev/null +++ b/docs/generic/manual-install-notes.md @@ -0,0 +1,3 @@ +!!! notice + This document also serves as a source for the [INSTALL-misp.sh](https://github.com/MISP/MISP/blob/2.4/INSTALL/INSTALL.sh) script. + You will see bash-*functions* in various steps. You can either copy between the *{}*'s or copy the entire function and just run it. diff --git a/docs/generic/misp-dashboard-cake.md b/docs/generic/misp-dashboard-cake.md index d61d1f2b9..fc4ce4db4 100644 --- a/docs/generic/misp-dashboard-cake.md +++ b/docs/generic/misp-dashboard-cake.md @@ -1,3 +1,4 @@ +```bash # dashboardCAKE () { # Enable ZeroMQ for misp-dashboard @@ -19,3 +20,4 @@ dashboardCAKE () { ${SUDO_WWW} ${RUN_PHP} -- ${CAKE} Admin setSetting "Plugin.ZeroMQ_audit_notifications_enable" false } # +``` diff --git a/docs/generic/misp-modules-cake.md b/docs/generic/misp-modules-cake.md index e91c8deaa..0383bd28e 100644 --- a/docs/generic/misp-modules-cake.md +++ b/docs/generic/misp-modules-cake.md @@ -1,3 +1,4 @@ +```bash # modulesCAKE () { # Enable Enrichment, set better timeouts @@ -42,3 +43,4 @@ modulesCAKE () { ${SUDO_WWW} ${RUN_PHP} -- ${CAKE} Admin setSetting "Plugin.Export_pdfexport_enabled" true } # +``` diff --git a/docs/license.md b/docs/license.md index faa87e2f0..5644e386e 100644 --- a/docs/license.md +++ b/docs/license.md @@ -2,4 +2,4 @@ The MISP INSTALL guides are dual-licensed under [GNU Affero General Public License version 3](http://www.gnu.org/licenses/agpl-3.0.html) and [CC-BY-SA 4.0 international](https://creativecommons.org/licenses/by-sa/4.0/). -* Copyright \(C\) 2014-2018 CIRCL - Computer Incident Response Center Luxembourg +* Copyright \(C\) 2014-2021 CIRCL - Computer Incident Response Center Luxembourg