Recent changes to Install

Install modified by cybrarian

cybrarian — Sun, 25 Mar 2018 22:20:37 -0000

--- v15
+++ v16
@@ -110,7 +110,7 @@
 - check the changes.txt and changes.sql files; if the database changes, i.e. fields are added, you can cut-paste the modifications to e.g. phpMyAmin.
 - still database errors?  Make a backup of yours, and try with the supplied example database.
 - let me know where it stops if you run it from the IDE 
-- or file a ticket [https://sourceforge.net/p/gitin/tickets/](http://).
+- or file a ticket [https://sourceforge.net/p/gitin/tickets/](https://sourceforge.net/p/gitin/tickets/).
 -----

 *note: Last updated with version 0.7.4.*

Install modified by cybrarian

cybrarian — Sun, 25 Mar 2018 22:19:38 -0000

--- v14
+++ v15
@@ -109,7 +109,8 @@
 - check the error messages (if any), check more recent version if exists, otherwise file a bug report, so that the problem can be handled.
 - check the changes.txt and changes.sql files; if the database changes, i.e. fields are added, you can cut-paste the modifications to e.g. phpMyAmin.
 - still database errors?  Make a backup of yours, and try with the supplied example database.
-- let me know where it stops if you run it from the IDE.
+- let me know where it stops if you run it from the IDE 
+- or file a ticket [https://sourceforge.net/p/gitin/tickets/](http://).
 -----

 *note: Last updated with version 0.7.4.*

Install modified by cybrarian

cybrarian — Sun, 25 Mar 2018 22:17:11 -0000

--- v13
+++ v14
@@ -2,7 +2,7 @@

 **Context**

-Gitin is a desktop program for a Linux system with e.g. KDE.  This is the source, so you have to "compile" it with Gambas.  Luckily this can nicely be done by pressing a button in the Gambas IDE once you opened the project in it.  You can even choose to make a link on the desktop with marking a checkbox!  
+Gitin is a desktop program for a Linux system with e.g. KDE.  This is the source, so you have to "compile" it with Gambas.  Luckily this can nicely be done by pressing a button in the Gambas IDE once you opened the project in it.  You can even choose to make a link on the desktop (just by marking a checkbox! )
 Afterwards you don't need the Gambas IDE any more, except if you want to compile a newer version.  You have to keep the Gambas runtime though.

 Install Gambas3 from your favourite Linux distro repository.  E.g. opensuse 42.3, yast search "Gambas3-IDE".  If you do not choose the IDE, but just gambas3, you might end up with just the runtime.  You can compile from the command prompt, but really easy is from the IDE.
@@ -19,7 +19,7 @@

 Press F5 (menu Debug, Run).  That's it, you see the program work.  (of course it is empty! - see later).

-**Want to keep it?**
+**Want to keep it as executable?**

 Choose Project, Mkae, Executable. (mark Create shortcut on the desktop).  "ok".

@@ -27,7 +27,7 @@

 **Run**

-If the program runs*, it starts with a quite-emtpy-screen.  That's normal, you want to track YOUR it equipment, not mine.
+If the program runs*, it starts with a quite-emtpy-screen.  That's normal, you want to track YOUR IT equipment, not mine.
 At the bottom you might see app messages about no access to the database: "cannot open databases..".  That's right - what database? (ps: if you get this message afterwards, just check that your database server is started!)

 * no? Look further under "if the program doesn't run".*
@@ -86,7 +86,7 @@

 If you choose one of the table buttons on top, you get the record-edit screen for that table.
 The messages "Result is not available" in the color "Description", "Example", etc, are normal on this moment, as there is no help information available yet.  You might fill it in the table `_helpdata`, or import it from a sample file.
-(I used DbInfoCode to fill the descriptions, examples and defaultvalues there.) 
+(I used DbInfoCode to fill the descriptions, examples and defaultvalues there.  The example database might give a clue) 

 **Sample data (gitinExample.sql)**

@@ -107,7 +107,9 @@
 - check if gambas3 is installed correctly, with all the needed dependencies.
 - check if the directories and database settings are correct.  Check database acces settings manually from the commandline.
 - check the error messages (if any), check more recent version if exists, otherwise file a bug report, so that the problem can be handled.
-
+- check the changes.txt and changes.sql files; if the database changes, i.e. fields are added, you can cut-paste the modifications to e.g. phpMyAmin.
+- still database errors?  Make a backup of yours, and try with the supplied example database.
+- let me know where it stops if you run it from the IDE.
 -----

-*note: Last updated with version 0.2.2.*
+*note: Last updated with version 0.7.4.*

Install modified by cybrarian

cybrarian — Tue, 06 Feb 2018 10:19:23 -0000

--- v12
+++ v13
@@ -103,7 +103,7 @@

 **If the program doesn't run**

-- - if your compiled version doesn't run, check by running the program (from source) in the IDE
+- if your compiled version doesn't run, check by running the program (from source) in the IDE
 - check if gambas3 is installed correctly, with all the needed dependencies.
 - check if the directories and database settings are correct.  Check database acces settings manually from the commandline.
 - check the error messages (if any), check more recent version if exists, otherwise file a bug report, so that the problem can be handled.

Install modified by cybrarian

cybrarian — Tue, 06 Feb 2018 10:18:32 -0000

--- v11
+++ v12
@@ -88,19 +88,22 @@
 The messages "Result is not available" in the color "Description", "Example", etc, are normal on this moment, as there is no help information available yet.  You might fill it in the table `_helpdata`, or import it from a sample file.
 (I used DbInfoCode to fill the descriptions, examples and defaultvalues there.)

-**Sample data (not yet?)**
+**Sample data (gitinExample.sql)**

-The best way to explore an application, is with data.  I intend to supply a sample data set soon; that can be imported like the aforementioned structure sql file, and will be named something like gitin-sample-data.sql .
+The best way to explore an application, is with data.  I supply a sample data set; that can be imported like the aforementioned structure sql file, and is named gitinExample.sql .  Attention!  It kills all present Gitin data if installed already.  Change names/make backup.

 **Unplugged**
 If you want to use a "copy" of a common database (on your intranet instead of localhost), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).
-Also think about the ...
+Also think about the images in the directory ... (see settings).

 **Image files**

-The image files are stored locally, so that you can run the program on a laptop with your own database and picture files.  Of course you can share the pictures via a (local) webserver, so that anyone can update the picture on her/his local version. A script was supplied in the beginning, although no code for this use yet (might get the images from this url automatically).
+The image files are stored locally, so that you can run the program on a laptop with your own database and picture files.  Of course you can share the pictures via a (local) (web)server, so that anyone can update the picture on her/his local version. A script was supplied in the beginning, although no code for this use yet (might get the images from this url automatically).
+Personally I work like this: when a new device is created, I allways store the new image in a shared folder on a server.  Then I run a script on my laptop/desktop to sync (i.e. get the new image files).

 **If the program doesn't run**
+
+- - if your compiled version doesn't run, check by running the program (from source) in the IDE
 - check if gambas3 is installed correctly, with all the needed dependencies.
 - check if the directories and database settings are correct.  Check database acces settings manually from the commandline.
 - check the error messages (if any), check more recent version if exists, otherwise file a bug report, so that the problem can be handled.

Install modified by cybrarian

cybrarian — Sat, 09 Dec 2017 22:50:29 -0000

--- v10
+++ v11
@@ -84,11 +84,17 @@
 You will see that the columns now do have some header names for the content of that column.
 At the bottom you might see a message like "Result is not available" - that's ok, it is not available indeed.

-If you want to use a "copy" of a common database (on your intranet instead of localhost), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).
+If you choose one of the table buttons on top, you get the record-edit screen for that table.
+The messages "Result is not available" in the color "Description", "Example", etc, are normal on this moment, as there is no help information available yet.  You might fill it in the table `_helpdata`, or import it from a sample file.
+(I used DbInfoCode to fill the descriptions, examples and defaultvalues there.) 

 **Sample data (not yet?)**

 The best way to explore an application, is with data.  I intend to supply a sample data set soon; that can be imported like the aforementioned structure sql file, and will be named something like gitin-sample-data.sql .
+
+**Unplugged**
+If you want to use a "copy" of a common database (on your intranet instead of localhost), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).
+Also think about the ...

 **Image files**

