You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nifi.apache.org by ma...@apache.org on 2016/07/14 15:10:01 UTC
[1/2] nifi git commit: NIFI-2145: Auto flow.xml archive
Repository: nifi
Updated Branches:
refs/heads/master cd1bccef8 -> 0ce352d20
NIFI-2145: Auto flow.xml archive
- Added following properties:
- nifi.flow.configuration.archive.enabled
- nifi.flow.configuration.archive.max.time
- nifi.flow.configuration.archive.max.storage
- Removed manual archive operation:
- Removed 'Back-up flow' link from UI since it's not needed any longer
- Removed corresponding REST API controller/archive and its
implementations
- Added FlowConfigurationArchiveManager to enclose archive related code
- Updated related docs
Project: http://git-wip-us.apache.org/repos/asf/nifi/repo
Commit: http://git-wip-us.apache.org/repos/asf/nifi/commit/30889995
Tree: http://git-wip-us.apache.org/repos/asf/nifi/tree/30889995
Diff: http://git-wip-us.apache.org/repos/asf/nifi/diff/30889995
Branch: refs/heads/master
Commit: 30889995cb6001864dd5007b12c70ac9948907da
Parents: cd1bcce
Author: Koji Kawamura <ij...@gmail.com>
Authored: Thu Jul 14 21:33:41 2016 +0900
Committer: Mark Payne <ma...@hotmail.com>
Committed: Thu Jul 14 10:35:16 2016 -0400
----------------------------------------------------------------------
nifi-assembly/pom.xml | 3 +
.../org/apache/nifi/util/NiFiProperties.java | 24 ++-
.../src/main/asciidoc/administration-guide.adoc | 5 +-
nifi-docs/src/main/asciidoc/user-guide.adoc | 16 +-
.../org/apache/nifi/services/FlowService.java | 7 -
.../nifi/controller/StandardFlowService.java | 19 +-
.../FlowConfigurationArchiveManager.java | 193 +++++++++++++++++++
.../nifi/persistence/FlowConfigurationDAO.java | 8 -
.../StandardXMLFlowConfigurationDAO.java | 21 +-
.../TestFlowConfigurationArchiveManager.java | 164 ++++++++++++++++
.../src/main/resources/conf/nifi.properties | 3 +
.../org/apache/nifi/web/NiFiServiceFacade.java | 8 -
.../nifi/web/StandardNiFiServiceFacade.java | 12 --
.../apache/nifi/web/api/ControllerResource.java | 60 ------
.../nifi/web/controller/ControllerFacade.java | 9 -
.../partials/canvas/settings-content.jsp | 2 -
.../src/main/webapp/css/settings.css | 4 -
.../src/main/webapp/js/nf/canvas/nf-settings.js | 1 -
18 files changed, 407 insertions(+), 152 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-assembly/pom.xml
----------------------------------------------------------------------
diff --git a/nifi-assembly/pom.xml b/nifi-assembly/pom.xml
index b7ef7d7..146df7d 100644
--- a/nifi-assembly/pom.xml
+++ b/nifi-assembly/pom.xml
@@ -368,7 +368,10 @@ language governing permissions and limitations under the License. -->
<nifi.bored.yield.duration>10 millis</nifi.bored.yield.duration>
<nifi.flow.configuration.file>./conf/flow.xml.gz</nifi.flow.configuration.file>
+ <nifi.flow.configuration.archive.enabled>true</nifi.flow.configuration.archive.enabled>
<nifi.flow.configuration.archive.dir>./conf/archive/</nifi.flow.configuration.archive.dir>
+ <nifi.flow.configuration.archive.max.time>30 days</nifi.flow.configuration.archive.max.time>
+ <nifi.flow.configuration.archive.max.storage>500 MB</nifi.flow.configuration.archive.max.storage>
<nifi.login.identity.provider.configuration.file>./conf/login-identity-providers.xml</nifi.login.identity.provider.configuration.file>
<nifi.authorizer.configuration.file>./conf/authorizers.xml</nifi.authorizer.configuration.file>
<nifi.templates.directory>./conf/templates</nifi.templates.directory>
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-commons/nifi-properties/src/main/java/org/apache/nifi/util/NiFiProperties.java
----------------------------------------------------------------------
diff --git a/nifi-commons/nifi-properties/src/main/java/org/apache/nifi/util/NiFiProperties.java b/nifi-commons/nifi-properties/src/main/java/org/apache/nifi/util/NiFiProperties.java
index 3a619cb..56e6b03 100644
--- a/nifi-commons/nifi-properties/src/main/java/org/apache/nifi/util/NiFiProperties.java
+++ b/nifi-commons/nifi-properties/src/main/java/org/apache/nifi/util/NiFiProperties.java
@@ -43,7 +43,10 @@ public class NiFiProperties extends Properties {
// core properties
public static final String PROPERTIES_FILE_PATH = "nifi.properties.file.path";
public static final String FLOW_CONFIGURATION_FILE = "nifi.flow.configuration.file";
- public static final String FLOW_CONFIGURATION_ARCHIVE_FILE = "nifi.flow.configuration.archive.file";
+ public static final String FLOW_CONFIGURATION_ARCHIVE_ENABLED = "nifi.flow.configuration.archive.enabled";
+ public static final String FLOW_CONFIGURATION_ARCHIVE_DIR = "nifi.flow.configuration.archive.dir";
+ public static final String FLOW_CONFIGURATION_ARCHIVE_MAX_TIME = "nifi.flow.configuration.archive.max.time";
+ public static final String FLOW_CONFIGURATION_ARCHIVE_MAX_STORAGE = "nifi.flow.configuration.archive.max.storage";
public static final String AUTHORIZER_CONFIGURATION_FILE = "nifi.authorizer.configuration.file";
public static final String LOGIN_IDENTITY_PROVIDER_CONFIGURATION_FILE = "nifi.login.identity.provider.configuration.file";
public static final String REPOSITORY_DATABASE_DIRECTORY = "nifi.database.directory";
@@ -215,6 +218,9 @@ public class NiFiProperties extends Properties {
public static final String DEFAULT_ZOOKEEPER_SESSION_TIMEOUT = "3 secs";
public static final String DEFAULT_ZOOKEEPER_ROOT_NODE = "/nifi";
public static final String DEFAULT_SITE_TO_SITE_HTTP_TRANSACTION_TTL = "30 secs";
+ public static final String DEFAULT_FLOW_CONFIGURATION_ARCHIVE_ENABLED = "true";
+ public static final String DEFAULT_FLOW_CONFIGURATION_ARCHIVE_MAX_TIME = "30 days";
+ public static final String DEFAULT_FLOW_CONFIGURATION_ARCHIVE_MAX_STORAGE = "500 MB";
// cluster common defaults
public static final String DEFAULT_CLUSTER_PROTOCOL_HEARTBEAT_INTERVAL = "5 sec";
@@ -941,4 +947,20 @@ public class NiFiProperties extends Properties {
public boolean isStartEmbeddedZooKeeper() {
return Boolean.parseBoolean(getProperty(STATE_MANAGEMENT_START_EMBEDDED_ZOOKEEPER));
}
+
+ public boolean isFlowConfigurationArchiveEnabled() {
+ return Boolean.parseBoolean(getProperty(FLOW_CONFIGURATION_ARCHIVE_ENABLED, DEFAULT_FLOW_CONFIGURATION_ARCHIVE_ENABLED));
+ }
+
+ public String getFlowConfigurationArchiveDir() {
+ return getProperty(FLOW_CONFIGURATION_ARCHIVE_DIR);
+ }
+
+ public String getFlowConfigurationArchiveMaxTime() {
+ return getProperty(FLOW_CONFIGURATION_ARCHIVE_MAX_TIME, DEFAULT_FLOW_CONFIGURATION_ARCHIVE_MAX_TIME);
+ }
+
+ public String getFlowConfigurationArchiveMaxStorage() {
+ return getProperty(FLOW_CONFIGURATION_ARCHIVE_MAX_STORAGE, DEFAULT_FLOW_CONFIGURATION_ARCHIVE_MAX_STORAGE);
+ }
}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-docs/src/main/asciidoc/administration-guide.adoc
----------------------------------------------------------------------
diff --git a/nifi-docs/src/main/asciidoc/administration-guide.adoc b/nifi-docs/src/main/asciidoc/administration-guide.adoc
index 7ddbc78..11e26a3 100644
--- a/nifi-docs/src/main/asciidoc/administration-guide.adoc
+++ b/nifi-docs/src/main/asciidoc/administration-guide.adoc
@@ -1144,7 +1144,10 @@ The first section of the _nifi.properties_ file is for the Core Properties. Thes
|*Property*|*Description*
|nifi.version|The version number of the current release. If upgrading but reusing this file, be sure to update this value.
|nifi.flow.configuration.file*|The location of the flow configuration file (i.e., the file that contains what is currently displayed on the NiFi graph). The default value is ./conf/flow.xml.gz.
-|nifi.flow.configuration.archive.dir*|The location of the archive directory where backup copies of the flow.xml are saved. The default value is ./conf/archive.
+|nifi.flow.configuration.archive.enabled*|Specify whether NiFi creates backup copy of the flow.xml automatically when NiFi updates the flow.xml. The default value is _true_.
+|nifi.flow.configuration.archive.dir*|The location of the archive directory where backup copies of the flow.xml are saved. The default value is ./conf/archive. NiFi removes old archive files to limit disk usage based on file lifespan and total size as specified with max.time and max.storage below. However, this cleanup mechanism takes only automatically created archive flow.xml files into account. Meaning if there is other files or directories in this archive directory, NiFi ignores it. Automatically created archives have filename with ISO 8601 format timestamp prefix followed by '_<original-filename>'. ex) 20160706T160719+0900_flow.xml.gz . NiFi check filename pattern when it cleans archive directory. If you would like to keep a particular archive in this directory without worrying about being deleted by NiFi, you can do so by copying it with different filename pattern.
+|nifi.flow.configuration.archive.max.time*|The lifespan of archived flow.xml files. NiFi will delete expired archive files when it updates flow.xml. Expiration is determined based on current system time and the last modified timestamp of an archived flow.xml. The default value is 30 days.
+|nifi.flow.configuration.archive.max.storage*|The total data size allowed for the archived flow.xml files. NiFi will delete oldest archive files until the total archived file size becomes less than this configuration. The default value is 500 MB.
|nifi.flowcontroller.autoResumeState|Indicates whether -upon restart- the components on the NiFi graph should return to their last state. The default value is _true_.
|nifi.flowcontroller.graceful.shutdown.period|Indicates the shutdown period. The default value is 10 sec.
|nifi.flowservice.writedelay.interval|When many changes are made to the flow.xml, this property specifies how long to wait before writing out the changes, so as to batch the changes into a single write. The default value is 500 ms.
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-docs/src/main/asciidoc/user-guide.adoc
----------------------------------------------------------------------
diff --git a/nifi-docs/src/main/asciidoc/user-guide.adoc b/nifi-docs/src/main/asciidoc/user-guide.adoc
index 2a3f672..61b7c17 100644
--- a/nifi-docs/src/main/asciidoc/user-guide.adoc
+++ b/nifi-docs/src/main/asciidoc/user-guide.adoc
@@ -117,10 +117,14 @@ Terminology
As a result, several components may be combined together to make a larger building block from which to create a dataflow.
These templates can also be exported as XML and imported into another NiFi instance, allowing these building blocks to be shared.
-*flow.xml.gz*: Everything the DFM puts onto the NiFi User Interface canvas is written, in real time, to one file called the flow.xml.gz. This file is located in the nifi/conf directory.
- Any change made on the canvas is automatically saved to this file, without the user needing to click a "save" button. In addition, the user may create a back-up copy of this file at any time
- by selecting the Controller Settings button in the far-right section of the tool bar and clicking "Back-up flow" on the General tab. By default, this action saves a copy of the current flow in the nifi/conf/archive directory.
- See <<Controller_Settings>> for a description of where the "Back-up flow" button may be found. (Note that in a NiFi Cluster, the NiFi Cluster Manager's copy of this file is named flow.tar, whereas this file is still named flow.xml.gz on the nodes.)
+*flow.xml.gz*: Everything the DFM puts onto the NiFi User Interface canvas is written, in real time, to one file called the flow.xml.gz. This file is located in the nifi/conf directory by default.
+ Any change made on the canvas is automatically saved to this file, without the user needing to click a "save" button.
+ In addition, NiFi automatically create a back-up copy of this file in the archive directory when it is updated.
+ You can use these archived files to rollback flow configuration. To do so, stop NiFi, replace flow.xml.gz with a desired back-up copy, then restart NiFi.
+ With a clustered environment, stop whole NiFi cluster, replace flow.xml.gz of one of nodes, start the node first. Remove flow.xml.gz from other nodes.
+ Once you confirmed the node starts up as one node cluster, start other nodes. Then the replaced flow configration will be synchronized across cluster.
+ The name and location of flow.xml.gz, and auto archive behavior are configurable, see link:administration-guide.html#core-properties-br[Admin Guide] for further detail.
+
[[User_Interface]]
@@ -572,7 +576,7 @@ image:controller-settings-button.png["Controller Settings Button", width=200]
The Controller Settings window has three tabs across the top: General, Controller Services, and Reporting Tasks. The General tab is for settings that pertain to general information about the NiFi instance. For example, here, the DFM can provide a unique name for the overall dataflow, as well as comments that describe the flow. Be aware that this information is visible to any other NiFi instance that connects remotely to this instance (using Remote Process Groups, a.k.a., Site-to-Site).
-The General tab also provides settings for the overall maximum thread counts of the instance, as well as the ability to click "Back-up flow" to create a backup copy of the current flow, which is saved by default in the /conf/archive directory.
+The General tab also provides settings for the overall maximum thread counts of the instance.
image:settings-general-tab.png["Controller Settings General Tab", width=700]
@@ -1636,7 +1640,7 @@ Other Management Features
In addition to the Summary Page, Data Provenance Page, Template Management Page, and Bulletin Board Page, there are other tools in the Management Toolbar (See <<User_Interface>>) that are useful to the DFM. The Flow Configuration History, which is available by clicking on the clock icon ( image:iconFlowHistory.png["Flow History", width=28] ) in the Management Toolbar, shows all the changes that have been made to the dataflow. The history can aid in troubleshooting, such as if a recent change to the dataflow has caused a problem and needs to be fixed. The DFM can see what changes have been made and adjust the flow as needed to fix the problem. While NiFi does not have an "undo" feature, the DFM can make new changes to the dataflow that will fix the problem.
-Two other tools in the Management Toolbar are the Controller Settings page ( image:iconSettings.png["Settings", width=28] ) and the Users page ( image:iconUsers.png["Users", width=28] ). The Controller Settings page provides the ability to change the name of the NiFi instance, add comments describing the NiFi instance, set the maximum number of threads that are available to the application, and create a back-up copy of the dataflow(s) currently on the canvas. It also provides tabs where DFMs may add and configure Controller Services and Reporting Tasks (see <<Controller_Services_and_Reporting_Tasks>>). The Users page is used to manage user access, which is described in the link:administration-guide.html[Admin Guide].
+Two other tools in the Management Toolbar are the Controller Settings page ( image:iconSettings.png["Settings", width=28] ) and the Users page ( image:iconUsers.png["Users", width=28] ). The Controller Settings page provides the ability to change the name of the NiFi instance, add comments describing the NiFi instance, set the maximum number of threads that are available to the application. It also provides tabs where DFMs may add and configure Controller Services and Reporting Tasks (see <<Controller_Services_and_Reporting_Tasks>>). The Users page is used to manage user access, which is described in the link:administration-guide.html[Admin Guide].
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core-api/src/main/java/org/apache/nifi/services/FlowService.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core-api/src/main/java/org/apache/nifi/services/FlowService.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core-api/src/main/java/org/apache/nifi/services/FlowService.java
index be56210..53dbb01 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core-api/src/main/java/org/apache/nifi/services/FlowService.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core-api/src/main/java/org/apache/nifi/services/FlowService.java
@@ -103,13 +103,6 @@ public interface FlowService extends LifeCycle {
void copyCurrentFlow(OutputStream os) throws IOException;
/**
- * Creates a copy of the current flow and saves it in the configured 'archive' directory
- *
- * @throws IOException if unable to write to the archive directory
- */
- void archiveFlow() throws IOException;
-
- /**
* Creates a DataFlow object from the current flow
*
* @return the created DataFlow object
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/controller/StandardFlowService.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/controller/StandardFlowService.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/controller/StandardFlowService.java
index d5d40b6..801a4e2 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/controller/StandardFlowService.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/controller/StandardFlowService.java
@@ -67,7 +67,6 @@ import java.io.BufferedInputStream;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileInputStream;
-import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
@@ -224,19 +223,6 @@ public class StandardFlowService implements FlowService, ProtocolHandler {
}
@Override
- public void archiveFlow() throws IOException {
- writeLock.lock();
- try {
- final File archiveFile = dao.createArchiveFile();
- try (final OutputStream out = new FileOutputStream(archiveFile)) {
- dao.load(out, true);
- }
- } finally {
- writeLock.unlock();
- }
- }
-
- @Override
public void saveFlowChanges() throws IOException {
writeLock.lock();
try {
@@ -269,7 +255,8 @@ public class StandardFlowService implements FlowService, ProtocolHandler {
@Override
public void saveFlowChanges(final TimeUnit delayUnit, final long delay) {
- saveFlowChanges(delayUnit, delay, false);
+ final boolean archiveEnabled = NiFiProperties.getInstance().isFlowConfigurationArchiveEnabled();
+ saveFlowChanges(delayUnit, delay, archiveEnabled);
}
@Override
@@ -944,7 +931,7 @@ public class StandardFlowService implements FlowService, ProtocolHandler {
}
final Calendar now = Calendar.getInstance();
- if (holder.saveTime.before(now) || holder.shouldArchive) {
+ if (holder.saveTime.before(now)) {
if (logger.isTraceEnabled()) {
logger.trace("Waiting for write lock and then will save");
}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationArchiveManager.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationArchiveManager.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationArchiveManager.java
new file mode 100644
index 0000000..1add9ce
--- /dev/null
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationArchiveManager.java
@@ -0,0 +1,193 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.nifi.persistence;
+
+import org.apache.nifi.processor.DataUnit;
+import org.apache.nifi.util.FormatUtils;
+import org.apache.nifi.util.NiFiProperties;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+import java.util.Calendar;
+import java.util.GregorianCalendar;
+import java.util.List;
+import java.util.Map;
+import java.util.TimeZone;
+import java.util.concurrent.TimeUnit;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+public class FlowConfigurationArchiveManager {
+
+ private static final Logger logger = LoggerFactory.getLogger(FlowConfigurationArchiveManager.class);
+
+ /**
+ * Represents archive file name such as followings:
+ * <li>yyyyMMddTHHmmss+HHmm_original-file-name</li>
+ * <li>yyyyMMddTHHmmss-HHmm_original-file-name</li>
+ * <li>yyyyMMddTHHmmssZ_original-file-name</li>
+ */
+ private final Pattern archiveFilenamePattern = Pattern.compile("^([\\d]{8}T[\\d]{6}([\\+\\-][\\d]{4}|Z))_.+$");
+ private final Path flowFile;
+ private final Path archiveDir;
+ private final long maxTimeMillis;
+ private final long maxStorageBytes;
+
+ public FlowConfigurationArchiveManager(final Path flowFile, NiFiProperties properties) {
+ final String archiveDirVal = properties.getFlowConfigurationArchiveDir();
+ final Path archiveDir = (archiveDirVal == null || archiveDirVal.equals(""))
+ ? flowFile.getParent().resolve("archive") : new File(archiveDirVal).toPath();
+
+ final long archiveMaxTime =
+ FormatUtils.getTimeDuration(properties.getFlowConfigurationArchiveMaxTime(), TimeUnit.MILLISECONDS);
+ final long archiveMaxStorage =
+ DataUnit.parseDataSize(properties.getFlowConfigurationArchiveMaxStorage(), DataUnit.B).longValue();
+
+ this.flowFile = flowFile;
+ this.archiveDir = archiveDir;
+ this.maxTimeMillis = archiveMaxTime;
+ this.maxStorageBytes = archiveMaxStorage;
+ }
+
+ public FlowConfigurationArchiveManager(final Path flowFile, final Path archiveDir, long maxTimeMillis, long maxStorageBytes) {
+ this.flowFile = flowFile;
+ this.archiveDir = archiveDir;
+ this.maxTimeMillis = maxTimeMillis;
+ this.maxStorageBytes = maxStorageBytes;
+ }
+
+ private String createArchiveFileName(final String originalFlowFileName) {
+ TimeZone tz = TimeZone.getDefault();
+ Calendar cal = GregorianCalendar.getInstance(tz);
+ int offsetInMillis = tz.getOffset(cal.getTimeInMillis());
+ final int year = cal.get(Calendar.YEAR);
+ final int month = cal.get(Calendar.MONTH) + 1;
+ final int day = cal.get(Calendar.DAY_OF_MONTH);
+ final int hour = cal.get(Calendar.HOUR_OF_DAY);
+ final int min = cal.get(Calendar.MINUTE);
+ final int sec = cal.get(Calendar.SECOND);
+
+ String offset = String.format("%s%02d%02d",
+ (offsetInMillis >= 0 ? "+" : "-"),
+ Math.abs(offsetInMillis / 3600000),
+ Math.abs((offsetInMillis / 60000) % 60));
+
+ return String.format("%d%02d%02dT%02d%02d%02d%s_%s",
+ year, month, day, hour, min, sec, offset, originalFlowFileName);
+ }
+
+ /**
+ * Setup a file to archive data flow. Create archive directory if it doesn't exist yet.
+ * @return Resolved archive file which is ready to write to
+ * @throws IOException when it fails to access archive dir
+ */
+ public File setupArchiveFile() throws IOException {
+ Files.createDirectories(archiveDir);
+
+ if (!Files.isDirectory(archiveDir)) {
+ throw new IOException("Archive directory doesn't appear to be a directory " + archiveDir);
+ }
+ final String originalFlowFileName = flowFile.getFileName().toString();
+ final Path archiveFile = archiveDir.resolve(createArchiveFileName(originalFlowFileName));
+ return archiveFile.toFile();
+ }
+
+ /**
+ * Archive current flow configuration file by copying the original file to the archive directory.
+ * After creating new archive file:
+ * <li>It removes expired archive files based on its last modification date and maxTimeMillis</li>
+ * <li>It removes old files until total size of archive files becomes less than maxStorageBytes</li>
+ * This method keeps other files intact, so that users can keep particular archive by copying it with different name.
+ * Whether a given file is archive file or not is determined by the filename.
+ * Since archive file name consists of timestamp up to seconds, if archive is called multiple times within a second,
+ * it will overwrite existing archive file with the same name.
+ * @return Newly created archive file, archive filename is computed by adding ISO8601
+ * timestamp prefix to the original filename, ex) 20160706T160719+0900_flow.xml.gz
+ * @throws IOException If it fails to create new archive file.
+ * Although, other IOExceptions like the ones thrown during removing expired archive files will not be thrown.
+ */
+ public File archive() throws IOException {
+ final String originalFlowFileName = flowFile.getFileName().toString();
+ final File archiveFile = setupArchiveFile();
+ Files.copy(flowFile, archiveFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
+
+ // Collect archive files by its name, and group by expiry state.
+ final long now = System.currentTimeMillis();
+ final Map<Boolean, List<Path>> oldArchives = Files.walk(archiveDir, 1).filter(p -> {
+ final String filename = p.getFileName().toString();
+ if (Files.isRegularFile(p) && filename.endsWith("_" + originalFlowFileName)) {
+ final Matcher matcher = archiveFilenamePattern.matcher(filename);
+ if (matcher.matches() && filename.equals(matcher.group(1) + "_" + originalFlowFileName)) {
+ return true;
+ }
+ }
+ return false;
+ }).collect(Collectors.groupingBy(p -> (now - p.toFile().lastModified()) > maxTimeMillis, Collectors.toList()));
+
+ logger.debug("oldArchives={}", oldArchives);
+
+ // Remove expired files
+ final List<Path> expiredArchives = oldArchives.get(true);
+ if (expiredArchives != null) {
+ expiredArchives.stream().forEach(p -> {
+ try {
+ logger.info("Removing expired archive file {}", p);
+ Files.delete(p);
+ } catch (IOException e) {
+ logger.warn("Failed to delete expired archive {} due to {}", p, e.toString());
+ }
+ });
+ }
+
+ // Calculate size
+ final List<Path> remainingArchives = oldArchives.get(false);
+ final long totalArchiveSize = remainingArchives.stream().mapToLong(p -> {
+ try {
+ return Files.size(p);
+ } catch (IOException e) {
+ logger.warn("Failed to get file size of {} due to {}", p, e.toString());
+ return 0;
+ }
+ }).sum();
+ logger.debug("totalArchiveSize={}", totalArchiveSize);
+
+ // Remove old files until total size gets less than max storage size
+ remainingArchives.sort((a, b)
+ -> Long.valueOf(a.toFile().lastModified()).compareTo(Long.valueOf(b.toFile().lastModified())));
+ long reducedTotalArchiveSize = totalArchiveSize;
+ for (int i = 0; i < remainingArchives.size()
+ && reducedTotalArchiveSize > maxStorageBytes; i++) {
+ final Path path = remainingArchives.get(i);
+ try {
+ logger.info("Removing archive file {} to reduce storage usage. currentSize={}", path, reducedTotalArchiveSize);
+ final long size = Files.size(path);
+ Files.delete(path);
+ reducedTotalArchiveSize -= size;
+ } catch (IOException e) {
+ logger.warn("Failed to delete {} to reduce storage usage, due to {}", path, e.toString());
+ }
+ }
+
+ return archiveFile;
+ }
+}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationDAO.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationDAO.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationDAO.java
index 4593b2f..08658b1 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationDAO.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/FlowConfigurationDAO.java
@@ -16,7 +16,6 @@
*/
package org.apache.nifi.persistence;
-import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
@@ -111,11 +110,4 @@ public interface FlowConfigurationDAO {
*/
void save(FlowController flow, boolean archive) throws IOException;
- /**
- * Creates a File that can be used to write an archive to. The file will not actually exist on disk.
- *
- * @return a File that can be used to write an archive to
- * @throws IOException if unable to access the required directories
- */
- File createArchiveFile() throws IOException;
}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/StandardXMLFlowConfigurationDAO.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/StandardXMLFlowConfigurationDAO.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/StandardXMLFlowConfigurationDAO.java
index ffe212d..707efa2 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/StandardXMLFlowConfigurationDAO.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/main/java/org/apache/nifi/persistence/StandardXMLFlowConfigurationDAO.java
@@ -43,10 +43,9 @@ import org.slf4j.LoggerFactory;
public final class StandardXMLFlowConfigurationDAO implements FlowConfigurationDAO {
- public static final String CONFIGURATION_ARCHIVE_DIR_KEY = "nifi.flow.configuration.archive.dir";
-
private final Path flowXmlPath;
private final StringEncryptor encryptor;
+ private final FlowConfigurationArchiveManager archiveManager;
private static final Logger LOG = LoggerFactory.getLogger(StandardXMLFlowConfigurationDAO.class);
@@ -65,8 +64,9 @@ public final class StandardXMLFlowConfigurationDAO implements FlowConfigurationD
this.flowXmlPath = flowXml;
this.encryptor = encryptor;
- }
+ this.archiveManager = new FlowConfigurationArchiveManager(flowXmlPath, NiFiProperties.getInstance());
+ }
@Override
public boolean isFlowPresent() {
@@ -160,8 +160,7 @@ public final class StandardXMLFlowConfigurationDAO implements FlowConfigurationD
if (archive) {
try {
- final File archiveFile = createArchiveFile();
- Files.copy(configFile, archiveFile.toPath());
+ archiveManager.archive();
} catch (final Exception ex) {
LOG.warn("Unable to archive flow configuration as requested due to " + ex);
if (LOG.isDebugEnabled()) {
@@ -171,16 +170,4 @@ public final class StandardXMLFlowConfigurationDAO implements FlowConfigurationD
}
}
- @Override
- public File createArchiveFile() throws IOException {
- final String archiveDirVal = NiFiProperties.getInstance().getProperty(CONFIGURATION_ARCHIVE_DIR_KEY);
- final Path archiveDir = (archiveDirVal == null || archiveDirVal.equals("")) ? flowXmlPath.getParent().resolve("archive") : new File(archiveDirVal).toPath();
- Files.createDirectories(archiveDir);
-
- if (!Files.isDirectory(archiveDir)) {
- throw new IOException("Archive directory doesn't appear to be a directory " + archiveDir);
- }
- final Path archiveFile = archiveDir.resolve(System.nanoTime() + "-" + flowXmlPath.toFile().getName());
- return archiveFile.toFile();
- }
}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/test/java/org/apache/nifi/persistence/TestFlowConfigurationArchiveManager.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/test/java/org/apache/nifi/persistence/TestFlowConfigurationArchiveManager.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/test/java/org/apache/nifi/persistence/TestFlowConfigurationArchiveManager.java
new file mode 100644
index 0000000..bddcbf2
--- /dev/null
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-framework-core/src/test/java/org/apache/nifi/persistence/TestFlowConfigurationArchiveManager.java
@@ -0,0 +1,164 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.nifi.persistence;
+
+import org.apache.nifi.processor.DataUnit;
+import org.apache.nifi.util.FormatUtils;
+import org.junit.Before;
+import org.junit.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.File;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.nio.file.FileVisitResult;
+import java.nio.file.Files;
+import java.nio.file.NoSuchFileException;
+import java.nio.file.Path;
+import java.nio.file.SimpleFileVisitor;
+import java.nio.file.StandardOpenOption;
+import java.nio.file.attribute.BasicFileAttributes;
+import java.nio.file.attribute.FileTime;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.concurrent.TimeUnit;
+
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class TestFlowConfigurationArchiveManager {
+
+ private static final Logger logger = LoggerFactory.getLogger(TestFlowConfigurationArchiveManager.class);
+ private final File flowFile = new File("./target/flow-archive/flow.xml.gz");
+ private final File archiveDir = new File("./target/flow-archive");
+ private final long maxTime = FormatUtils.getTimeDuration("30 days", TimeUnit.MILLISECONDS);
+ private long maxStorage = DataUnit.parseDataSize("500 MB", DataUnit.B).longValue();
+
+ @Before
+ public void before() throws Exception {
+
+ // Clean up old files.
+ if (Files.isDirectory(archiveDir.toPath())) {
+ Files.walkFileTree(archiveDir.toPath(), new SimpleFileVisitor<Path>(){
+ @Override
+ public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
+ Files.delete(file);
+ return FileVisitResult.CONTINUE;
+ }
+ });
+ }
+
+ // Create original flow.xml.gz
+ Files.createDirectories(flowFile.getParentFile().toPath());
+ try (OutputStream os = Files.newOutputStream(flowFile.toPath(),
+ StandardOpenOption.CREATE, StandardOpenOption.WRITE, StandardOpenOption.TRUNCATE_EXISTING)) {
+ // 10 bytes.
+ os.write("0123456789".getBytes());
+ }
+
+ }
+
+ @Test(expected = NoSuchFileException.class)
+ public void testArchiveWithoutOriginalFile() throws Exception {
+ final File flowFile = new File("does-not-exist");
+ final FlowConfigurationArchiveManager archiveManager =
+ new FlowConfigurationArchiveManager(flowFile.toPath(), archiveDir.toPath(), maxTime, maxStorage);
+
+ archiveManager.archive();
+ }
+
+ private void createSimulatedOldArchives(final File[] oldArchives, final long intervalMillis) throws Exception {
+
+ // Create old archive files. Altering file name and last modified date to simulate existing files.
+ final long now = System.currentTimeMillis();
+ final SimpleDateFormat dateFormat = new SimpleDateFormat("HHmmss");
+
+ FlowConfigurationArchiveManager archiveManager =
+ new FlowConfigurationArchiveManager(flowFile.toPath(), archiveDir.toPath(), maxTime, maxStorage);
+
+ for (int i = oldArchives.length; i > 0; i--) {
+ final Date date = new Date(now - (intervalMillis * i));
+ final String hhmmss = dateFormat.format(date);
+
+ final File archiveFile = archiveManager.archive();
+ final String renamedArchiveName = archiveFile.getName().replaceFirst("T[\\d]{6}", "T" + hhmmss);
+ final File renamedArchive = archiveFile.getParentFile().toPath().resolve(renamedArchiveName).toFile();
+ archiveFile.renameTo(renamedArchive);
+
+ Files.setLastModifiedTime(renamedArchive.toPath(), FileTime.fromMillis(date.getTime()));
+
+ oldArchives[oldArchives.length - i] = renamedArchive;
+ }
+ }
+
+ @Test
+ public void testArchiveExpiration() throws Exception {
+
+ final long intervalMillis = 60_000;
+ File[] oldArchives = new File[5];
+ createSimulatedOldArchives(oldArchives, intervalMillis);
+
+ // Now, we will test expiration. There should be following old archives created above:
+ // -5 min, -4 min, -3min, -2min, -1min
+ // if maxTime = 3.5min, The oldest two files should be removed, -5 min and -4 min,
+ // resulting four files of -3min, -2min, -1min, and newly created archive.
+ final long maxTimeForExpirationTest = intervalMillis * 3 + (intervalMillis / 2);
+ FlowConfigurationArchiveManager archiveManager = new FlowConfigurationArchiveManager(flowFile.toPath(),
+ archiveDir.toPath(), maxTimeForExpirationTest, maxStorage);
+
+ final File archive = archiveManager.archive();
+ assertTrue(archive.isFile());
+
+ assertFalse(oldArchives[0].exists());
+ assertFalse(oldArchives[1].exists());
+ assertTrue(oldArchives[2].isFile());
+ assertTrue(oldArchives[3].isFile());
+ assertTrue(oldArchives[4].isFile());
+
+ assertTrue("Original file should remain intact", flowFile.isFile());
+ }
+
+
+ @Test
+ public void testArchiveStorageSizeLimit() throws Exception {
+
+ final long intervalMillis = 60_000;
+ File[] oldArchives = new File[5];
+ createSimulatedOldArchives(oldArchives, intervalMillis);
+
+ // Now, we will test storage size limit. There should be following old archives created above:
+ // -5 min, -4 min, -3min, -2min, -1min, each of those have 10 bytes.
+ // if maxStorage = 20 bytes, The oldest four files should be removed,
+ // resulting two files of -1min, and newly created archive, 20 bytes in total.
+ FlowConfigurationArchiveManager archiveManager = new FlowConfigurationArchiveManager(flowFile.toPath(),
+ archiveDir.toPath(), maxTime, 20);
+
+ final File archive = archiveManager.archive();
+ assertTrue(archive.isFile());
+
+ assertFalse(oldArchives[0].exists());
+ assertFalse(oldArchives[1].exists());
+ assertFalse(oldArchives[2].exists());
+ assertFalse(oldArchives[3].exists());
+ assertTrue(oldArchives[4].isFile());
+
+ assertTrue("Original file should remain intact", flowFile.isFile());
+ }
+
+
+}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-resources/src/main/resources/conf/nifi.properties
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-resources/src/main/resources/conf/nifi.properties b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-resources/src/main/resources/conf/nifi.properties
index cc69489..ed417d2 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-resources/src/main/resources/conf/nifi.properties
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-resources/src/main/resources/conf/nifi.properties
@@ -16,7 +16,10 @@
# Core Properties #
nifi.version=${nifi.version}
nifi.flow.configuration.file=${nifi.flow.configuration.file}
+nifi.flow.configuration.archive.enabled=${nifi.flow.configuration.archive.enabled}
nifi.flow.configuration.archive.dir=${nifi.flow.configuration.archive.dir}
+nifi.flow.configuration.archive.max.time=${nifi.flow.configuration.archive.max.time}
+nifi.flow.configuration.archive.max.storage=${nifi.flow.configuration.archive.max.storage}
nifi.flowcontroller.autoResumeState=${nifi.flowcontroller.autoResumeState}
nifi.flowcontroller.graceful.shutdown.period=${nifi.flowcontroller.graceful.shutdown.period}
nifi.flowservice.writedelay.interval=${nifi.flowservice.writedelay.interval}
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/NiFiServiceFacade.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/NiFiServiceFacade.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/NiFiServiceFacade.java
index 2479476..28485eb 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/NiFiServiceFacade.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/NiFiServiceFacade.java
@@ -284,14 +284,6 @@ public interface NiFiServiceFacade {
ControllerConfigurationEntity updateControllerConfiguration(Revision revision, ControllerConfigurationDTO controllerConfigurationDTO);
/**
- * Creates a new archive of the flow configuration.
- *
- * @return snapshot
- */
- ProcessGroupEntity createArchive();
-
-
- /**
* Returns the process group status.
*
* @param groupId group
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/StandardNiFiServiceFacade.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/StandardNiFiServiceFacade.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/StandardNiFiServiceFacade.java
index 1e86634..a8a6b3d 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/StandardNiFiServiceFacade.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/StandardNiFiServiceFacade.java
@@ -196,7 +196,6 @@ import org.slf4j.LoggerFactory;
import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.Response;
-import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Arrays;
@@ -1489,17 +1488,6 @@ public class StandardNiFiServiceFacade implements NiFiServiceFacade {
}
@Override
- public ProcessGroupEntity createArchive() {
- try {
- controllerFacade.createArchive();
- } catch (final IOException e) {
- logger.error("Failed to create an archive", e);
- }
-
- return getProcessGroup("root");
- }
-
- @Override
public ControllerServiceEntity createControllerService(final Revision revision, final String groupId, final ControllerServiceDTO controllerServiceDTO) {
controllerServiceDTO.setParentGroupId(groupId);
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/api/ControllerResource.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/api/ControllerResource.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/api/ControllerResource.java
index eb53184..346f5a4 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/api/ControllerResource.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/api/ControllerResource.java
@@ -45,7 +45,6 @@ import org.apache.nifi.web.api.entity.ControllerConfigurationEntity;
import org.apache.nifi.web.api.entity.ControllerServiceEntity;
import org.apache.nifi.web.api.entity.HistoryEntity;
import org.apache.nifi.web.api.entity.NodeEntity;
-import org.apache.nifi.web.api.entity.ProcessGroupEntity;
import org.apache.nifi.web.api.entity.ReportingTaskEntity;
import org.apache.nifi.web.api.request.DateTimeParameter;
@@ -117,65 +116,6 @@ public class ControllerResource extends ApplicationResource {
}
/**
- * Creates a new archive of this flow controller. Note, this is a POST operation that returns a URI that is not representative of the thing that was actually created. The archive that is created
- * cannot be referenced at a later time, therefore there is no corresponding URI. Instead the request URI is returned.
- *
- * Alternatively, we could have performed a PUT request. However, PUT requests are supposed to be idempotent and this endpoint is certainly not.
- *
- * @param httpServletRequest request
- * @return A processGroupEntity.
- */
- @POST
- @Consumes(MediaType.APPLICATION_JSON)
- @Produces(MediaType.APPLICATION_JSON)
- @Path("archive")
- // TODO - @PreAuthorize("hasRole('ROLE_DFM')")
- @ApiOperation(
- value = "Creates a new archive of this NiFi flow configuration",
- notes = "This POST operation returns a URI that is not representative of the thing "
- + "that was actually created. The archive that is created cannot be referenced "
- + "at a later time, therefore there is no corresponding URI. Instead the "
- + "request URI is returned.",
- response = ProcessGroupEntity.class,
- authorizations = {
- @Authorization(value = "Data Flow Manager", type = "ROLE_DFM")
- }
- )
- @ApiResponses(
- value = {
- @ApiResponse(code = 400, message = "NiFi was unable to complete the request because it was invalid. The request should not be retried without modification."),
- @ApiResponse(code = 401, message = "Client could not be authenticated."),
- @ApiResponse(code = 403, message = "Client is not authorized to make this request."),
- @ApiResponse(code = 409, message = "The request was valid but NiFi was not in the appropriate state to process it. Retrying the same request later may be successful.")
- }
- )
- public Response createArchive(@Context final HttpServletRequest httpServletRequest) {
-
- if (isReplicateRequest()) {
- return replicate(HttpMethod.POST);
- }
-
- // handle expects request (usually from the cluster manager)
- final boolean validationPhase = isValidationPhase(httpServletRequest);
- if (validationPhase || !isTwoPhaseRequest(httpServletRequest)) {
- // authorize access
- serviceFacade.authorizeAccess(lookup -> {
- authorizeController(RequestAction.WRITE);
- });
- }
- if (validationPhase) {
- return generateContinueResponse().build();
- }
-
- // create the archive
- final ProcessGroupEntity entity = serviceFacade.createArchive();
-
- // generate the response
- final URI uri = URI.create(generateResourceUri("controller", "archive"));
- return clusterContext(generateCreatedResponse(uri, entity)).build();
- }
-
- /**
* Retrieves the configuration for this NiFi.
*
* @return A controllerConfigurationEntity.
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/controller/ControllerFacade.java
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/controller/ControllerFacade.java b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/controller/ControllerFacade.java
index 6a699e4..00aceca 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/controller/ControllerFacade.java
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-api/src/main/java/org/apache/nifi/web/controller/ControllerFacade.java
@@ -152,15 +152,6 @@ public class ControllerFacade implements Authorizable {
/**
- * Creates an archive of the current flow.
- *
- * @throws IOException if unable to save a copy of the flow
- */
- public void createArchive() throws IOException {
- flowService.archiveFlow();
- }
-
- /**
* Returns the group id that contains the specified processor.
*
* @param processorId processor id
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/WEB-INF/partials/canvas/settings-content.jsp
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/WEB-INF/partials/canvas/settings-content.jsp b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/WEB-INF/partials/canvas/settings-content.jsp
index 00e17ea..48854f1 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/WEB-INF/partials/canvas/settings-content.jsp
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/WEB-INF/partials/canvas/settings-content.jsp
@@ -33,8 +33,6 @@
</div>
<div class="editable setting-field">
<input type="text" id="maximum-timer-driven-thread-count-field" class="setting-input"/>
- <span id="archive-flow-link" class="link">Back-up flow</span>
- <div class="fa fa-question-circle" alt="Info" title="Archives the flow configuration."></div>
</div>
<div class="read-only setting-field">
<span id="read-only-maximum-timer-driven-thread-count-field"></span>
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/css/settings.css
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/css/settings.css b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/css/settings.css
index dff0875..f99c15e 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/css/settings.css
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/css/settings.css
@@ -114,7 +114,3 @@ div.settings-buttons {
div.settings-buttons div.button {
float: left;
}
-
-#archive-flow-link {
- margin-left: 10px;
-}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/nifi/blob/30889995/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/js/nf/canvas/nf-settings.js
----------------------------------------------------------------------
diff --git a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/js/nf/canvas/nf-settings.js b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/js/nf/canvas/nf-settings.js
index 305469b..2c29e99 100644
--- a/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/js/nf/canvas/nf-settings.js
+++ b/nifi-nar-bundles/nifi-framework-bundle/nifi-framework/nifi-web/nifi-web-ui/src/main/webapp/js/nf/canvas/nf-settings.js
@@ -27,7 +27,6 @@ nf.Settings = (function () {
urls: {
api: '../nifi-api',
controllerConfig: '../nifi-api/controller/config',
- controllerArchive: '../nifi-api/controller/archive',
reportingTaskTypes: '../nifi-api/flow/reporting-task-types',
createReportingTask: '../nifi-api/controller/reporting-tasks',
reportingTasks: '../nifi-api/flow/reporting-tasks'
[2/2] nifi git commit: NIFI-2145: Fixed some typos/misspellings
Posted by ma...@apache.org.
NIFI-2145: Fixed some typos/misspellings
Project: http://git-wip-us.apache.org/repos/asf/nifi/repo
Commit: http://git-wip-us.apache.org/repos/asf/nifi/commit/0ce352d2
Tree: http://git-wip-us.apache.org/repos/asf/nifi/tree/0ce352d2
Diff: http://git-wip-us.apache.org/repos/asf/nifi/diff/0ce352d2
Branch: refs/heads/master
Commit: 0ce352d203b6b2d274a81dccea796deaa2698af6
Parents: 3088999
Author: Mark Payne <ma...@hotmail.com>
Authored: Thu Jul 14 11:09:42 2016 -0400
Committer: Mark Payne <ma...@hotmail.com>
Committed: Thu Jul 14 11:09:42 2016 -0400
----------------------------------------------------------------------
nifi-docs/src/main/asciidoc/administration-guide.adoc | 6 +++---
nifi-docs/src/main/asciidoc/user-guide.adoc | 10 +++++-----
2 files changed, 8 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/nifi/blob/0ce352d2/nifi-docs/src/main/asciidoc/administration-guide.adoc
----------------------------------------------------------------------
diff --git a/nifi-docs/src/main/asciidoc/administration-guide.adoc b/nifi-docs/src/main/asciidoc/administration-guide.adoc
index 11e26a3..93a6112 100644
--- a/nifi-docs/src/main/asciidoc/administration-guide.adoc
+++ b/nifi-docs/src/main/asciidoc/administration-guide.adoc
@@ -1144,10 +1144,10 @@ The first section of the _nifi.properties_ file is for the Core Properties. Thes
|*Property*|*Description*
|nifi.version|The version number of the current release. If upgrading but reusing this file, be sure to update this value.
|nifi.flow.configuration.file*|The location of the flow configuration file (i.e., the file that contains what is currently displayed on the NiFi graph). The default value is ./conf/flow.xml.gz.
-|nifi.flow.configuration.archive.enabled*|Specify whether NiFi creates backup copy of the flow.xml automatically when NiFi updates the flow.xml. The default value is _true_.
-|nifi.flow.configuration.archive.dir*|The location of the archive directory where backup copies of the flow.xml are saved. The default value is ./conf/archive. NiFi removes old archive files to limit disk usage based on file lifespan and total size as specified with max.time and max.storage below. However, this cleanup mechanism takes only automatically created archive flow.xml files into account. Meaning if there is other files or directories in this archive directory, NiFi ignores it. Automatically created archives have filename with ISO 8601 format timestamp prefix followed by '_<original-filename>'. ex) 20160706T160719+0900_flow.xml.gz . NiFi check filename pattern when it cleans archive directory. If you would like to keep a particular archive in this directory without worrying about being deleted by NiFi, you can do so by copying it with different filename pattern.
+|nifi.flow.configuration.archive.enabled*|Specifies whether NiFi creates a backup copy of the flow automatically when the flow is updated. The default value is _true_.
+|nifi.flow.configuration.archive.dir*|The location of the archive directory where backup copies of the flow.xml are saved. The default value is ./conf/archive. NiFi removes old archive files to limit disk usage based on file lifespan and total size, as specified with max.time and max.storage properties below. However, this cleanup mechanism takes into account only automatically created archived flow.xml files. That is, if there are other files or directories in this archive directory, NiFi will ignore them. Automatically created archives have filename with ISO 8601 format timestamp prefix followed by '_<original-filename>'. That is <year><month><day>T<hour><minute><second>+<timezone offset>_<original filename>. For example, `20160706T160719+0900_flow.xml.gz`. NiFi checks filenames when it cleans archive directory. If you would like to keep a particular archive in this directory without worrying about NiFi deleting it, you can do so by copying it with a different filename pattern.
|nifi.flow.configuration.archive.max.time*|The lifespan of archived flow.xml files. NiFi will delete expired archive files when it updates flow.xml. Expiration is determined based on current system time and the last modified timestamp of an archived flow.xml. The default value is 30 days.
-|nifi.flow.configuration.archive.max.storage*|The total data size allowed for the archived flow.xml files. NiFi will delete oldest archive files until the total archived file size becomes less than this configuration. The default value is 500 MB.
+|nifi.flow.configuration.archive.max.storage*|The total data size allowed for the archived flow.xml files. NiFi will delete the oldest archive files until the total archived file size becomes less than this configuration value. The default value is 500 MB.
|nifi.flowcontroller.autoResumeState|Indicates whether -upon restart- the components on the NiFi graph should return to their last state. The default value is _true_.
|nifi.flowcontroller.graceful.shutdown.period|Indicates the shutdown period. The default value is 10 sec.
|nifi.flowservice.writedelay.interval|When many changes are made to the flow.xml, this property specifies how long to wait before writing out the changes, so as to batch the changes into a single write. The default value is 500 ms.
http://git-wip-us.apache.org/repos/asf/nifi/blob/0ce352d2/nifi-docs/src/main/asciidoc/user-guide.adoc
----------------------------------------------------------------------
diff --git a/nifi-docs/src/main/asciidoc/user-guide.adoc b/nifi-docs/src/main/asciidoc/user-guide.adoc
index 61b7c17..8af0321 100644
--- a/nifi-docs/src/main/asciidoc/user-guide.adoc
+++ b/nifi-docs/src/main/asciidoc/user-guide.adoc
@@ -119,11 +119,11 @@ Terminology
*flow.xml.gz*: Everything the DFM puts onto the NiFi User Interface canvas is written, in real time, to one file called the flow.xml.gz. This file is located in the nifi/conf directory by default.
Any change made on the canvas is automatically saved to this file, without the user needing to click a "save" button.
- In addition, NiFi automatically create a back-up copy of this file in the archive directory when it is updated.
- You can use these archived files to rollback flow configuration. To do so, stop NiFi, replace flow.xml.gz with a desired back-up copy, then restart NiFi.
- With a clustered environment, stop whole NiFi cluster, replace flow.xml.gz of one of nodes, start the node first. Remove flow.xml.gz from other nodes.
- Once you confirmed the node starts up as one node cluster, start other nodes. Then the replaced flow configration will be synchronized across cluster.
- The name and location of flow.xml.gz, and auto archive behavior are configurable, see link:administration-guide.html#core-properties-br[Admin Guide] for further detail.
+ In addition, NiFi automatically creates a backup copy of this file in the archive directory when it is updated.
+ You can use these archived files to rollback flow configuration. To do so, stop NiFi, replace flow.xml.gz with a desired backup copy, then restart NiFi.
+ In a clustered environment, stop the entire NiFi cluster, replace the flow.xml.gz of one of nodes, and restart the node. Remove flow.xml.gz from other nodes.
+ Once you confirmed the node starts up as a one-node cluster, start the other nodes. The replaced flow configuration will be synchronized across the cluster.
+ The name and location of flow.xml.gz, and auto archive behavior are configurable. See the link:administration-guide.html#core-properties-br[Admin Guide] for further details.