Difference between revisions of "Java JRE install and troubleshooting/en"

From TaticView
Jump to: navigation, search
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(3 intermediate revisions by the same user not shown)
Line 6: Line 6:
  
  
O [[TVCli]] (utilitário de linha de comando do TaticView), necessita que a estação/servidor tenha o JAVA disponível para sua execução.
+
The [[TVCli]] (TaticView command line utility), needs JAVA to be available in station where it will be executed.
  
A versão mínima necessária é a versão 8u101.
+
The minor JAVA version supported is 8u101.
  
Como boa prática, recomendamos sempre ter a atualização mais recente da versão 8 instalada, por que estas atualizações trazem várias correções de segurança.
+
As good practice, we recommend you maintain the JAVA installed updated to last updates available for version 8, because they include security corrections.
  
Podem ser usados os dois empacotamentos disponíveis, tanto o JRE quanto o JDK.
+
You can use either JRE or JDK packages.
  
== Obtendo uma versão atualizada do JAVA ==
+
== Getting a updated JAVA version ==
  
Como o JAVA é uma linguagem open source, existem vários locais onde podemos obtê-la, alguns destes inclusive exigem uma assinatura anual para poder usá-la comercialmente.
+
JAVA is an open source language, and therefore there are a lot of different sites, some of them you may need to pay a subscription to use it on business applications.
  
Por isso é importante ler os termos de uso.
+
So, it's very important to read the license before use it.
  
