networker runtime environment readme guide...before you start the networker installation or upgrade,...

Dell EMCVersion

NetWorker Runtime Environment Readme Guide302-005-858

02

Copyright © 2019 Dell Inc. or its subsidiaries. All rights reserved.

Published June 2019

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND

WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED

IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

Published in the USA.

Dell EMCHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.DellEMC.com

2 Dell EMC NetWorker Runtime Environment Readme Guide

5

Preface 7

Introduction 13Overview.....................................................................................................14Installation Package.................................................................................... 14Java Requirements for NetWorker ............................................................. 14

NetWorker Runtime Environment on Windows 15Installing NetWorker Runtime Environment on Windows............................ 16Uninstalling NetWorker Runtime Environment on Windows ....................... 16

NetWorker Runtime Environment on Linux 17Installing NetWorker Runtime Environment on Linux.................................. 18Uninstalling NetWorker Runtime Environment on Linux.............................. 19

Launching NMC Application 21Launching NMC..........................................................................................22

Troubleshooting 23Enabling Java Console and Clearing Cache.................................................24NRE Log files..............................................................................................24

Tables

Chapter 1

Chapter 2

Chapter 3

Chapter 4

Chapter 5

CONTENTS

Dell EMC NetWorker Runtime Environment Readme Guide 3

CONTENTS


Revision history............................................................................................................ 7Style conventions......................................................................................................... 9Package name............................................................................................................. 14

123

TABLES

Dell EMC NetWorker Runtime Environment Readme Guide 5

TABLES


Preface

As part of an effort to improve product lines, periodic revisions of software andhardware are released. Therefore, all versions of the software or hardware currently inuse might not support some functions that are described in this document. Theproduct release notes provide the most up-to-date information on product features.

If a product does not function correctly or does not function as described in thisdocument, contact a technical support professional.

Note

This document was accurate at publication time. To ensure that you are using thelatest version of this document, go to the Support website https://www.dell.com/support.

PurposeThis document describes how to install, update and remove the NetWorker RuntimeEnvironment.

AudienceThis document is part of the NetWorker documentation set and is intended for use bysystem administrators during the installation and setup of the NetWorker software.

Revision historyThe following table presents the revision history of this document.

Table 1 Revision history

Revision Date Description

02 June 03, 2019 Removed a note from the topic Installing NetWorkerRuntime Environment on Linux.

01 May 20, 2019 First release of this document for 8.0.1 release .

Related documentationThe NetWorker documentation set includes the following publications, available on theSupport website:

l NetWorker E-LAB NavigatorProvides compatibility information, including specific software and hardwareconfigurations that NetWorker supports. To access E-LAB Navigator, go to https://elabnavigator.emc.com/eln/elnhome.

l NetWorker Administration GuideDescribes how to configure and maintain the NetWorker software.

l NetWorker Network Data Management Protocol (NDMP) User GuideDescribes how to use the NetWorker software to provide data protection forNDMP filers.

l NetWorker Cluster Integration GuideContains information related to configuring NetWorker software on cluster serversand clients.

l NetWorker Installation Guide

Preface 7

https://www.dell.com/support


https://elabnavigator.emc.com/eln/elnhome

Provides information on how to install, uninstall, and update the NetWorkersoftware for clients, storage nodes, and servers on all supported operatingsystems.

l NetWorker Updating from a Previous Release GuideDescribes how to update the NetWorker software from a previously installedrelease.

l NetWorker Release NotesContains information on new features and changes, fixed problems, knownlimitations, environment and system requirements for the latest NetWorkersoftware release.

l NetWorker Command Reference GuideProvides reference information for NetWorker commands and options.

l NetWorker Data Domain Boost Integration GuideProvides planning and configuration information on the use of Data Domaindevices for data deduplication backup and storage in a NetWorker environment.

l NetWorker Performance Optimization Planning GuideContains basic performance tuning information for NetWorker.

