Source install¶
Source 'install' bukan merupakan menginstal Odoo tapi menjalankannya langsung dari sumber.
Menggunakan Odoo source dapat lebih nyaman untuk developer modul karena lebih mudah mengakses ketimbang menggunakan paket penginstal.
Memulai dan mengakhiri Odoo lebih fleksibel dan jelas ketimbang layanan yang disetup dengan paket penginstal. Terlebih lagi, source install memungkinkan mengesampingkan pengaturan menggunakan command-line parameter tanpa harus mengedit file konfigurasi.
Terakhir, source install juga menyediakan kendali lebih besar atas setup sistem dan memungkinkan menyimpan (dan menjalankan) lebih dari satu versi Odoo secara berdampingan.
Dapatkan source¶
Ada dua cara untuk mendapatkan source code Odoo: sebagai arsip ZIP atau melalui Git.
Arsip¶
Edisi Community:
Edisi enterprise:
Git¶
Catatan
Merupakan persyaratan untuk menginstal Git, dan disarankan untuk memiliki pengetahuan dasar command-command Git sebelum melanjutkan.
Untuk kloning repositori Git, pilih antara kloning dengan HTTPS atau SSH. Di kebanyakan kasus, opsi terbaik adalah HTTPS. Namun, pilih SSH untuk berkontribusi ke source code Odoo atau saat mengikuti tutorial Developer Getting Started.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Catatan
Repositori Enterprise git tidak memiliki source code lengkap Odoo. Hanya koleksi add-on tambahan. Server code utama ada di edisi Community. Menjalankan versi Enterprise berarti menjalankan server dari versi Community dengan opsi addons-path ditetapkan ke folder dengan edisi Enterprise. Kloning masing-masing repositori Community dan Enterprise diperlukan untuk memiliki instalasi Odoo Enterprise yang bekerja.
Siapkan¶
Python¶
Odoo memerlukan Python 3.10 atau lebih baru untuk dijalankan.
Berubah pada versi 17: Persyaratan minimum diupdate dari Python 3.7 menjadi Python 3.10.
Gunakan manajer paket untuk mengunduh dan menginstal Python 3 bila diperlukan.
Unduh versi terkini Python 3 dan instal.
Selama penginstalan, centang Add Python 3 to PATH, lalu klik Customize Installation dan pastikan pip dicentang.
Catatan
Bila Python 3 sudah diinstal, pastikan versinya 3.10 atau lebih, karena versi-versi sebelumnya sudah tidak kompatibel dengan Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verifikasi bahwa pip juga diinstal untuk versi ini.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo menggunakan PostgreSQL sebagai sistem manajemen databasenya.
Gunakan manajer paket untuk mengunduh dan menginstal PostgreSQL (versi yang didukung: 12.0 atau lebih). Ini dapat diraih dengan menjalankan yang berikut:
$ sudo apt install postgresql postgresql-client
Unduh PostgreSQL (versi yang didukung: 12.0 atau lebih) dan instal.
Gunakan Postgres.app untuk mengunduh dan menginstal PostgreSQL (versi yang didukung: 12.0 atau lebih).
Tip
Agar command line tools yang dikelompokkan dengan Postgress.app tersedia, pastikan untuk setup variabel $PATH dengan mengikuti instruksi Postgres.app CLI tools.
Secara default, satu-satunya user adalah postgres. Karena Odoo melarang terhubung sebagai postgres, buat user PostgreSQL baru.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Catatan
Karena user PostgreSQL memiliki nama yang sama dengan login Unix, Anda dapat memasuki database tanpa password.
Tambahkan direktori
binPostgreSQL (secara default:C:\Program Files\PostgreSQL\<version>\bin) kePATH.Buat user postgres dengan password menggunakan pg admin gui:
Buka pgAdmin.
Klik dua kali server untuk membuat hubungan.
Pilih .
Masukkan username di field Role Name (contoh,
odoo).Buka tab Definition, masukkan password (contoh,
odoo), dan klik Save.Buka tab Privileges dan ganti Can login? menjadi
Yesdan Create database? buatYes.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Catatan
Karena user PostgreSQL memiliki nama yang sama dengan login Unix, Anda dapat memasuki database tanpa password.
Ketergantungan¶
Menggunakan paket distribusi adalah cara yang disarankan untuk menginstal ketergantungan. Secara alternatif, instal ketergantungan Python dengan pip.
Pada Debian/Ubuntu, command-command berikut seharusnya menginstal paket-paket yang diperlukan:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh script will parse the debian/control file and install the found packages.
Peringatan
Using pip may lead to security issues and broken dependencies; only do this if you know what you are doing.
Karena beberapa paket Python membutuhkan langkah kompilasi, mereka memerlukan pustaka sistem untuk diinstal.
Pada Debian/Ubuntu, command berikut seharusnya menginstal pustaka-pustaka yang dibutuhkan:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Ketergantungan Odoo didaftarkan di file requirements.txt yang berlokasi di root direktori Odoo Community.
Catatan
Paket Python di requirements.txt berdasarkan versi stable/LTS Debian/Ubuntu yang sesuai pada saat perilisan Odoo. Contohnya, untuk Odoo 15.0, versi paket python3-babel adalah 2.8.0 di Debian Bullseye dan 2.6.0 di Ubuntu Focal. Versi terendah lalu dipilih di requirements.txt.
Tip
Disarankan untuk tidak mencampur paket modul Python di antara instance Odoo atau dengan sistem yang berbeda-beda. Namun, Anda dapat menggunakan virtualenv untuk membuat environment Python yang terisolasi.
Navigasi ke lokasi instalasi Odoo Community (CommunityPath) dan jalankan run pip pada file requirement untuk menginstal persyaratan untuk user saat ini.
$ cd /CommunityPath
$ pip install -r requirements.txt
Sebelum menginstal ketergantungan, unduh dan instal Build Tools for Visual Studio. Pilih C++ build tools di tab Workloads dan instal mereka saat di-prompt.
Ketergantungan Odoo didaftarkan di file requirements.txt yang berlokasi di root direktori Odoo Community.
Tip
Disarankan untuk tidak mencampur paket modul Python di antara instance Odoo atau dengan sistem yang berbeda-beda. Namun, Anda dapat menggunakan virtualenv untuk membuat environment Python yang terisolasi.
Navigasi ke lokasi instalasi Odoo Community (CommunityPath) dan jalankan pip pada file requirement di terminal dengan hak akses Administrator:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Ketergantungan Odoo didaftarkan di file requirements.txt yang berlokasi di root direktori Odoo Community.
Tip
Disarankan untuk tidak mencampur paket modul Python di antara instance Odoo atau dengan sistem yang berbeda-beda. Namun, Anda dapat menggunakan virtualenv untuk membuat environment Python yang terisolasi.
Navigasi ke lokasi instalasi Odoo Community (CommunityPath) dan jalankan pip pada file requirement:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Catatan
Untuk bahasa-bahasa yang menggunakan antarmuka kanan-ke-kiri (seperti Bahasa Arab atau Ibrani), paket rtlcss diperlukan.
Unduh dan instal nodejs dan npm dengan package manager.
Instal
rtlcss:$ sudo npm install -g rtlcss
Unduh dan instal nodejs.
Instal
rtlcss:C:\> npm install -g rtlcssEdit variable
PATHdari environment system untuk menambahkan folder di lokasirtlcss.cmd(biasanya:C:\Users\<user>\AppData\Roaming\npm\).
Peringatan
wkhtmltopdf tidak diinstal melalui pip dan harus diinstal manual di versi 0.12.6 agar dapat mendukung header dan footer. Periksa wiki wkhtmltopdf untuk lebih banyak detail mengenai beragam macam versi.
Menjalankan Odoo¶
Setelah semua ketergantungan sukses disiapkan, Odoo dapat diluncurkan dengan menjalankan odoo-bin, antarmuka command-line dari server. Ini berlokasi di root direktori Odoo Community.
Untuk mengonfigurasi server, baik spesifikasikan command-line arguments atau configuration file.
Tip
Untuk edisi Enterprise, tambahkan path ke add-on enterprise ke argument addons-path. Ingat bahwa itu harus datang sebelum path lain di addons-path agar add-on dapat dimuat dengan benar.
Konfigurasi umum yang diperlukan adalah:
User dan password PostgreSQL.
Addon path custom di luar standar untuk memuat modul custom.
Cara tipikal untuk menjalankan server adalah:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dimana CommunityPath adalah path dari penginstalan Odoo Community, dan mydb adalah nama dari database PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Dimana CommunityPath adalah path dari penginstalan Odoo Community, dbuser adalah login PostgreSQL, dbpassword adalah password PostgreSQL, dan mydb adalah nama dari database PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dimana CommunityPath adalah path dari penginstalan Odoo Community, dan mydb adalah nama dari database PostgreSQL.
Setelah server dimulai (INFO log odoo.modules.loading: Modules loaded. dicetak), buka http://localhost:8069 di browser website dan login ke database Odoo dengan akun administrator standar: gunakan admin sebagai email dan, lagi, admin sebagai password.
Tip
Lihat juga