@@ -99,9 +105,6 @@
 - check if the directories and database settings are correct.  Check database acces settings manually from the commandline.
 - check the error messages (if any), check more recent version if exists, otherwise file a bug report, so that the problem can be handled.

-
-
 -----

-
 *note: Last updated with version 0.2.2.*

Install modified by cybrarian

cybrarian — Sat, 09 Dec 2017 22:43:14 -0000

--- v9
+++ v10
@@ -28,7 +28,7 @@
 **Run**

 If the program runs*, it starts with a quite-emtpy-screen.  That's normal, you want to track YOUR it equipment, not mine.
-At the bottom you might see app messages about no access to the database: "cannot open databases..".  That's right - what database?
+At the bottom you might see app messages about no access to the database: "cannot open databases..".  That's right - what database? (ps: if you get this message afterwards, just check that your database server is started!)

 * no? Look further under "if the program doesn't run".*

Install modified by cybrarian

cybrarian — Sat, 09 Dec 2017 22:41:55 -0000

--- v8
+++ v9
@@ -25,12 +25,16 @@

 That's all.  Really, sorry.  You can start the program now by clicking on the link on the desktop.

+**Run**
+
+If the program runs*, it starts with a quite-emtpy-screen.  That's normal, you want to track YOUR it equipment, not mine.
+At the bottom you might see app messages about no access to the database: "cannot open databases..".  That's right - what database?
+
+* no? Look further under "if the program doesn't run".*
+
 **Configure**

