networker runtime environment readme guide · 2020-06-12 · networker runtime environment readme...
TRANSCRIPT
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
4 Dell EMC NetWorker Runtime Environment Readme Guide
Revision history............................................................................................................ 7Style conventions......................................................................................................... 9Package name............................................................................................................. 14
123
TABLES
Dell EMC NetWorker Runtime Environment Readme Guide 5
TABLES
6 Dell EMC NetWorker Runtime Environment Readme Guide
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
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
8 Dell EMC NetWorker Runtime Environment Readme Guide
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:
1. Go to https://www.dell.com/support.
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:
1. Go to https://www.dell.com/support.
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:
1. Go to https://www.dell.com/support.
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:
1. Go to https://www.dell.com/support.
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
10 Dell EMC NetWorker Runtime Environment Readme Guide
How to provide feedbackFeedback helps to improve the accuracy, organization, and overall quality ofpublications. You can send feedback to [email protected].
Preface
11
Preface
12 Dell EMC NetWorker Runtime Environment Readme Guide
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
14 Dell EMC NetWorker Runtime Environment Readme Guide
CHAPTER 2
NetWorker Runtime Environment on Windows
This chapter includes the following topics:
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
16 Dell EMC NetWorker Runtime Environment Readme Guide
CHAPTER 3
NetWorker Runtime Environment on Linux
This chapter includes the following topics:
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.
NetWorker Runtime Environment on Linux
18 Dell EMC NetWorker Runtime Environment Readme Guide
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.
NetWorker Runtime Environment on Linux
Uninstalling NetWorker Runtime Environment on Linux 19
NetWorker Runtime Environment on Linux
20 Dell EMC NetWorker Runtime Environment Readme Guide
CHAPTER 4
Launching NMC Application
This chapter includes the following topics:
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
22 Dell EMC NetWorker Runtime Environment Readme Guide
CHAPTER 5
Troubleshooting
This chapter includes the following topics:
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
24 Dell EMC NetWorker Runtime Environment Readme Guide