Install JRE

casp104
 
 
The OneClick Console and OneClick add-on applications require Java Runtime Environment (JRE). JRE includes the Java Web Start client, which is required to run Java Network Launching Protocol (JNLP) applications like OneClick.
You must perform the steps recommended in this topic on the 
DX NetOps Spectrum
 client side.
After you install JRE, you can start OneClick.
We support only AdoptOpenJDK JRE (8u232). You can, however, use your corporate license with Oracle to run the Oracle JRE and launch the 
DX NetOps Spectrum
 Web Start. 
Prerequisites to Install JRE and Java Web Start
To run the OneClick Console on your Windows system, install JRE and Java Web Start. Confirm the following prerequisites before proceeding:
  • You have the correct URL for the OneClick web server system.
  • You can access the OneClick web server system using HTTP on a web browser.
  • Your account allows you to log in to the OneClick web server.
  • You have downloaded JRE from AdoptOpenJDK/licensed Oracle JRE, which supports Java Web Start.
Install AdoptOpenJDK JRE with Java Web Start on Windows
To run the OneClick Console on your Windows system, install the AdoptOpenJDK JRE and Java Web Start.
Follow these steps:
  1. Log in to your Windows system.
  2. Open the OneClick home page in a browser using the URL that your administrator provided. The URL has the following format:
     http://hostname:portnumber/
    Hostname is the name of the OneClick web server. Use portnumber only if the OneClick web server does not use the default port 80. If you cannot access the OneClick web server, notify your administrator.
  3. Enter your OneClick login credentials, if prompted. The OneClick home page opens.
  4. Navigate to the Install JRE page.
  5. Download and launch the installer.
  6. Read and accept the license.
  7. On the Custom Setup screen, select the features that you want to install.
  8. (Optional) Change the default installation directory.
  9. Click the directory tree with (x) checkmark to select the following additional features.
    • Set JAVA_HOME variable
    • IcedTea-Web
    These features are installed on the local drive.
  10. Click Next.
  11. Click Install.
  12. When the installation completes, click Finish to close the program.
Associate .jnlp Files with Java Web Start
The file that launches OneClick is a JNLP file. Verify that the .jnlp file extension is mapped to the javaws.exe application.
Follow these steps:
  1. Open Windows Explorer.
  2. Select Tools, Folder Options. The Folder Options dialog opens.
  3. Select the File Types tab. A list of registered file types is displayed.
  4. Scroll down and select JNLP. The bottom portion of the dialog displays Details for the ‘JNLP’ extension.
  5. Verify that the details for the ‘JNLP’ extension box indicate the following information:
    • For Windows 2000/2003:
       The file opens with javaws.
    • For Windows XP: 
      The file
       
      opens with Java Web Start Launcher.
    If JNLP files are not set as described, you can manually map the .jnlp extension to the javaws.exe application.
  6. Select Change in the Details for ‘JNLP’ extension box. The Open With dialog opens.
  7. Scroll down and select ‘javaws’ or ‘JavaTM Web Start Launcher’ and select OK.
  8. Select OK in Folder Options.
  9. Exit Windows Explorer. The .jnlp file extension is now mapped to the Java Web Start application and can launch the OneClick Console.
Install JRE and Java Web Start on Linux
To run the OneClick Console on your Linux system, install JRE and Java Web Start. On Linux platforms, Oracle no longer provides self-extracting installers. Instead, they provide a tarball that contains the JRE binaries, but does not set any environment variables. To run the OneClick client on Linux, you can download the JRE from the OneClick web page and can associate the .jnlp file type with the Java Web Start application, javaws, using the Mozilla Firefox web browser.
Follow these steps:
  1. Log in to your Linux system.
  2. Open the OneClick home page in a web browser by using the URL that your administrator provided. The URL has the following format:
     http://<hostname>:<portnumber>/
    <
    hostname
    > is the name of the OneClick web server. Use <portnumber> only if the OneClick web server does not use the default of port 8080. If you cannot access the OneClick web server, notify your administrator.
  3. Enter your OneClick login credentials, if prompted. The OneClick home page opens.
  4. Download the JRE (tar.gz) from the OneClick Administration page and save the tar.gz file.
  5. Open a terminal session (bash shell or kshell) and execute the following command to extract the binaries:
    tar -zxvf file_name
  6. After extraction, execute the following commands to set the environment variables:
    export JAVA_HOME=Path_of_Extracted_Folderexport PATH=$PATH:$JAVA_HOME/bin
    where “Path_of_Extracted_Folders” corresponds to the location of the binaries after you have extracted them.
  7. Associate the .jnlp file type with the Java Web Start application for the OneClick Console to launch:
    1. Select Start Console in Firefox.
    2. Select Open with and select javaws, in the JRE directory (<
      JRE
      >/bin/javaws).
    3. Select OK.
    The .jnlp file type is now associated with Java Web Start.
 
Launch 32- or 64-Bit Java Console when Both 32- and 64-Bit Java are Installed on a Client Machine
If you want to force 64-bit or 32-bit OC client, replace <resources> tag with one that specifies an architecture - "amd64" for x64 and "x86" for x32, see the following examples.
You can copy oneclick.jnlp to oneclick32.jnlp or oneclick64.jnlp, and can customize platform and memory, and then new launch points are added automatically to the OC admin page.
For arch specifiers to work properly, you must exactly match the JRE version or ensure the "Allow new versions" checkbox is checked in the supported JRE version configuration.
 
Modify the following values in the oneclick.jnlp file:
 
  • For 32-bit - oneclick32.jnlp:
  <resources arch="x86"> for x32
<j2se version="1.8.0_112" href="http://java.sun.com/products/autodl/j2se"
initial-heap-size="96m" max-heap-size="
512m
"/>
  • For 64-bit - oneclick64.jnlp:
<resources arch="amd64"> for x64
<j2se version="1.8.0_112" href="http://java.sun.com/products/autodl/j2se"
Initial-heap-size="96m" max-heap-size="
1024m
"/>
 
Follow these steps:
 
  1. Navigate to: 
    $SPECROOT/tomcat/webapps/spectrum/oneclick.jnlp
     
  2. Copy the oneclick.jnlp to oneclick32.jnlp or oneclick64.jnlp in the same location.
  3. Navigate to the 
    DX NetOps Spectrum
     OneClick Web Server home page to launch the OneClick console. 
  4. Do one of the followings:
  • Select x32 to launch a 32-bit OneClick client
  • Select x64 to launch a 64-bit OneClick client