Masalah Umum Instalasi & Pembaruan Redmine

Selama pembaruan aplikasi, pesan kesalahan yang berisi "Anda memiliki kesalahan dalam sintaks SQL Anda; periksa manual yang sesuai dengan versi server MySQL Anda untuk sintaks yang benar untuk digunakan dekat ..." muncul di log.

Penyebab
Ini berarti database Anda sudah ketinggalan zaman dan tidak dapat bekerja dengan permintaan yang dikirimkan oleh aplikasi kami. Database hanya tidak mengerti.

Solusi
Anda perlu memperbarui database Anda.

Bagaimana cara memperbarui database?
Deskripsi terperinci ada di Basis Pengetahuan.

1. Perbaiki izin dengan perintah chgrp dan chown sesuai dengan pengaturan server (misalnya chgrp -R www-data public_html)
2. Jalankan instalasi lagi bundle exec rake easyproject:install RAILS_ENV=production yang akan menghapus cache (jika Anda menjalankannya oleh root, itu tidak akan berhasil)
3. Restart server

Jika Anda menggunakan mesin virtual yang disediakan oleh Easy Software, jalankan dengan pengguna mudah:

sudo chown -R mudah /home/mudah/saat ini
(di mesin yang lebih lama - sudo chown -R mudah /srv/easyredmine/public_html)

sudo chgrp -R mudah /home/mudah/saat ini
(di mesin yang lebih lama - sudo chgrp -R mudah /srv/easyredmine/public_html)

cd /home/mudah/saat ini
(di mesin yang lebih lama - cd /srv/easyredmine/public_html)

bundle exec rake easyproject:install RAILS_ENV=production

sudo service puma@your.domain.name restart

Jangan lupa untuk mengatur izin untuk semua folder yang diperlukan.

Berikut adalah beberapa petunjuk apa yang dapat Anda lakukan jika Anda mengalami kesalahan 500.

• jalankan Easy server requirements check dan coba perbaiki validasi yang gagal
• cadangkan database Anda
• unduh paket terbaru dari Client Zone
• pastikan bahwa webserver memiliki akses penuh ke folder public, files, log, tmp
• jalankan bundle install --without development test
• jalankan bundle exec rake easyproject:install RAILS_ENV=production
• restart application server
• hapus plugin Redmine pihak ketiga (juga dari database)
• hubungi kami di support@easyredmine.com dan lampirkan log/production.log

There are many possible causes of this error. Here are a few tips:

• browser cache problem - try deleting cache from the browser
• dns problem
• server setting problem

First check your connection and network (verify that server is reachable by using a ping command or traceroute command). Firewall server side.

If all above seems fine, try to get some information from nginx error.logs. Check nginx error.log at the server side - /var/log/nginx/error.log

Double check that your nginx configuration matches the standard. Standard nginx configuration can be found here:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine

Example of an nginx configuration (as is used by Easy Software). It's quite similar to official one only few variables are optimized:

user www-data;
worker_processes  8;

worker_rlimit_nofile 60000;

error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;

events {
    worker_connections  10240;
    # multi_accept on;
}

