Upgrade Instructions

The CWMS Server and Database Software and their configurations are usually the responsibility of your CWMS Administrator and the notes provided in the following section were prepared for them. The update to CWMS 3.4 incorporates a new certificate and trust store configuration as well as Java 11 integration. Java 11 has already been placed on the servers and is integrated into the 3.4 server files. The certificate and trust store configuration need your attention before updating to CWMS 3.4.


**************ATTENTION PLEASE COMPLETE BEFORE UPDATING TO CWMS 3.4 SERVERS*************************************

  • CWMS 3.4 uses both RMI over TLS and HTTPS for communications. As such a server certificate and trust store must be provided. This involves steps that both the district and HEC need to complete. This will need to be completed on both COOP and Primary servers.  Instructions on setting up the certificate and trust store are provided here : PKI v3.4
  • The Datastreams are now utilizing python 3. In order to use datastreams in CWMS 3.4 you must update your python 3 link to the new python build (v3.9.18-Solaris11.4.65.157)
  • CWMS 3.4 requires a new database schema to use the new measurements features as well as fixes to Time series and Location groups. Your office must update to the latest schema BEFORE updating to CWMS 3.4. The latest schema is 24.12.4. If you have not updated or are unsure if you are on the correct schema contact Kat Feingold.

*********************************************************************************************************************************


After the above steps are complete, you can update your servers to 3.4:

  1. Log into your server as the 'cwp' user or 'cwt' user (if you are using test account)

  2. StopCWMS/CWP (if wish to be thorough can follow-up with 'ps -ef | grep java' and verify no CWMS processes remain)

  3. cd /wm/yyy/localsoft (where 'yyy' is your 3-letter District code)

  4. remove existing cwms link
  5. rm cwms
  6. ln -sf /wm/wmsoft/cwms/v3.4.0.241219 cwms
  7. **** Before running bootCWMS and after changing the link run the following to load the new java11 build.
    1. source .bashrc
    2. java -version
      1. confim that you see (build build 11.0.18+9-LTS-195) as the java version.  If you see 1.8.0_202-b08 contact HEC
  8. BootCWMS/CWP
  9. checkServers


DataStreams:

Datasteam processes are now running off of python 3.  please update your python 3 link to the new python build (v3.9.18-Solaris11.4.65.157)



The status of issues since the CWMS 3.3.1 release can be found here. 

The known issues as of the CWMS 3.4 release can be found here.