Introduction to NetWorker Runtime Environment (NRE)
The NetWorker server, NetWorker Management Console (NMC) server, and NetWorker Management Web UI (NWUI) server rely on a Java Runtime Environment (JRE) to operate. JRE must be installed on the NetWorker server, NMC server, NWUI server, and any host used to access the NMC.
As of January 1, 2019, Oracle no longer supports or updates Java Runtime Environment (JRE) 8 unless users have a license agreement with Oracle. To provide support and access to Java security updates, Dell Technologies worked with Oracle to integrate JVM/JRE with Dell Technologies Data Protection (DP) products. The NetWorker specific Java package is called NetWorker Runtime Environment (NRE). JRE licensed directly from Oracle may still be used.
NOTE: Keep NRE up to date as this updates the embedded JRE package.
Existing NetWorker users that want to use NRE should reference the NetWorker Runtime Edition Readme Guide. The NetWorker Installation Guide and NetWorker Release Notes provide additional information.
These documents are available at: https://www.dell.com/support/home/product-support/product/networker/docs
NRE Software
NetWorker Runtime Environment (NRE) provides an installer package to deliver:
1. A current Java Runtime Environment (JRE) compatible with NetWorker
2. A Java application to launch the NMC Web UI.
NRE Supported Platforms:
The package is available for 64-bit Windows, 64-bit Linux, and MAC Operating System.
NRE Software Versions:
NetWorker Runtime Environment uses the following naming convention:
NRE x.y.z
Where:
X is the major JRE version.
Y and z are Dell-assigned version numbers.
Hence, the starting version of NRE is 8.0.1 as NRE provides Java 8.
The Java version provided with NRE does not correspond to specific JRE updates.
New NRE versions are released with JRE updates as necessary.
New versions of NRE are posted in the NetWorker downloads section and are noted in NetWorker Release Notes and monthly NetWorker Newsletters.
Installing NRE on Windows platforms
1. Download the NRE software package from the Online Support website to a temporary location.
2. In the directory that contains the downloaded NRE package, run the nrewin-x.y.z.msi installer (for example nrewin-8.0.1.msi).
3. In the Welcome Wizard page, click Next.
4. In the EULA page, tick "I agree to the license terms and agreements," and click Next.
5. To accept the default installation location C:\Program Files\NRE, click Next.
Optional: Tick the checkbox to create a shortcut for NetWorker Runtime Environment launcher on the desktop.
6. To proceed with the installation, click Install.
7. To complete the installation, click Finish.
Uninstalling NRE on Windows platforms
1. From the Control Panel, select Program and Features.
2. On the Program and Features window, select "NetWorker Runtime Environment."
3. Click Uninstall.
4. Click Yes on the warning message to complete the uninstallation.
Installing NRE on Linux platforms:
1. Connect to the host with the root account.
2. Download the NRE package from the online support website to a temporary location.
3. To install the NetWorker Runtime Environment software, run one of the following commands:
CentOS, Oracle Enterprise Linux, SuSE, Red Hat:
rpm -ivh nre-linux-x.y.z.rpm
Example:
rpm -ivh nre-linux-8.0.1.rpm
Debian and Ubuntu:
dpkg -i nre-linux-x.y.z.deb
Example:
dpkg -i nre-linux-8.0.21.deb
The message "NOTE: To complete configuration, run the following script: /opt/nre/nreconfig.sh" is displayed:
root@system NRE]# rpm -ivh nre-linux-8.0.1.rpm
Installation of NRE
warning: nre-linux-8.0-20190427.021533-23.rpm: Header V3 RSA/SHA1 signature: NOKEY, key ID 1234dfb7
Preparing...
########################################### [100%]
1:nre
########################################### [100%]
NOTE: To complete configuration execute the following script :/opt/nre/nreconfig.sh
4. To configure NRE, run the
nreconfig.sh script.
[root@system NRE]# /opt/nre/nreconfig.sh
Running the script after installation
Creating the installation log in /opt/nre/logs/install.log.
Performing initialization. Please wait...
nre configuration completed.
NOTE: The nreconfig.sh script generates the installation log file and places a shortcut to the NMC Launcher on the desktop.
Uninstalling NRE on Linux Platforms
1. Connect to the host with the root account.
2. Get the name of the installed NRE package:
CentOS, Oracle Enterprise Linux, SuSE, Red Hat:
rpm -qa | grep nre
Debian and Ubuntu:
dpkg -l | grep nre
3. Remove NRE package returned by the above command using the
rpm -e command, run:
CentOS, Oracle Enterprise Linux, SuSE, Red Hat:
rpm -e nre_package_name
Debian and Ubuntu:
dpkg -r nre_package_name
Installing NetWorker Runtime Environment on MAC Operating System
1. Connect to the host with the root account.
2. Download the NetWorker Runtime Environment software package from the online support website to a temporary location.
3. To install the NetWorker Runtime Environment software, open the software package and then run through the installation wizard.
4. When the installation is complete, click Close.
Uninstalling NetWorker Runtime Environment on MAC Operating System
1. Go to the NetWorker Runtime Environment installation directory.
2. Run the uninstall application file.
Launching NMC Web UI
1. Run the NMC Launcher Java application.
2. Choose one of the following options to launch the NMC Web UI:
a. Select the "Connect to NMC Server" option. Type the IP address, hostname, or FQDN of the NMC server in the "Enter NMC Server IP/Hostname" field, and type the port number in the "Enter Port No" (Default 9000) field:
b. To launch NMC Web UI from Data Protection Central (DPC), select "Browse JNLP file" option and click Browse to locate the gconsole.jnlp file:
3. Click Connect to launch the NMC Web UI.
Troubleshooting
Changes to the Java cache and the Java console can be enabled using the Java Control Panel.
Java control panel path for the Linux NRE JAVA:
/opt/nre/latest/bin/jcontrol (Default)
Java control panel path for the Windows NRE JAVA:
<installation path>\NRE\jre1.8.0_xxx\bin\javacpl.exe
The default <installation path>on Windows is C:\Program Files\. The xxx represents the installation version.
NRE: How to clear Java Cache, enable Java Console and Debugging.
NRE Launcher log files are located at:
<installation path>/nre/logs/launcherLogs.log (LINUX)
<installation path>\NRE\logs\launcherLogs.log (Windows)