diff --git a/doc/deployment/Creating-a-release.md b/doc/deployment/Creating-a-release.md index 64bf74256..03889ba8e 100644 --- a/doc/deployment/Creating-a-release.md +++ b/doc/deployment/Creating-a-release.md @@ -60,6 +60,8 @@ is recent enough to include the most recent changes in the 1. Do the same for the `EPICS32` 32-bit build, replacing `EPICS` with `EPICS32` everywhere in the commands above. 1. Check release is now listed in [`https://control-svcs.isis.cclrc.ac.uk/git/?a=project_list;pf=releases`](https://control-svcs.isis.cclrc.ac.uk/git/?a=project_list;pf=releases) +1. Run the [`instrument_deploy.yaml` ansible playbook](https://github.com/ISISComputingGroup/ansible-playbooks/tree/main?tab=readme-ov-file#instrument_deployyaml) which currently installs the JDK on instruments. + {#creating_release_testing_steps} ### Testing diff --git a/doc/overview/First-Time-Build.md b/doc/overview/First-Time-Build.md index 8391a9243..fa0f9efab 100644 --- a/doc/overview/First-Time-Build.md +++ b/doc/overview/First-Time-Build.md @@ -19,14 +19,12 @@ See [Install Visual Studio](/iocs/compiling/Install-Visual-Studio) {#first_time_install_java} ## Install Java JDK -Install **OpenJDK 21 hotspot** from https://adoptium.net/?variant=openjdk21&jvmVariant=hotspot (the MSI installer is fine, tick all the boxes when it asks you which components to install) +Install the **OpenJDK 25 hotspot** binary zip from https://adoptium.net and extract to `\instrument\apps\JDK\25` ```{important} **Do not install an Oracle JDK**. It has an unsuitable license. ``` -You may wish to install some optional java components [as detailed here](#developer_upgrade_java). - {#first_time_install_maven} ## Install Maven diff --git a/doc/processes/dev_processes/Dependency-Updates.md b/doc/processes/dev_processes/Dependency-Updates.md index c8d4a2a70..2d31c64e4 100644 --- a/doc/processes/dev_processes/Dependency-Updates.md +++ b/doc/processes/dev_processes/Dependency-Updates.md @@ -138,16 +138,16 @@ In `create_icp_binaries.bat`, update the unpacked version of MySQL used during t In `c:\instrument\apps\epics\support\mysql\master\MySQLCppApp\src\mysql-connector-c++`, update the vendor submodule to a recent version, then rebuild `mysql`, `pvdump`, and then all IOCs, in that order. ### Java -- Get the latest AdoptOpen JDK msi file from `https://adoptium.net/releases.html?jvmVariant=hotspot` and put it in `\\isis\shares\ISIS_Experiment_Controls_Public\third_party_installers\latest_versions`. +- Get the latest AdoptOpen JDK zip file from `https://adoptium.net/releases.html?jvmVariant=hotspot` and put it in `C:\instrument\apps\JDK\\`. * Only upgrade major versions to another LTS version. -- Copy the older version onto the `\\isis\shares\ISIS_Experiment_Controls_Public\third_party_installers\old_versions`. -- Uninstall the older version from control Panel and install the new version. +- Uninstall the older version from control Panel, remove any references from the `PATH` environment variable. - Test that running `start_ibex_server.bat` completes successfully, and ensure there are no obvious errors in the IOC log files for: * ARBLOCK * ARINST * ALARM * IOCLOG - Check that CS Studio IDE is loaded correctly +- Update the Ansible playbook with the new version as per [these instructions](https://github.com/ISISComputingGroup/ansible-playbooks/tree/main?tab=readme-ov-file#updating-jdk-version). ### Maven - There are two versions of maven, this is to update the one following the format `maven-X.x.x`