Wiki source code of Installing Java
Last modified by colinw on 2021/09/09 20:55
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{layout}} | ||
| 2 | {{layout-section ac:type="two_right_sidebar"}} | ||
| 3 | {{layout-cell}} | ||
| 4 | iSymphony is a Java-based application. In order to run on a server, the Java Runtime Environment (JRE) must be installed first. Follow these directions to install the Oracle JRE before installing iSymphony. | ||
| 5 | |||
| 6 | {{info}} | ||
| 7 | Beginning with version 3.0 of iSymphony, Java is only required on the server running the iSymphony web application. It is no longer required on end-user workstations. | ||
| 8 | {{/info}} | ||
| 9 | |||
| 10 | == == | ||
| 11 | |||
| 12 | {{id name="installed-check"/}}Check whether a suitable JRE is installedTo determine whether a suitable JRE is already installed on a server, follow these directions: | ||
| 13 | {{/layout-cell}} | ||
| 14 | |||
| 15 | {{layout-cell}} | ||
| 16 | {{panel title="On this page:"}} | ||
| 17 | |||
| 18 | |||
| 19 | {{toc/}} | ||
| 20 | {{/panel}} | ||
| 21 | {{/layout-cell}} | ||
| 22 | {{/layout-section}} | ||
| 23 | |||
| 24 | {{layout-section ac:type="single"}} | ||
| 25 | {{layout-cell}} | ||
| 26 | 1. Open an SSH session to the server and log in. | ||
| 27 | 1. ((( | ||
| 28 | Run the following command to determine whether a JRE is installed and configured properly: | ||
| 29 | |||
| 30 | {{code}} | ||
| 31 | $JAVA_HOME/bin/java -version | ||
| 32 | {{/code}} | ||
| 33 | ))) | ||
| 34 | 1. ((( | ||
| 35 | If the above command returns something similar to the following, then move on to [[Ensuring the installed version of Java is supported>>doc:||anchor="version-check"]]: | ||
| 36 | |||
| 37 | {{code}} | ||
| 38 | java version "1.8.0_25" | ||
| 39 | Java(TM) SE Runtime Environment (build 1.8.0_25-b17) | ||
| 40 | Java HotSpot(TM) 64-Bit Server VM (build 25.25-b02, mixed mode) | ||
| 41 | {{/code}} | ||
| 42 | ))) | ||
| 43 | 1. ((( | ||
| 44 | If the above command returns something similar to the following: | ||
| 45 | |||
| 46 | {{code}} | ||
| 47 | bash: /bin/java: No such file or directory | ||
| 48 | {{/code}} | ||
| 49 | |||
| 50 | then you'll need to either install Java or correctly set your JAVA_HOME environment variable. | ||
| 51 | ))) | ||
| 52 | 1. ((( | ||
| 53 | Next, try running java directly: | ||
| 54 | |||
| 55 | {{code}} | ||
| 56 | java -version | ||
| 57 | {{/code}} | ||
| 58 | ))) | ||
| 59 | 1. If that command works (gives a version number), then you need to set the JAVA_HOME environment variable: | ||
| 60 | 11. ((( | ||
| 61 | Quick and easy way: The following single-line command will attempt to locate the correct java installation directory and set your JAVA_HOME environment variable appropriately: | ||
| 62 | |||
| 63 | {{code}} | ||
| 64 | export JAVA_HOME=$(readlink -f `which java` | sed 's#/bin/java##') && $JAVA_HOME/bin/java -version | ||
| 65 | {{/code}} | ||
| 66 | |||
| 67 | If the above command succeeds and a java version is printed out, you can continue to [[Ensuring that the installed version of Java is supported>>doc:||anchor="version-check"]]. If it fails, you'll need to carry on to [[install>>doc:||anchor="install"]]. | ||
| 68 | |||
| 69 | {{note}} | ||
| 70 | The above command will only set the JAVA_HOME environment variable for the current SSH session. If you log out of SSH and log back in, it will be cleared and you will not be able to start iSymphony. To ensure this doesn't happen, add the first part of the command (before the &&) to your ~~/.profile file. | ||
| 71 | {{/note}} | ||
| 72 | ))) | ||
| 73 | 11. The long way: If you know what path Java has been installed to, you can manually set the JAVA_HOME environment variable to that location. The value of the JAVA_HOME environement variable should be the full absolute path to the main JRE directory. This means it should have a bin/ directory, and running $JAVA_HOME/bin/java -version should work normally. | ||
| 74 | |||
| 75 | == == | ||
| 76 | |||
| 77 | {{id name="version-check"/}}Ensuring the installed version of Java is supported:To ensure the version of Java that is installed is supported by iSymphony, note the output of the command $JAVA_HOME/bin/java -version, and compare it to the requirements listed on our [[doc:Supported Platforms]] page. In particular, note the following: | ||
| 78 | |||
| 79 | * iSymphony requires Java version 6 or higher. This will appear as the version "1.6.X_X" in the output. | ||
| 80 | * iSymphony requires the Sun/Oracle JRE. You can identify the Sun/Oracle JRE by the text "Java Hotspot(TM) in the output of the version command. | ||
| 81 | |||
| 82 | If the version of Java that is installed does not meet the requirements, you'll need to installed a supported version. | ||
| 83 | |||
| 84 | == == | ||
| 85 | |||
| 86 | {{id name="install"/}}Installing JavaDetailed instructions for installing the Oracle JRE on many platforms are available on [[Oracle's website>>url:https://www.java.com/en/download/help/linux_install.xml||shape="rect"]]. Consider two notes when selecting which version and platform to download: | ||
| 87 | |||
| 88 | 1. iSymphony supports both 32-bit and 64-bit JREs. We typically recommend installing the 64 bit JRE, since it provides the ability to run applications in either 32 bit or 64 bit mode. | ||
| 89 | 1. iSymphony will run on any JRE version 6 or higher. We typically recommend using the latest available release, since it will be supported by Oracle longer and require less drastic updates when support for an older version is ended. | ||
| 90 | |||
| 91 | After installing the Oracle JRE, you may need to log out and log back into the server to get the new value for the JAVA_HOME environment variable. You can use the same command as above ($JAVA_HOME/bin/java -version) to check whether it has been installed properly. | ||
| 92 | {{/layout-cell}} | ||
| 93 | {{/layout-section}} | ||
| 94 | {{/layout}} |