http {
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;  # dont use SSLv3 ref: POODLE
    include       /etc/nginx/mime.types;
                default_type  application/octet-stream;
                server_names_hash_bucket_size 2048;

    access_log  /var/log/nginx/access.log;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;
    tcp_nodelay        on;

    send_timeout 1800;
    client_body_timeout  1800;
    client_header_timeout 1800;
    proxy_read_timeout 1800;
    client_max_body_size 220m;
    fastcgi_buffer_size 64K;
    fastcgi_buffers 128 16k;
    proxy_max_temp_file_size 0;
    types_hash_max_size 4096;
    types_hash_bucket_size 128;

    proxy_busy_buffers_size   256k;
    proxy_buffers 8 256k;
    proxy_buffer_size 256k;

    gzip  on;
    gzip_disable "MSIE [1-6]\.(?!.*SV1)";

    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
    include /etc/nginx/sites-auto/*;
}

Other possible causes of 502 error include...

Unicorn is not running at all, due to

• Insufficient permissions
• Wrong version of passenger
• Wrong Ruby version
• Missing gems
• Broken filesystem

To find out the exact problem, you need to check error logs in unicorn or apache + application log from Easy Redmine (log/production.log)

Timeout

If low timeout is configured, this error will appear on:

• large exports
• overload of server
• rake tasks run from the GUI

Limit of MySQL connections

Make sure you have a sufficient number of connections allowed to MySQL. It depends on the number of users, but you should have at least a 100 allowed.

Kesalahan ini terjadi mulai dari versi 2018 1.2 (platform 04.00 dan yang lebih tinggi)

Kesalahan selama instalasi upgrade yang berisi beberapa hal berikut.

[!] Ada kesalahan saat mengurai `Gemfile`:

[!] Ada kesalahan saat mengurai `Gemfile`: tidak dapat memuat file tersebut --

#  plugin 'rys-bundler', github: 'easysoftware/rys-bundler', branch: 'master'
 >  Plugin.hook('rys-gemfile', self)

Bundler tidak dapat melanjutkan.

Ini disebabkan oleh versi redmine installer yang sudah usang.

Solusi:

Sebelum menginstal upgrade

$ gem install redmine-installer

Pastikan wkhtmltopdf terpasang dan berjalan ( wkhtmltopdf membutuhkan X server atau emulasi lainnya)
Cobalah menggunakan perintah ini: "wkhtmltopdf google.com google.pdf"

Tambahkan ke konfigurasi proxy Anda:

proxy_set_header X-Forwarded-Proto https

Jika instalasi gagal, jalankan secara manual:

$ bundle update
$ rake db:migrate
$ rake redmine:plugins:migrate

Pastikan webserver Anda mendukung ukuran sebenarnya dari alamat URL

Pastikan Anda TIDAK menggunakan webserver Webrick!

• pastikan Anda memiliki versi terbaru dari webserver dan Ruby
• konfigurasi ulang kueri filter lambat untuk menampilkan lebih sedikit bidang
• atur ulang CRON Anda agar tidak diluncurkan terlalu sering
• lihat studi kasus ini - Pempercepatan Rails tanpa menyentuh kode Ruby
• periksa konfigurasi Anda - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server

Salin folder files dari Redmine lama Anda.

Pastikan webserver Anda memiliki akses penuh ke folder public, files, log, tmp

Komit baru ke dalam repositori Anda tidak akan tercermin di Easy Redmine kecuali jika mereka diambil oleh aplikasi. Anda perlu mengatur webhook pada klien repositori Anda (github, gitlab, TortoiseSVN,...) dengan informasi tentang instansi Easy Redmine Anda.

1. Pergi ke administrasi >> pengaturan >> repositori
2. Aktifkan WS untuk manajemen repositori
3. Hasilkan kunci API
   
4. Simpan
5. Pergi ke klien repositori Anda
6. Tambahkan webhook
   Misalkan situs Anda adalah easyredmine.company.com
   Untuk git - https://easyredmine.company.com/sys/git_fetcher
   atau https://easyredmine.company.com/sys/git_fetcher?key=[kunci API]
    - tergantung pada pengaturan klien, ini bisa membutuhkan URL tunggal atau kunci ke dalam bidang yang berbeda
   Untuk SVN - https://easyredmine.company.com/sys/fetch_changesets
   atau https://easyredmine.company.com/sys/fetch_changesets?key=[kunci API]

Dari poin 5, semuanya tergantung pada klien repositori dan tidak terkait dengan pengaturan Easy Redmine. Ini adalah sesuatu yang harus Anda verifikasi setelah instalasi bersih atau upgrade dari Redmine.

Ketika mengkonfigurasi domain Easy Redmine Anda, pastikan untuk menggunakan setidaknya domain tingkat pertama, misalnya http://myeasyredmine.com daripada hanya http://myeasyredmine. Beberapa browser mungkin mengalami masalah dalam mengaksesnya.

Pergi ke Administrasi >> Pengaturan >> Pemberitahuan Email
dan verifikasi bahwa alamat DARI sudah benar.

Harus sama (atau setidaknya dari server SMTP yang sama) seperti dalam file konfigurasi. Jika tidak, beberapa layanan email (gmail, yahoo, dll.) mungkin menolak pemberitahuan.

Periksa konfigurasi Anda sesuai dengan artikel ini di Basis Pengetahuan.

Untuk memverifikasi bahwa konfigurasi sudah benar, coba periksa apakah dapat terhubung ke server email dari server Easy Redmine Anda menggunakan telnet.

telnet your.domain.here nomor_port_di_sini (Contoh: telnet gmail.com 465)

Ini akan menunjukkan apakah Anda benar-benar dapat terhubung ke mailserver Anda atau ada masalah dalam konfigurasi mailserver Anda.

Disebabkan oleh masalah dengan komponen ekspor wkhtmltopdf

Ini adalah solusi yang diusulkan.

Server tanpa antarmuka

Dapatkan versi wkhtmltopdf yang diperlukan dari http://wkhtmltopdf.org/downloads.html

Contoh (Anda harus bekerja dengan detail lingkungan Anda sendiri):

1. sudo apt-get install xvfb xauth
2. wget https://bitbucket.org/wkhtmltopdf/wkhtmltopdf/downloads/wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
3. sudo dpkg -i wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
4. sudo apt-get -f install
5. sudo mv /usr/local/bin/wkhtmltopdf /usr/local/bin/xwkhtmltopdf
6. echo 'exec xvfb-run -a -s "-screen 0 640x480x16" xwkhtmltopdf "$@"' | sudo tee /usr/local/bin/wkhtmltopdf >/dev/null
7. sudo chmod a+x /usr/local/bin/wkhtmltopdf

Hanya server non-antarmuka

1. Anda perlu menginstal wkhtmltopdf di server Anda dalam PATH
   (apt-get install wkhtmltox, yum install wkhtmltox)
   Harus diinstal dalam bundler, jika tidak mungkin tidak berfungsi setelah memperbarui Easy Redmine
2. Pastikan program berfungsi dengan benar (jalankan dari konsol misalnya wkhtmltopdf https://easyredmine.com homepage.pdf)
3. jalankan ulang rake easyproject:install RAILS_ENV=production
4. restart server

Pemasangan Plugin

1. JANGAN menginstal plugin sebagai pengguna ROOT
   
2. Pertama, hapus semua plugin Easy Gantt lama jika ada (plugins/easy_gantt*)
   
3. Salin semua plugin yang telah di-zip ke REDMINE_ROOT/plugins
   
4. Pada REDMINE_ROOT

Setelah itu, restart server.

Tonton tutorial video

Persyaratan untuk pemasangan yang sukses

• Versi Redmine: Kompatibel dengan Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
• Versi Ruby: 2.3+ (disarankan 2.6.)
• Tipe Database: MySQL (disarankan), PostgreSQL

Ikuti prosedur pemasangan di #install. Periksa apakah log pemasangan tidak mengandung kesalahan. Jika ada, coba selesaikan sesuai dengan deskripsi, atau hubungi support@easyredmine.com dengan bagian kesalahan log terlampir.

Pemasangan di Bitnami

Bitnami tidak diuji atau dijamin. Jika pemasangan gagal, jalankan secara manual:

Dokumentasi / Pengetahuan Gantt

• Easy Gantt PRO