* <p>
     * When copying between JavaBeans and {@link Map}, you can change the delimiter for property names.
     * For example, if you specify an underscore as the delimiter for JavaBeans and a period as the delimiter for {@link Map},
     * the property names for the source and destination will be as follows:
     * </p>
     * <table border="1">
     * <caption>Copied JavaBeans Properties</caption>
     * <tr>

     * <p>
     * When copying between JavaBeans and {@link Map}, you can change the delimiter used in property names.
     * For example, if you specify an underscore as the delimiter for JavaBeans and a period as the delimiter for {@link Map},
     * the property names for the source and destination will be as follows:
     * </p>
     * <table border="1">
     * <caption>Copied JavaBeans Properties</caption>
     * <tr>

        this.namespace = namespace;
        return this;
    }

    /**
     * Sets the document expiration period in days.
     * Controls how long crawled documents remain in the search index.
     *
     * @param documentExpires the expiration period: -2 (system default), -1 (never expire),
     *                       0 or positive (expire after specified days)

            }

            // Check for trailing spaces or periods (Windows doesn't handle well)
            if (component.endsWith(" ") || component.endsWith(".")) {
                throw new SmbException("Path component has trailing space or period: " + component);
            }
        }
    }

    /**
     * Validate host name
     */

        log.info("Connection lost, waiting for witness notification before retry");
        
        // Wait briefly for witness notification before retrying
        try {
            Thread.sleep(2000);  // 2 second grace period
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
    
    // Proceed with normal error handling/retry
    super.handleConnectionLoss(error);
}

- [ ] Set up regular crawl schedules
- [ ] Configure backup and disaster recovery
- [ ] Document new search architecture
- [ ] Train users on new admin interface
- [ ] Decommission old search system (after validation period)

---

## Additional Resources

- **Fess Documentation**: https://fess.codelibs.org/
- **Fess Site Search**: https://github.com/codelibs/fess-site-search

        this.scheduler = Executors.newScheduledThreadPool(3); // Increased for async notifications
        this.rpcClient = rpcClient;

        // Schedule periodic tasks
        schedulePeriodicTasks();
    }

    /**
     * Schedules periodic tasks for heartbeat and registration monitoring.
     */
    private void schedulePeriodicTasks() {
        // Heartbeat monitoring

/**
 * Helper class for controlling crawler execution intervals and timing.
 * This class manages crawler execution timing based on configurable rules
 * that can specify different delays for different time periods and days.
 */
public class IntervalControlHelper {

    /** Flag indicating whether the crawler is currently running */
    protected volatile boolean crawlerRunning = true;

    /**
     * Default constructor.

        this.leaseToPath = new ConcurrentHashMap<>();
        this.scheduler = Executors.newScheduledThreadPool(1);
        this.changeNotifier = new DirectoryChangeNotifier(this);

        // Schedule periodic cache cleanup
        scheduler.scheduleAtFixedRate(this::cleanupExpiredEntries, 60, 60, TimeUnit.SECONDS);
    }

    /**
     * Request a directory lease
     *
     * @param directoryPath directory path

            log.error("Failed to create handle state directory: " + stateDirectory, e);
        }

        // Load persisted handles on startup
        loadPersistedHandles();

        // Schedule periodic persistence and cleanup
        scheduler.scheduleAtFixedRate(this::periodicMaintenance, 30, 30, TimeUnit.SECONDS);
    }

    /**
     * Request a new durable handle
     * @param path the file path