Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated for new GeoLite2-City database.


  • Database errors occur when you run ant fresh_install: There are two common errors that occur.
    • If your error looks like this:

      Code Block
      [java] 2004-03-25 15:17:07,730 INFO
  @ Initializing Database
      [java] 2004-03-25 15:17:08,816 FATAL
  @ Caught exception:
      [java] org.postgresql.util.PSQLException: Connection refused. Check
      	    that the hostname and port are correct and that the postmaster is
      	    accepting TCP/IP connections.
      [java]     at
      [java]     at org.postgresql.Driver.connect(

      it usually means you haven't yet added the relevant configuration parameter to your PostgreSQL configuration (see above), or perhaps you haven't restarted PostgreSQL after making the change. Also, make sure that the db.username and db.password properties are correctly set in [dspace]/config/dspace.cfg. An easy way to check that your DB is working OK over TCP/IP is to try this on the command line:

      Code Block
      psql -U dspace -W -h localhost

      Enter the dspace database password, and you should be dropped into the psql tool with a dspace=> prompt.

    • Another common error looks like this:

      Code Block
      [java] 2004-03-25 16:37:16,757 INFO
  @ Initializing Database
      [java] 2004-03-25 16:37:17,139 WARN
  @ Exception initializing DB
      [java] java.lang.ClassNotFoundException: org.postgresql.Driver
      [java]     at$
      [java]     at
      [java]     at

      This means that the PostgreSQL JDBC driver is not present in [dspace]/lib. See above.

  • GeoLiteCity GeoLite2-City Database file fails to download or install, when you run ant fresh_install: There are two common errors that may occur:
    • If your error looks like this:

      Code Block
      [get] Error getting to /usr/local/dspace/config/GeoLiteCityGeoLite2-City.dattar.gz
      /dspace-release/dspace/target/dspace-installer/build.xml:931: Connection timed out

      it means that you likely either (a) don't have an internet connection to download the necessary GeoLite Database file (used for DSpace Statistics), or (b) the GeoLite Database file's URL is no longer valid.

    • Another common message looks like this:

      Code Block
      [echo]          (Used for DSpace Solr Usage Statistics)

      Again, this means the GeoLite Database file cannot be downloaded or is unavailable for some reason. You should be able to resolve this issue by following the   "Manually Installing/Updating GeoLite Database File" instructions.