co.mindus.ip2location

Class IP2LocationBootstrap

java.lang.Object

co.mindus.ip2location.IP2LocationBootstrap

public class IP2LocationBootstrap
extends Object

Server-side bootstrap for the IP2Location geolocation service.

Call initialize(int) during server startup (from ClientSessionManager or wherever services are loaded), and shutdown() during server shutdown. On server reload/restart, call initialize(int) again — the manager handles reconfiguration automatically if already configured.

Cluster Support

NetPhantom supports running multiple server instances ("clustered mode") in separate JVM processes managed by a Cluster Controller. Each clustered instance is identified by a one-based index. The index parameter controls the operating mode:

• index=0 — Normal (unclustered) server. Uses the configured database path as-is (e.g. IP2Location/).
• index≥1 — Clustered server instance. Appends "#" + index to the database path (e.g. IP2Location#1/, IP2Location#2/), following the standard NetPhantom convention for per-instance paths.

Why Per-Instance Directories

Each JVM gets its own database directory to avoid:

• File locking conflicts — especially with memory-mapped files on Windows where MappedByteBuffer cannot be explicitly unmapped, preventing file replacement while any JVM holds a mapping.
• State file corruption — the .ip2location-state.properties file tracks download progress per instance.
• Event log corruption — concurrent writes from multiple JVMs.

Configuration

All cluster instances share the same [IP2Location] configuration in server.ini. Only the database path is modified per instance. Configuration changes should be made via the first cluster server's Admin UI (index=1), after which the Cluster Controller restarts the other instances to pick up the change.

The cluster index is stored in IP2LocationManager and is accessible via IP2LocationManager.getClusterIndex(), allowing the UI layer to restrict configuration editing on non-primary cluster instances.

See Also:

IP2LocationManager.getClusterIndex(), IP2LocationManager.isClusterInstance()

Constructor Summary

Constructors

Constructor and Description
IP2LocationBootstrap()

Method Summary

Modifier and Type	Method and Description
static void	initialize(int index) Initializes the IP2Location service from server.ini settings.
static void	shutdown() Shuts down the IP2Location service.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IP2LocationBootstrap

public IP2LocationBootstrap()

Method Detail

initialize

public static void initialize(int index)

Initializes the IP2Location service from server.ini settings.

Safe to call multiple times: if the manager is already configured, this delegates to reconfigure (hot-swap). If [IP2Location] section is missing or enabled=0, the service starts in disabled mode.

Parameters:

index - Index value of this cluster server instance if larger than zero, i.e. 1=first cluster server, etc. If the server is a normal unclustered server, the index value is 0.

shutdown

public static void shutdown()

Shuts down the IP2Location service.

Call during server shutdown. Safe to call if not initialized.