Sugerimos usar a compilação mantida pela [https://www.eclipse.org/org Eclipse Foundation], que tem boa qualidade, é mantida e atualizada, e é livre, por tanto, não tem problemas de licenciamento.
+
We suggest you to use a build maintained by [https://www.eclipse.org/org Eclipse Foundation], witch maintain a good quality and updates security patches, and it's free for business use.
  
O JAVA mantido pela [https://www.eclipse.org/org Eclipse Foundation] chama-se [https://adoptium.net/about.html Adoptium].
+
The JAVA maintained by [https://www.eclipse.org/org Eclipse Foundation] is the  [https://adoptium.net/about.html Adoptium].
  
Portanto, [https://adoptium.net/ baixe o JAVA versão 8 atualizada] da Eclipse Foundation.
+
[[File:Filesave.png]]
 +
[https://adoptium.net/ DOWNLOAD JAVA 8 updated version] from Eclipse Foundation.  
  
A instalação é simples, basta seguir o wizard.
+
And install it, it's very simple using the install wizard.
  
== Instalador do TVCli não encontrou o JAVA ?==
+
== TVCli installer didn't found JAVA ?==
  
É possível que mesmo com o JAVA presente (instalado) na estação/servidor o instalador do TVCli não consiga detectá-lo.
+
It is possible the even with JAVA installed on the station, the TVCli installer can't find it.
  
O Instalador ''procura'' a pasta onde o JAVA está instalado, em duas [https://pt.wikipedia.org/wiki/Vari%C3%A1vel_de_ambiente variáveis de ambiente]:  
+
The installer search the folder where JAVA is installed, by reading two [https://en.wikipedia.org/wiki/Environment_variable environment variables]:  
* No [https://en.wikipedia.org/wiki/PATH_(variable)#DOS,_OS/2,_and_Windows ''PATH'' do sistema operacional]  
+
* At ''JAVA_HOME'' environment variable
* Na variável de ambiente ''JAVA_HOME''
+
* At Windows [https://en.wikipedia.org/wiki/PATH_(variable)#DOS,_OS/2,_and_Windows ''PATH'']  
Caso o JAVA não esteja mapeado em nenhuma destas variáveis o instalador aborta a instalação e mostra a seguinte tela.
+
In cases where JAVA isn't mapped in any of these variables, the installer aborts the installation and shows the following screen.
  
 
[[File:Java_not_found_by_installer.png]]
 
[[File:Java_not_found_by_installer.png]]
  
A seguir, vamos ajudá-lo a configurar a variável de ambiente ''PATH'' para solucionar este problema.
+
Next, we'll help you set the ''PATH'' environment variable to solve this problem.
  
=== Configurando o ''PATH'' no Windows ===
+
=== Configuring Windows ''PATH'' ===
  
O primeiro passo é localizar a pasta onde o JAVA está instalado na estação. Isso pode ser feito procurando por ''java.exe'' nas pastas da máquina, caso vc tenha mais de um JAVA na estação o ideal é usar a atualização mais recente da o da versão 8.
+
The first step is to locate the folder where JAVA is installed on the workstation. This can be done by looking for ''java.exe'' in the machine's folders, if you have more than one JAVA on the workstation, the ideal is to use the latest update from version 8.
  
O segundo passo é configurar a varável de ambinte, para que ela ''aponte'' para o diretório localizado no primeiro passo.
+
The second step is to configure the environment variable so that it ''points'' to the directory located in the first step.
# No menu Iniciar do Windows, clique em Painel de Controle.
+
# From the Windows Start menu, click Control Panel.
# No Painel de Controle, clique duas vezes em Sistema.
+
# In Control Panel, double-click System.
# Na caixa de diálogo Propriedades do Sistema, clique na guia Avançado e clique em Variáveis de Ambiente.
+
# In the System Properties dialog, click the Advanced tab and click Environment Variables.
# Na caixa de diálogo Variáveis de Ambiente, no quadro Variáveis do sistema, selecione a entrada ''Path''.
+
# In the Environment Variables dialog, in the System Variables frame, select the ''Path'' entry.
 +
# Edit button
 +
# Check if there is already an entry pointing to some old JAVA directory, if so, remove it.
 +
# New button
 +
# Enter the path to the JAVA ''bin'' directory (where the ''java.exe'' file is)
 +
# OK button
 +
# Rerun the installer
  
 +
== Error UnsupportedClassVersionError when running TVCli ==
  
    On the Start menu, click Control Panel.
+
The '''UnsupportedClassVersionError''' happens because the Java version in use isn't correct.
    In Control Panel, double-click System.
 
    In the System Properties dialog box, click the Advanced tab, and then click Environment Variables.
 
    In the Environment Variables dialog box, in the System variables frame, select the ''Path'' entry.
 
  
 +
Bellow a complete sample of the error output
 +
<pre>
 +
Exception in thread "main" java.lang.UnsupportedClassVersionError: com/sadig/taticview/cli/Main : Unsupported major.minor version 52.0
 +
        at java.lang.ClassLoader.defineClass1(Native Method)
 +
        at java.lang.ClassLoader.defineClass(ClassLoader.java:800)
 +
        at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
 +
        at java.net.URLClassLoader.defineClass(URLClassLoader.java:449)
 +
        at java.net.URLClassLoader.access$100(URLClassLoader.java:71)
 +
        at java.net.URLClassLoader$1.run(URLClassLoader.java:361)
 +
        at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
 +
        at java.security.AccessController.doPrivileged(Native Method)
 +
        at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
 +
        at java.lang.ClassLoader.loadClass(ClassLoader.java:425)
 +
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
 +
        at java.lang.ClassLoader.loadClass(ClassLoader.java:358)
 +
        at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:482)
 +
</pre>
 +
The Java used during TVCli execution is indicated by Windows [https://en.wikipedia.org/wiki/PATH_(variable)#DOS,_OS/2,_and_Windows ''PATH''] variable.
  
# Botão Editar
+
To determine witch version of Java is pointed by PATH variable you can use the JAVA ''-version'' parameter, we will show you bellow.
# Verifique se já existe uma entrada apontando para algum diretório antigo do JAVA, se sim, remova.
+
# Open [https://en.wikipedia.org/wiki/Windows_Console Windows Command Console]
# Botão Novo
+
# Execute java asking for his version:  '''''java -version'''''
# Digite o caminho para diretório BIN do JAVA (onde está o arquivo ''java.exe'')
 
# Botão OK
 
# Reexecute o instalador
 
  
== Mais dúvidas ? ==
+
The ''-version'' parameter should output something like bellow for Java version 8
 +
<pre>
 +
C:\>java -version
 +
openjdk version "1.8.0_282"
 +
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_282-b08)
 +
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.282-b08, mixed mode)
 +
</pre>
  
Caso ainda tenha dúvidas fale com nosso [https://support.taticview.com/ Suporte], podemos lhe ajudar no que for necessário.
+
If Java version is bellow 8 the ''UnsupportedClassVersionError'' is thrown. You need to install a newer version, or if a newer version is already installed, you need to [[#Configuring_Windows_PATH|correct de Windows PATH]] variable to point to newest Java.
 +
 
 +
== More doubts ? ==
 +
 
 +
If you still have questions, talk to us through [https://support.taticview.com support], we can help you with whatever you need.

Latest revision as of 14:53, 5 October 2022

Other languages:


JAVA JRE install and troubleshooting

The TVCli (TaticView command line utility), needs JAVA to be available in station where it will be executed.

The minor JAVA version supported is 8u101.

As good practice, we recommend you maintain the JAVA installed updated to last updates available for version 8, because they include security corrections.

You can use either JRE or JDK packages.

Getting a updated JAVA version

JAVA is an open source language, and therefore there are a lot of different sites, some of them you may need to pay a subscription to use it on business applications.

So, it's very important to read the license before use it.

We suggest you to use a build maintained by Eclipse Foundation, witch maintain a good quality and updates security patches, and it's free for business use.

The JAVA maintained by Eclipse Foundation is the Adoptium.

Filesave.png DOWNLOAD JAVA 8 updated version from Eclipse Foundation.

And install it, it's very simple using the install wizard.

TVCli installer didn't found JAVA ?

It is possible the even with JAVA installed on the station, the TVCli installer can't find it.

The installer search the folder where JAVA is installed, by reading two environment variables:

  • At JAVA_HOME environment variable
  • At Windows PATH

In cases where JAVA isn't mapped in any of these variables, the installer aborts the installation and shows the following screen.

Java not found by installer.png

Next, we'll help you set the PATH environment variable to solve this problem.

Configuring Windows PATH

The first step is to locate the folder where JAVA is installed on the workstation. This can be done by looking for java.exe in the machine's folders, if you have more than one JAVA on the workstation, the ideal is to use the latest update from version 8.

The second step is to configure the environment variable so that it points to the directory located in the first step.

  1. From the Windows Start menu, click Control Panel.
  2. In Control Panel, double-click System.
  3. In the System Properties dialog, click the Advanced tab and click Environment Variables.
  4. In the Environment Variables dialog, in the System Variables frame, select the Path entry.
  5. Edit button
  6. Check if there is already an entry pointing to some old JAVA directory, if so, remove it.
  7. New button
  8. Enter the path to the JAVA bin directory (where the java.exe file is)
  9. OK button
  10. Rerun the installer

Error UnsupportedClassVersionError when running TVCli

The UnsupportedClassVersionError happens because the Java version in use isn't correct.

Bellow a complete sample of the error output

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/sadig/taticview/cli/Main : Unsupported major.minor version 52.0
        at java.lang.ClassLoader.defineClass1(Native Method)
        at java.lang.ClassLoader.defineClass(ClassLoader.java:800)
        at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
        at java.net.URLClassLoader.defineClass(URLClassLoader.java:449)
        at java.net.URLClassLoader.access$100(URLClassLoader.java:71)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:361)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
        at java.security.AccessController.doPrivileged(Native Method)
        at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:425)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:358)
        at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:482)

The Java used during TVCli execution is indicated by Windows PATH variable.

To determine witch version of Java is pointed by PATH variable you can use the JAVA -version parameter, we will show you bellow.

  1. Open Windows Command Console
  2. Execute java asking for his version: java -version

The -version parameter should output something like bellow for Java version 8

C:\>java -version
openjdk version "1.8.0_282"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_282-b08)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.282-b08, mixed mode)

If Java version is bellow 8 the UnsupportedClassVersionError is thrown. You need to install a newer version, or if a newer version is already installed, you need to correct de Windows PATH variable to point to newest Java.

More doubts ?

If you still have questions, talk to us through support, we can help you with whatever you need.