openWithFailover (Database - Java)

Opens a database on a server.

Note: This method is new with Release 6.5.

Defined in



public boolean openWithFailover(String server, String dbfile)
    throws NotesException


String server

The name of the primary server on which the database resides.

String dbfile

The file name of the database to open.

Return value

  • true indicates that the database exists and was opened.
  • false indicates that there is no database with this name in the cluster.


The object Server and FilePath properties reflect the actual server on which the database is opened.

If the database can't be opened on the specific server but the server belongs to a cluster, openWithFailover automatically looks for a replica of the specified server on the same cluster. If the method finds a replica, that database is opened instead, and the Server property adjusts accordingly.