Difference between revisions of "Installing"

From Gestinux Wiki
Jump to navigation Jump to search
 
(123 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{#customtitle:Gestinux installation}}
+
{{DISPLAYTITLE:Gestinux installation}}
  
[[installing/fr|Français]]
+
== Supported Systems ==
  
== Supported Systems ==
+
Gestinux runs on '''Linux''', '''Windows''' and '''MAC OS/X'''
  
Gestinux runs on '''Linux''' and '''Windows'''.
+
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.
  
Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome!  On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.
+
It is available on Windows (2000 to 10) in 32 bits only (64 bits could be built, but is useless).
  
Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.
+
On MAC OS/X, it is an experimental version, available only for a few processors.
  
We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.
+
== Supported databases ==
  
There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.
+
Gestinux works perfectly with MariaDb 10, which is the DBMS to use, when possible.
  
Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...
+
Gestinux works also well with MySql 5 but, up to version 1.5, not with MySql 8 due to a compatibility break.  
  
== Location of programs and data ==
+
It works with PostgreSQL 8 ou 9. However, there were less tests with this DBMS since Gestinux 1.5, due to a lack of resources.
  
Gestinux is an application using a client-server database.
+
Your feedbacks are welcome.
  
You have always to install a ''client'' program on each computer you want to use. It is light and very easy, and can be done with a few clicks. After that, you just need to choose where is located the database.
+
== Location of programs and data ==
  
This database can be :
+
Gestinux is a client-server database application.
  
* On a remote server, reachable through internet.
+
You have to install a ''client'' program on each computer where Gestinux is used. Installing the client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the database.
* On the same computer as the client program.
 
* On any other workstation or dedicated server in the local network.
 
  
The first solution can be used to access a [[Test_database|test database]].
+
This database can be:
 +
* stored locally on the same computer as the client program.
 +
* located on any workstation or dedicated server in your local network.
 +
* accessed remotely via an internet server.
  
If you don't mind having your data out of your office, and if you have a good internet connection, you can use this solution, with a hoster. In this case, no need for a local server, and you can access from anywherePerformances will be better than with a full web application. However, some technical knowledge is required for data security.
+
If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this last 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 locationPerformance 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 server|install a free database server]] on a workstation.
 
Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.
  
For a more advanced usage, or a larger company, the dedicated server is better and remains easy to implement.
+
For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.
 +
 
 +
'''''You never need to create yourself a database. Gestinux will do it for you as shown further.'''''
  
 
== Installation of Client program ==
 
== Installation of Client program ==
  
=== Installation of Gestinux 0.5 (stable but limited) ===
+
Version are [[Release naming|numbered and named according to precise rules]] indicating the reliability level you can expect.
 +
 
 +
=== Installation of Gestinux 1.5 (stable) ===
 +
 
 +
==== On Linux Debian (Ubuntu, Mint) ====
 +
 
 +
First you must choose the database you want to use.
 +
 
 +
You will have to check if you already have an installed database driver, or install it.
 +
 
 +
* [[Install_Mysql_client_driver_linux|MariaDb or MySql]]  (preferred).
  
* On '''Linux Debian (Ubuntu)''' :
+
* [[Install_Postgresql_client_driver|PostgreSql]].
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
 
** Run from the '''Office''' menu.
 
  
* On '''Windows''' :
+
Then download the Gestinux package depending on your processor [https://sourceforge.net/projects/gestinux/files/Stable%20release/install_gestinux_1.5-stable-1_Debian_i386_32bits.deb/download i386 32 bits] or [https://sourceforge.net/projects/gestinux/files/Stable%20release/install_gestinux_1.5-stable-3_Debian_x86_64bits.deb/download 64 bits]  
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
+
* Open the file to install Gestinux.  
** Execute and follow instructions.
+
* If it doesn't work, run this command line to install :
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''
+
  dpkg -i  <.deb filename downloaded>
  
=== Installation of Gestinux 1.0 ===
+
Run Gestinux from the '''Office''', '''Gestinux''' menu item. If it was not created, you can run the command-line: '''/usr/bin/gestinux'''
  
* On '''Linux Debian (Ubuntu)''' :
+
''For information, adding Gestinux in Ubuntu software library [https://bugs.launchpad.net/ubuntu/+bug/1364605 was submitted]''
** Download the last package for Linux (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
 
** Gestinux will be ready to use MySql. There is a little more to do to be [[client of a Postgresql database|Install Postgresql client driver]]
 
** Open the file to install.
 
** Run from the '''Office''' menu or /usr/bin/gestinux
 
  
* On '''Windows''' :
+
==== On Windows ====
** Download the last package for Windows (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
+
* Download the [https://sourceforge.net/projects/gestinux/files/Stable%20release/install_gestinux_1.5-stable-3_Windows_i386_32bits.exe/download installer]  
** Execute and follow instructions.
+
* Execute the installer, following the instructions given.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''
+
* 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 ====
 +
* Download the [https://sourceforge.net/projects/gestinux/files/Stable%20release/install_gestinux_1.4-stable-3_OSX_i386_32bits.pkg/download installation package] and execute it.
 +
* Download and install a [https://dev.mysql.com/downloads/connector/c/ 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 ===
 
=== Development version ===
  
If you are a developer, you can download and [[Developing|compile yourself]] sources.
+
If you are a developer, you can download and [[Developing|compile the source yourself]].
 +
 
 +
Gestinux could be made available for other operating systems or processors with which Lazarus is compatible. You are welcome to build and test executables on these systems, and possibly to make installation packages  :
 +
 
 +
* operating systems : other Linux, Unix BSD, OS/2, ReactOS ...
 +
* processors : x64, IA-64, PowerPC 32/64, SPARC, ARM, 68000, Alpha, MIPS...
  
 
== After installation ==
 
== After installation ==
  
Installation do not create any database and will not alter any data.
+
Installation does not create a database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.
+
After installation, you must run Gestinux and perform the [[initial setup]] to create (or upgrade) your database.

Latest revision as of 10:59, 9 December 2023

 Français Español


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.

Supported databases

Gestinux works perfectly with MariaDb 10, which is the DBMS to use, when possible.

Gestinux works also well with MySql 5 but, up to version 1.5, not with MySql 8 due to a compatibility break.

It works with PostgreSQL 8 ou 9. However, there were less tests with this DBMS since Gestinux 1.5, due to a lack of resources.

Your feedbacks are welcome.

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 client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the database.

This database can be:

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

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this last 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.

You never need to create yourself a database. Gestinux will do it for you as shown further.

Installation of Client program

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

Installation of Gestinux 1.5 (stable)

On Linux Debian (Ubuntu, Mint)

First you must choose the database you want to use.

You will have to check if you already have an installed database driver, or install it.

Then download the Gestinux package depending on your processor i386 32 bits or 64 bits

  • Open the file to install Gestinux.
  • If it doesn't work, run this command line to install :
 dpkg -i  <.deb filename downloaded>

Run Gestinux 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

  • Download the installation package and execute it.
  • 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.

Gestinux could be made available for other operating systems or processors with which Lazarus is compatible. You are welcome to build and test executables on these systems, and possibly to make installation packages :

  • operating systems : other Linux, Unix BSD, OS/2, ReactOS ...
  • processors : x64, IA-64, PowerPC 32/64, SPARC, ARM, 68000, Alpha, MIPS...

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.