Common Error Messages
- java.io.FileNotFoundException
- Could not find or load main class com.wowza.updatetool.bootstrap.UpdateBootstrap
Note!
Wowza Streaming Engine 4.8.18 is built on Java 11 (OpenJDK Java SE JRE 11.0.2), but can be used with Java versions 11 - 12.
You must have Java version 11 installed before running the updater for 4.8.18.
[Engine versions prior to 4.8.18 are built on Java 9, but can be configured for Java 9-11.]
Troubleshooting:
1. Determine which version of Java your Wowza Streaming Engine instance is using.
- In Wowza Streaming Engine Manager, click Server in the menu bar and then click About in the contents panel.
- The About Wowza Streaming Engine page displays the Java Version, Java VM Version, Java Architecture, and other details about the Java version that's in use.
2. If Streaming Engine is not using the correct version of Java, you must install the correct version of Java before running the Streaming Engine updater.
- Updaters for Wowza Streaming Engine 4.8.5 and later do not install the custom packaged version of OpenJDK Java SE JRE or the java.scripting module.
- If you are updating to Wowza Streaming Engine 4.8.18 from a base installation of Wowza Streaming Engine 4.8.17 or earlier, before you update, you need to install a supported version of Java, such as Java 11-12 or the OpenJDK Java SE JRE 11.0.2 installed with Wowza Streaming Engine 4.8.18 (available from the Downloads tab of My Account). Then instruct Wowza Streaming Engine to use that version of Java according to the instructions in Manually install and troubleshoot Java on Wowza Streaming Engine.
3. After installing the correct Java environment, then confirm Engine is running the correct version. Repeat Step 1 from above and verify which version Engine is using.
4. If Wowza Streaming Engine isn't using the correct version of Java, point it to the version you installed.
- Please follow the steps for your OS and point Engine to the version of Java you are using. Instructions for Windows, macOS and Linux can be found here: https://www.wowza.com/docs/manually-install-and-troubleshoot-java-on-wowza-streaming-engine#instruct-wowza-streaming-engine-to-use-a-specific-version-of-java
5. Instruct Wowza Streaming Engine to use the Java "en" locale.
- Wowza Streaming Engine may not start or may not run after starting when the Java environment points to certain locales, such as Turkish.
- To address this problem, instruct Wowza Streaming Engine to run under the "en" locale by editing the VMOption variable in the Tune.xml file.
- Open [install-dir]/conf/Tune.xml in a text editor and find the following line:
<!-- <VMOption>-Duser.language=en -Duser.country=US -Dfile.encoding=Cp1252</VMOption> -->
- Uncomment the line by removing the <!-- from the beginning of the line and the --> from the end of the line, as follows:
<VMOption>-Duser.language=en -Duser.country=US -Dfile.encoding=Cp1252</VMOption>
- Save your changes and restart Wowza Streaming Engine.
- Confirm that the settings have taken effect by opening the latest access log at [install-dir]/logs/wowzastreamingengine_access.log.YYYY-MM-DD and looking for following entries:
INFO server comment - Java Locale[user.language]: en
INFO server comment - Java Locale[user.country]: US
INFO server comment - Java Locale[user.variant]: INFO server comment - Java Locale[file.encoding]: Cp1252
Manually install and troubleshoot Java on Wowza Streaming Engine