-If the program runs*, it starts with a quite-emtpy-screen.  That's normal, you want to track YOUR it equipment, not mine.
 So you have to configure a database, I use mariadb as the mysql compatible database the program is intended for.
-
-* no? Look further under "if the program doesn't run".*

 In the configure window, you can also set the directory where Gitin has to store the images; these are stored locally, you can share them als simple files, just copy the directory.

@@ -73,8 +77,12 @@
 You see a lot of readable names, that will contain what they look like; data about devices, cables, locations, etc.
 The _dd_helpdata is a bit a special table; it contains data that helps you use the application, and has to contain some help and examples - what is not there yet when you install from zero.  This data contains the texts that describe the meaning of the fields, and give some sample possibilities in some data entry screens.  The application should also work without.

-On this moment, the program should be happy if you supply the connection data right in the configuration screen.
+**Run, 2**
+
+At this moment, the program should be happy if you supply the connection data right in the configuration screen.
 (otherwise you get an error message - check if you got all things right)
+You will see that the columns now do have some header names for the content of that column.
+At the bottom you might see a message like "Result is not available" - that's ok, it is not available indeed.

 If you want to use a "copy" of a common database (on your intranet instead of localhost), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).

Install modified by cybrarian

cybrarian — Sat, 09 Dec 2017 22:34:22 -0000

--- v7
+++ v8
@@ -73,7 +73,10 @@
 You see a lot of readable names, that will contain what they look like; data about devices, cables, locations, etc.
 The _dd_helpdata is a bit a special table; it contains data that helps you use the application, and has to contain some help and examples - what is not there yet when you install from zero.  This data contains the texts that describe the meaning of the fields, and give some sample possibilities in some data entry screens.  The application should also work without.

-If you want to use a copy of a common database (on your intranet), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).
+On this moment, the program should be happy if you supply the connection data right in the configuration screen.
+(otherwise you get an error message - check if you got all things right)
+
+If you want to use a "copy" of a common database (on your intranet instead of localhost), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).

 **Sample data (not yet?)**

Install modified by cybrarian

cybrarian — Sat, 09 Dec 2017 22:25:55 -0000

--- v6
+++ v7
@@ -75,6 +75,10 @@

 If you want to use a copy of a common database (on your intranet), you have to export these data (dump) and import in your laptop to be up to date, and use your laptop as passive instance (read-only).

+**Sample data (not yet?)**
+
+The best way to explore an application, is with data.  I intend to supply a sample data set soon; that can be imported like the aforementioned structure sql file, and will be named something like gitin-sample-data.sql .
+
 **Image files**

 The image files are stored locally, so that you can run the program on a laptop with your own database and picture files.  Of course you can share the pictures via a (local) webserver, so that anyone can update the picture on her/his local version. A script was supplied in the beginning, although no code for this use yet (might get the images from this url automatically).