l NetWorker Server Disaster Recovery and Availability Best Practices GuideDescribes how to design, plan for, and perform a step-by-step NetWorker disasterrecovery.

l NetWorker Snapshot Management Integration GuideDescribes the ability to catalog and manage snapshot copies of production datathat are created by using mirror technologies on storage arrays.

l NetWorkerSnapshot Management for NAS Devices Integration GuideDescribes how to catalog and manage snapshot copies of production data that arecreated by using replication technologies on NAS devices.

l NetWorker Security Configuration GuideProvides an overview of security configuration settings available in NetWorker,secure deployment, and physical security controls needed to ensure the secureoperation of the product.

l NetWorker VMware Integration GuideProvides planning and configuration information on the use of VMware in aNetWorker environment.

l NetWorker Error Message GuideProvides information on common NetWorker error messages.

l NetWorker Licensing GuideProvides information about licensing NetWorker products and features.

l NetWorker REST API Getting Started GuideDescribes how to configure and use the NetWorker REST API to createprogrammatic interfaces to the NetWorker server.

l NetWorker REST API Reference GuideProvides the NetWorker REST API specification used to create programmaticinterfaces to the NetWorker server.

l NetWorker 19.1 with CloudBoost 19.1 Integration GuideDescribes the integration of NetWorker with CloudBoost.

l NetWorker 19.1 with CloudBoost 19.1 Security Configuration GuideProvides an overview of security configuration settings available in NetWorker andCloud Boost, secure deployment, and physical security controls needed to ensurethe secure operation of the product.

Preface


l NetWorker Management Console Online HelpDescribes the day-to-day administration tasks performed in the NetWorkerManagement Console and the NetWorker Administration window. To view theonline help, click Help in the main menu.

l NetWorker User Online HelpDescribes how to use the NetWorker User program, which is the Windows clientinterface, to connect to a NetWorker server to back up, recover, archive, andretrieve files over a network.

Special notice conventions that are used in this documentThe following conventions are used for special notices:

NOTICE

Identifies content that warns of potential business or data loss.

Note

Contains information that is incidental, but not essential, to the topic.

Typographical conventionsThe following type style conventions are used in this document:

Table 2 Style conventions

Bold Used for interface elements that a user specifically selects or clicks,for example, names of buttons, fields, tab names, and menu paths.Also used for the name of a dialog box, page, pane, screen area withtitle, table label, and window.

Italic Used for full titles of publications that are referenced in text.

Monospace Used for:

l System code

l System output, such as an error message or script

l Pathnames, file names, file name extensions, prompts, andsyntax

l Commands and options

Monospace italic Used for variables.

Monospace bold Used for user input.

[ ] Square brackets enclose optional values.

| Vertical line indicates alternate selections. The vertical line means orfor the alternate selections.

{ } Braces enclose content that the user must specify, such as x, y, or z.

... Ellipses indicate non-essential information that is omitted from theexample.

You can use the following resources to find more information about this product,obtain support, and provide feedback.

Where to find product documentation

l https://www.dell.com/support

Preface

9


l https://community.emc.com

Where to get supportThe Support website https://www.dell.com/support provides access to productlicensing, documentation, advisories, downloads, and how-to and troubleshootinginformation. The information can enable you to resolve a product issue before youcontact Support.

To access a product-specific page:

1. Go to https://www.dell.com/support.

2. In the search box, type a product name, and then from the list that appears, selectthe product.

KnowledgebaseThe Knowledgebase contains applicable solutions that you can search for either bysolution number (for example, KB000xxxxxx) or by keyword.

To search the Knowledgebase:


2. On the Support tab, click Knowledge Base.

3. In the search box, type either the solution number or keywords. Optionally, youcan limit the search to specific products by typing a product name in the searchbox, and then selecting the product from the list that appears.

Live chatTo participate in a live interactive chat with a support agent:


2. On the Support tab, click Contact Support.

