Difference between revisions of "Installing"

From Gestinux Wiki
Jump to navigation Jump to search
Line 42: Line 42:
 
* Ubuntu '''16.04 LTS''' is missing a dependency. Until the bug is corrected, you need to install the driver. You can run in the terminal :
 
* Ubuntu '''16.04 LTS''' is missing a dependency. Until the bug is corrected, you need to install the driver. You can run in the terminal :
 
   sudo apt-get install libmysqlclient20   
 
   sudo apt-get install libmysqlclient20   
* If you want to use the database PostgreSQL, a [[Install_Postgresql_client_driver|further step]] is required.  
+
* Gestinux can use MySql or MariaDb immediately. If you want to use the database PostgreSQL, a [[Install_Postgresql_client_driver|further step]] is required.  
 
* Then, run from the '''Office''', '''Gestinux''' menu item. If it was not created, you can run the command-line: '''/usr/bin/gestinux'''
 
* Then, run from the '''Office''', '''Gestinux''' menu item. If it was not created, you can run the command-line: '''/usr/bin/gestinux'''
  

Revision as of 07:11, 6 October 2016

{{#customtitle:Gestinux installation}}

Supported Systems

Gestinux runs on Linux, Windows and MAC OS/X

It can be installed easily on all supported Ubuntu versions, or any other Debian, in 32-bits or 64-bits versions for the AMD-64 processor family.

It is available on Windows (2000 to 10) in 32 bits only (64 bits could be built, but is useless).

On MAC OS/X, it is an experimental version, available only for a few processors.

Location of programs and data

Gestinux is a client-server database application.

You have to install a client program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

  • accessed remotely via an internet server.
  • stored locally on the same computer as the client program.
  • located on any workstation or dedicated server in your local network.

The first solution can be used to access to your own test database, hosted by M.R.IT.

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to install a free database server on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

Installation of Client program

Version are numbered and named according to precise rules indicating the reliability level you can expect.

Installation of Gestinux 1.2 (stable)

On Linux Debian (Ubuntu, Mint)

  • Download the package depending on your processor i386 32 bits or x86 64 bits
  • Open the file to install Gestinux. Before, you may have to install GDebi from Ubuntu, to be able to install a .deb file.
  • Ubuntu 16.04 LTS is missing a dependency. Until the bug is corrected, you need to install the driver. You can run in the terminal :
 sudo apt-get install libmysqlclient20  
  • Gestinux can use MySql or MariaDb immediately. If you want to use the database PostgreSQL, a further step is required.
  • Then, run from the Office, Gestinux menu item. If it was not created, you can run the command-line: /usr/bin/gestinux

For information, adding Gestinux in Ubuntu software library was submitted

On Windows

  • Download the installer
  • Execute the installer, following the instructions given.
  • Gestinux can use MySql or MariaDb immediately. A further step is required to use Postgresql. See Install Postgresql client driver
  • Run Gestinux from a desktop shortcut, or from the Start Menu | gestinux

On Mac OS/X

Gestinux 1.2 is not working on this system.

Installation of Gestinux 1.4 (release candidate)

This version is still to be tested and validated. Note that it will not replace Gestinux stable version, if already installed.

If you are using the stable version in production, you are advised to make a copy of your database, as explained here, and to test the new version on this copied database only.

On Linux Debian (Ubuntu, Mint)

  • Download and install the package depending on your processor i386 32 bits or x86 64 bits
  • Proceed as above. The menu item is Office, Gestinux Test

On Windows

On Mac OS/X

  • WARNING: On this system, Gestinux is new and there is probably some bugs remaining.
  • Download the installation package and execute.
  • Download and install a MySql or MariaDb or PostGreSQL client for your version of OSX and the processor you have (dmg file is easier).
  • Using the Terminal, create a symbolic link : (e.g for MySql and Mac OSX Snow Leopard 32 bits Intel, otherwise change the first filename which was installed during previous step)
 sudo ln -s  /usr/local/mysql-connector-c-6.1.5-osx10.6-x86/lib/libmysqlclient.18.dylib /usr/local/lib/libmysqlclient.dylib 
  • Search for gestinux.app and run it.

Development version

If you are a developer, you can download and compile the source yourself.

After installation

Installation does not create a database and will not alter any data. After installation, you must run Gestinux and perform the initial setup to create (or upgrade) your database.