Update

Perform the update from the user created for Totum work. If bin/totum git-update or git pull is executed from root, you will encounter an access error and your server will be inoperable!

Using the console utility

ONCE AGAIN, EXTRA IMPORTANT!!! THE UPDATE IS PERFORMED ONLY FROM THE USER UNDER WHICH TOTUM IS RUNNING AND ONLY FROM THE TOTUM INSTALLATION FOLDER!!!

IF YOU LOGGED IN AS ROOT OR SUDO-USER, YOU NEED TO FIRST SWITCH TO THE TOTUM USER: su totum

THEN GO TO THE INSTALLATION FOLDER: cd ~/totum-mit

AND ONLY THEN EXECUTE THE UPDATE COMMAND

Execute from the Totum root folder:

bin/totum git-update

If you see the message:

fatal: detected dubious ownership in repository at '/home/totum/totum-mit'
To add an exception for this directory, call:

        git config --global --add safe.directory /home/totum/totum-mit

This means you are operating from the wrong user!

Attention! Sometimes, when there are many requests from the subnet where your server is located to the GitHub server, you will be asked to enter your authentication details

*** Please tell me who you are.

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

In this case, you will need to enter your GitHub credentials (replace USERNAME_IN_GITHUB and EMAIL_IN_GITHUB with yours):

git config --local user.name USERNAME_IN_GITHUB

git config --local user.email EMAIL_IN_GITHUB

Check:

git config --list --local

Transition between major versions

If you are updating from version 4 to 6, then see these instructions ⟶

Execution result

Example of a successful command execution result:

totum@totum:~/totum$ bin/totum git-update
remote: Enumerating objects: 28, done.
remote: Counting objects: 100% (28/28), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 16 (delta 14), reused 16 (delta 14), pack-reused 0
Unpacking objects: 100% (16/16), done.
From https://github.com/totumonline/totum-mit
 * branch            master     -> FETCH_HEAD
 080411e..171aec7  master     -> origin/master
Updating 080411e..171aec7
Fast-forward
 http/html.html                           |  2 +-
 http/js/main.js                          |  2 +-
 totum/moduls/Table/ReadTableActions.php  | 41 +++++++++++++++++++++++++++++++----------
 totum/templates/html.html                |  2 +-
 totum/templates/page_template.php        |  2 +-
 totum/templates/page_template_simple.php |  2 +-
 6 files changed, 36 insertions(+), 15 deletions(-)
Loading composer repositories with package information
Installing dependencies from lock file
Nothing to install or update
Generating autoload files
6 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
update totum with source totum_ru from sys_update
Set fields of table tables_fields
Set fields of table tables
Set settings in table tables for "tables" and "tables_fields"
     Update settings table "ttm__remotes"
     Update settings table "ttm__tmp_change_tree_links"
     Update settings table "auth_log"
     Update settings table "calcstable_versions"
     Update settings table "calcstable_cycle_version"
     Update settings table "calc_fields_log"
     Update settings table "ttm__charts"
     Update settings table "tree"
     Update settings table "ttm__load_updates"
     Update settings table "ttm__change_field_name"
     Update settings table "ttm__change_fields_list"
     Update settings table "table_categories"
     Update settings table "notification_codes"
     Update settings table "crons"
     Update settings table "settings"
     Update settings table "notifications"
     Update settings table "ttm__updates"
     Update settings table "users"
     Update settings table "ttm__users_online"
     Update settings table "roles"
     Update settings table "ttm__update_create"
     Update settings table "ttm__update_ids"
     Update settings table "tables_fields"
     Update settings table "tables"
     Update settings table "log_structure"
     Update settings table "ttm__manage_notifications"
     Update settings table "print_templates"
     Update settings table "panels_view_settings"
Add and modify fields for 30 tables
Add tree links and anchors
Load data to tables and exec codes from schema
    exec code: =: if(condition: $#type="install"; then: $set)...
    exec code: =: if(condition: $#type="install"; then: $set)...
    update @ttm__updates.h_matches/totum_ru
Set default tables and sort for new tree branches
totum@totum:~/totum$

PRO Held fields

During the Totum update, field settings are overwritten with data from the update. If you have modified a system field for your tasks and need it not to be overwritten during the update, you need to mark it as held.

To do this, you need to fill in the h_held_fields field of the Settings table. The keys use the table names and the content of the keys are lists of the names of the held fields.

{
  "settings": [
    "h_user_settings_buttons"
  ]
}

During the update, the Console will display a table with fields that were in the loaded update but were not updated due to being held.

⟵ hear there ⟶