updated CHANGELOG and install related documentation

Author: bharnden

CHANGELOG.md

@@ -1,3 +1,24 @@
+## 2025-02-11 CORE 9.2.0
+
+* Installation
+    * python3.10+ now required
+    * updated various dependencies to help avoid the need to build them from source
+* Documentation
+    * docker run examples updated
+    * gRPC edit link examples corrected
+    * updated install examples
+    * updated tutorials to use absolute paths
+    * updated custom service example
+* core-daemon
+    * removed use of killall in provided services
+    * \#860 - fixed core-cli xml --start to run control network
+    * \#881 - EMANE TDMA fails to start
+    * \#888 - fixed service start validation
+    * \#902 - link deletion removing incorrect nodes
+* core-gui
+    * fixed bug when changing icons on a loaded scenario
+    * \#897 - fixed to properly exit when closing on a running session
+
 ## 2024-07-04 CORE 9.1.0
 
 * Installation

README.md

@@ -2,7 +2,7 @@
 
 CORE: Common Open Research Emulator
 
-Copyright (c)2005-2023 the Boeing Company.
+Copyright (c)2005-2025 the Boeing Company.
 
 See the LICENSE file included in this distribution.
 

docs/install.md

@@ -12,30 +12,22 @@ when installing CORE.
 ### Complete Examples
 
 For complete examples installing CORE, OSPF MDR, EMANE, and the EMANE python
-bindings, see the pages below.
+bindings, see the pages below. The distros below are targeted to align with provided
+EMANE built packages.
 
 * [Installing on Ubuntu 22.04](install_ubuntu.md)
-* [Installing on Rocky Linux 8](install_rocky.md)
+* [Installing on Rocky Linux 8.10](install_rocky.md)
 
 ### Requirements
 
 Any computer capable of running Linux should be able to run CORE. Since the physical machine will be hosting numerous
 containers, as a general rule you should select a machine having as much RAM and CPU resources as possible.
 
 * Linux Kernel v3.3+
-* Python 3.9+
+* Python 3.10+
 * iproute2 4.5+ is a requirement for bridge related commands
 * nftables compatible kernel and nft command line tool
 
-### Supported Linux Distributions
-
-Plan is to support recent Ubuntu and CentOS LTS releases.
-
-Verified:
-
-* Ubuntu - 18.04, 20.04, 22.04
-* CentOS - 7.8
-
 ### Files
 
 The following is a list of files that would be installed after installation.

docs/install_rocky.md

@@ -2,9 +2,8 @@
 
 ## Overview
 
-This helps provide an example for installation into a RHEL 8 like
-environment. Below is a detailed example for installing CORE and related tooling on a fresh
-Rocky Linux 8 install. Both of the examples below will install CORE into its
+This helps provide an example for installation into a Rocky Linux 8.10
+environment. Both of the examples below will install CORE into its
 own virtual environment located at **/opt/core/venv**. Both examples below
 also assume using **~/Documents** as the working directory.
 
@@ -16,18 +15,18 @@ the package based installation path. This will require downloading a package fro
 
 ``` shell
 # install system packages
-sudo yum -y update
-sudo yum install -y \
+sudo dnf -y update
+sudo dnf install -y \
     xterm \
     wget \
     tcpdump \
-    python39 \
-    python39-tkinter \
+    python3.12 \
+    python3.12-tkinter \
     iproute-tc
 
 # install ospf mdr
 cd ~/Documents
-sudo yum install -y \
+sudo dnf install -y \
     automake \
     gcc-c++ \
     libtool \
@@ -46,29 +45,29 @@ sudo make install
 
 # install emane
 cd ~/Documents
-EMANE_VERSION=1.5.1
+EMANE_VERSION=1.5.2
 EMANE_RELEASE=emane-${EMANE_VERSION}-release-1
 EMANE_PACKAGE=${EMANE_RELEASE}.el8.x86_64.tar.gz
 wget -q https://adjacentlink.com/downloads/emane/${EMANE_PACKAGE}
 tar xf ${EMANE_PACKAGE}
 cd ${EMANE_RELEASE}/rpms/el8/x86_64
 rm emane-spectrum-tools-*.rpm emane-model-lte*.rpm
 rm *devel*.rpm
-sudo yum install -y ./emane*.rpm ./python3-emane-${EMANE_VERSION}-1.el8.noarch.rpm
+sudo dnf install -y ./emane*.rpm ./python3-emane-${EMANE_VERSION}-1.el8.noarch.rpm
 
 # install core
 cd ~/Documents
-CORE_PACKAGE=core_9.1.0_x86_64.rpm
+CORE_PACKAGE=core_9.2.0_x86_64.rpm
 PACKAGE_URL=https://github.com/coreemu/core/releases/latest/download/${CORE_PACKAGE}
 wget -q ${PACKAGE_URL}
-PYTHON=python3.9 yum install -y ./${CORE_PACKAGE}
+PYTHON=python3.12 dnf install -y ./${CORE_PACKAGE}
 
 # install emane python bindings into CORE virtual environment
 cd ~/Documents
-sudo yum install -y dnf-plugins-core
-sudo yum config-manager --set-enabled devel
-sudo yum update -y
-sudo yum install -y \
+sudo dnf install -y dnf-plugins-core
+sudo dnf config-manager --set-enabled devel
+sudo dnf update -y
+sudo dnf install -y \
     protobuf-devel \
     libxml2-devel \
     pcre-devel \

docs/install_ubuntu.md

@@ -62,7 +62,7 @@ sudo apt-get install -y ./emane*.deb ./python3-emane_*.deb
 
 # install core
 cd ~/Documents
-CORE_PACKAGE=core_9.1.0_amd64.deb
+CORE_PACKAGE=core_9.2.0_amd64.deb
 PACKAGE_URL=https://github.com/coreemu/core/releases/latest/download/${CORE_PACKAGE}
 wget -q ${PACKAGE_URL}
 sudo apt-get install -y ./${CORE_PACKAGE}