Startup

From BaseX Documentation
Revision as of 12:34, 17 January 2011 by CG (talk | contribs) (→‎BaseX Client)
Jump to navigation Jump to search

Requirements

Java

A Runtime Environment of Java 1.6 (JRE) is needed to run BaseX. BaseX is platform independent and runs on any system that provides a Java Virtual Machine. BaseX has been tested on Windows (2000, XP, Vista, 7), Max OS X (10.x), Linux(SuSE xxx, Debian, Ubuntu) and OpenBSD (4.x).

BaseX

Please download the latest BaseX version from our homepage. The official releases include the BaseX runnable, Start Scripts, and API files. If you do not use the Windows installer, we recommend to add the project's bin directory to your path environment; this way, you can run BaseX from every folder in the shell/terminal.

BaseX GUI

There are several ways of starting the GUI:

  • Double click on the BaseX icon or the BaseX.jar file
  • Start one of the basexgui/basexgui.bat scripts
  • Execute the command: java -cp BaseX.jar org.basex.BaseXGUI

Note: The BaseX GUI is just working on local databases. While you can always access local database from a BaseX server instance, you should avoid accessing databases concurrently with the GUI and the server, esp. if updates are performed.

BaseX Server

There are several ways of starting the server (get more information here):

  • Click on the BaseX Server icon
  • Start one of the basexserver/basexserver.bat scripts
  • Execute the command java -cp BaseX.jar org.basex.BaseXServer

Note: For concurrently accessing the databases (especially for write transactions), you have to use the BaseX Server. Please don't use any other BaseX mode with the databases from the BaseX Server while the server is working.

BaseX Client

There are several ways of starting the client communicating with the server (get more information here):

  • Click on the BaseX Client icon
  • Start one of the basexclient/basexclient.bat scripts
  • Execute the command java -cp BaseX.jar org.basex.BaseXClient

A default admin user can be used to connect:

  • Username: admin
  • Password: admin

The password can be changed using the PASSWORD command.

Check out the Server Tutorial section for more details.

BaseX Standalone

There are several ways of starting the standalone client (get more information here):

  • Click on the BaseX Standalone icon
  • Start one of the basex/basex.bat scripts
  • Execute the command: java -cp BaseX.jar org.basex.BaseX

See also

Server Tutorial, GUI Tutorial, Standalone Tutorial, Getting Started