3. On the Contact Information page, click the relevant support, and then proceed.

Service requestsTo obtain in-depth help from Licensing, submit a service request. To submit a servicerequest:


2. On the Support tab, click Service Requests.

Note

To create a service request, you must have a valid support agreement. For detailsabout either an account or obtaining a valid support agreement, contact a salesrepresentative. To get the details of a service request, in the Service RequestNumber field, type the service request number, and then click the right arrow.

To review an open service request:


2. On the Support tab, click Service Requests.

3. On the Service Requests page, under Manage Your Service Requests, clickView All Dell Service Requests.

Online communitiesFor peer contacts, conversations, and content on product support and solutions, go tothe Community Network https://community.emc.com. Interactively engage withcustomers, partners, and certified professionals online.

Preface


https://community.emc.com







https://community.emc.com

How to provide feedbackFeedback helps to improve the accuracy, organization, and overall quality ofpublications. You can send feedback to [email protected].

Preface

11

mailto:[email protected]

Preface


CHAPTER 1

Introduction

This chapter includes the following topics:

l Overview............................................................................................................ 14l Installation Package............................................................................................ 14l Java Requirements for NetWorker .....................................................................14

Introduction 13

OverviewNetWorker Runtime Environment (NRE) installer package provides the Java RuntimeEdition (JRE) package that is required for NetWorker Server, NetWorkerManagement Web UI, and, NMC. The NRE package installs the following files on thesystem:

l Java Runtime Environment

l Java application to launch NMC.

Dell EMC recommends you to use NetWorker Runtime Environment. However, youcan launch NMC by using a licensed JRE 8.

Installation PackageNetWorker Runtime Environment installation is supported on x64 Linux and Windows.

You can download the NRE software from https://www.dell.com/support.

Table 3 Package name

Platform Filename

Windows nre-win-8.0.1.msi

Linux nre-linux-8.0.1.rpm

Note

If you are upgrading NetWorker to the latest version, you can continue to use theexisting JRE. If you want to remove JRE, ensure that you do so after installing NREand upgrading the NetWorker software.

Java Requirements for NetWorkerThe installation for the NetWorker software checks for the required Java version on ahost. When the processor script does not detect the minimum required Java version(64-bit) on the host, the installation cannot continue. Before you start the NetWorkerinstallation or upgrade, install the Java provided in NetWorker Runtime Environmentor the latest version of the 64-bit Java 8 or Java 9 on the host.

NetWorker has a dependency on NRE or JRE to run NetWorker and launch NMCapplication .

Note

NRE and JRE both can be installed on the system. They do not create a conflict in thesystem.

Introduction


CHAPTER 2

NetWorker Runtime Environment on Windows


l Installing NetWorker Runtime Environment on Windows.................................... 16l Uninstalling NetWorker Runtime Environment on Windows ...............................16

NetWorker Runtime Environment on Windows 15

Installing NetWorker Runtime Environment on WindowsYou can use NetWorker Runtime Environment on windows to launch NetWorkersoftware.

Procedure

1. Download the NetWorker Runtime Environment software package from theOnline Support website to a temporary location.

2. In the directory that contains the unzipped NetWorker software, run the nre-win-8.0.1.msi.

3. In the Welcome Wizard page, click Next.

4. In the EULA page, select I agree to the license terms and agreements, and thenclick Next.

5. To accept the default installation location C:\Program Files\NRE, clickNext.

Optional: If you want to launch the NMC application from this system thenselect the checkbox to create a shortcut for NetWorker Runtime Environmentlauncher on the desktop.

6. To proceed with installation, click Install.

7. To complete the installation, click Finish.

Results

NetWorker Runtime Environment program is installed on the system.

Uninstalling NetWorker Runtime Environment on WindowsThe uninstallation of NetWorker Runtime Environment on windows from the Programand Features window.

Procedure

1. From the Control Panel, select Program and Features.

2. On the Program and Features window, select NetWorker RuntimeEnvironment.

3. Click Uninstall.

A warning message is displayed.

4. Click Yes to complete the uninstallation.

Results

The NetWorker Runtime Environment is uninstalled from the system.

NetWorker Runtime Environment on Windows


CHAPTER 3

NetWorker Runtime Environment on Linux


l Installing NetWorker Runtime Environment on Linux.......................................... 18l Uninstalling NetWorker Runtime Environment on Linux......................................19

NetWorker Runtime Environment on Linux 17

Installing NetWorker Runtime Environment on LinuxYou can install NetWorker Runtime Environment on linux to launch NetWorkersoftware.

Procedure

1. Connect to the host with the root account.

2. Download the NetWorker Runtime Environment software package from theonline support website to a temporary location.

3. To install the NetWorker Runtime Environment software, run one of thefollowing command:

l To install the NetWorker Runtime Environment software in the defaultlocation /opt/nre, type: rpm -ivh nre-linux-8.0.1.rpm.

l To install the NetWorker Runtime Environment software in an alternativelocation, type: rpm -ivh --relocate /opt/nre=/path nre-linux-8.0.1.rpm

The message NOTE: To complete configuration execute thefollowing script :/opt/nre/nreconfig.sh is displayed.

Note

/opt/nre/nreconfig.sh is the default path.

4. To configure the NRE, run the nreconfig.sh script.

root@system NRE]# rpm -ivh nre-linux-8.0.1.rpmInstallation of NREwarning: nre-linux-8.0-20190427.021533-23.rpm: Header V3 RSA/SHA1 signature: NOKEY, key ID 1234dfb7Preparing... ########################################### [100%] 1:nre ########################################### [100%]NOTE: To complete configuration execute the following script :/opt/nre/nreconfig.sh

[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

Results

The NetWorker Runtime Environment is installed in the system.



Uninstalling NetWorker Runtime Environment on LinuxYou can uninstall NetWorker Runtime Environment software by using rpm -e nrecommand.

Procedure

1. Connect to the host with the root account.

2. Remove the byNetWorker Runtime Environment using the rpm -e command:rpm -e nre

Results

The NetWorker Runtime Environment is uninstalled from the system.


Uninstalling NetWorker Runtime Environment on Linux 19

CHAPTER 4

Launching NMC Application


l Launching NMC................................................................................................. 22

Launching NMC Application 21

Launching NMCYou can launch the NMC by using the NMC launcher application that is installed withNetWorker Runtime Environment.

Procedure

1. Run the NMC launcher java application.

2. You can choose one of the following option to launch the NMC:

l In the Connect to NMC Server option, in the Enter NMC Server IP/Hostname field, type the IP address of the NMC server and in the EnterPort No field, type the NMC HTTPS port number. The default port numberis 9000.

l If you are launching NMC from Data Protection Central, then select BrowseJNLP file option and upload the downloaded JNLP file.

3. Click Connect to launch the NMC application.

Launching NMC Application


CHAPTER 5

Troubleshooting


l Enabling Java Console and Clearing Cache........................................................ 24l NRE Log files..................................................................................................... 24

Troubleshooting 23

Enabling Java Console and Clearing CacheYou can clear the cache from the Java Control Panel.

Procedure

1. Open Run and enter the launch the javacpl binary.

The javacpl binary is located in <NRE Install Path>/java/jre1.8.0_211/bin/javacpl location.

2. To clear the cache, Select General Tab and click Temporary Internet Files forclearing the cache.

3. To enable the Java console, select Advanced tab and click Show console.

NRE Log filesYou can use the launcherLogs.txt to debug the issues with NRE.

The log levels can be defined in the logConfig.properties file located in <NREInstall Path>/logs/logConfig.properties. The default log level is“WARNING”.

Note

If you enter invalid log level, then the log level will be reset to “WARNING”.

Troubleshooting


networker runtime environment readme guide...before you start the networker installation or upgrade,...

Documents