āļāļąāļāđāļāļāļāļēāļĢāđāļāđāđāļāļāđāļāļāļāļāļĢāđāļāļÂķ
āđāļāļ°āļāļģÂķ
In order to benefit from the latest improvements, security fixes, bug corrections and performance boosts, you may need to update your NightPOS installation from time to time.
This guide only applies when are using NightPOS on your own hosting infrastructure. If you are using one of the NightPOS Cloud solutions, updates are automatically performed for you.
āļāļģāļĻāļąāļāļāđāđāļāļāļēāļ°āļāļĩāđāđāļāļĩāđāļĒāļ§āļāđāļāļāļāļąāļāļāļēāļĢāļāļąāļāđāļāļāļāļāļāļāđāđāļ§āļĢāđāļĄāļąāļāļāļ°āļāļģāđāļŦāđāđāļāļīāļāļāļ§āļēāļĄāļŠāļąāļāļŠāļ āļāļąāļāļāļąāđāļ āļāđāļāđāļāļāļĩāđāđāļāđāļāļāļģāļāļģāļāļąāļāļāļ§āļēāļĄāđāļāļ·āđāļāļāļāđāļāļāļēāļāļŠāđāļ§āļ:
- Updating (an NightPOS installation)
Refers to the process of obtaining the latest revision of the source code for your current NightPOS Edition. For example, updating your NightPOS Enterprise 13.0 to the latest revision. This does not directly cause any change to the contents of your NightPOS database, and can be undone by reinstalling the previous revision of the source code.
- Upgrading (an NightPOS database)
Refers to a complex data processing operation where the structure and contents of your database is permanently altered to make it compatible with a new release of NightPOS. This operation is irreversible and typically accomplished via NightPOS's database upgrade service, when you decide to switch to a newer release of NightPOS. Historically, this process has also been known as a "migration" because it involves moving data around inside the database, even though the database may end up at the same physical location after the upgrade.
This page describes the typical steps needed to update an NightPOS installation to the latest version. If you'd like more information about upgrading a database, please visit the NightPOS Upgrade page instead.
āđāļāļĒāļŠāļĢāļļāļÂķ
Updating NightPOS is accomplished by simply reinstalling the latest version of your NightPOS Edition on top of your current installation. This will preserve your data without any alteration, as long as you do not uninstall PostgreSQL (the database engine that comes with NightPOS).
āļāđāļāļĄāļđāļĨāļāđāļēāļāļāļīāļāļŦāļĨāļąāļāļŠāļģāļŦāļĢāļąāļāļāļēāļĢāļāļąāļāđāļāļāļāļ·āļ āļāļđāđāļĄāļ·āļāļāļēāļĢāļāļīāļāļāļąāđāļ āļāļēāļĄāļŦāļĨāļąāļāļāļĢāļĢāļāļ° āļāļķāđāļāļāļāļīāļāļēāļĒāļ§āļīāļāļĩāļāļēāļĢāļāļīāļāļāļąāđāļāļāļąāđāļ§āđāļ
Updating is also most appropriately accomplished by the person who deployed NightPOS initially, because the procedure is very similar.
Note
We always recommend to download a complete new up-to-date NightPOS version, rather than manually applying patches, such as the security patches that come with Security Advisories. The patches are mainly provided for installations that are heavily customized, or for technical personnel who prefer to apply minimal changes temporarily while testing a complete update.
Step 1: Download an updated NightPOS versionÂķ
The central download page is https://www.nightpos.com/page/download. If you see a "Buy" link for the NightPOS Enterprise download, make sure you are logged into NightPOS.com with the same login that is linked to your NightPOS Enterprise subscription.
Alternatively, you can use the unique download link that was included with your NightPOS Enterprise purchase confirmation email.
Note
āđāļĄāđāļāļģāđāļāđāļāļāđāļāļāļāļēāļ§āļāđāđāļŦāļĨāļāđāļ§āļāļĢāđāļāļąāļāļāļąāļāđāļāļāļŦāļēāļāļāļļāļāļāļīāļāļāļąāđāļāļāđāļēāļ Github (āļāļđāļāđāļēāļāļĨāđāļēāļ)
āļāļąāđāļāļāļāļāļāļĩāđ 2: āļŠāļģāļĢāļāļāļāđāļāļĄāļđāļĨāļāļēāļāļāđāļāļĄāļđāļĨāļāļāļāļāļļāļÂķ
āļāļąāđāļāļāļāļāļāļēāļĢāļāļąāļāđāļāļāļāđāļāļāļāđāļēāļāļāļĨāļāļāļ āļąāļĒāđāļĨāļ°āđāļĄāđāļāļ§āļĢāđāļāļĨāļĩāđāļĒāļāđāļāļĨāļāļāđāļāļĄāļđāļĨāļāļāļāļāļļāļ āļāļĒāđāļēāļāđāļĢāļāđāļāļēāļĄ āļāļēāļāļāļĩāđāļāļĩāļāļĩāđāļŠāļļāļāđāļŠāļĄāļāļāļ·āļāļāļēāļĢāļŠāļģāļĢāļāļāļāļēāļāļāđāļāļĄāļđāļĨāļāļąāđāļāļŦāļĄāļāļāđāļāļāļāļĩāđāļāļ°āļāļģāđāļāļīāļāļāļēāļĢāđāļāļĨāļĩāđāļĒāļāđāļāļĨāļāđāļāđ āļāļąāļāļāļēāļĢāļāļīāļāļāļąāđāļāļāļāļāļāļļāļ āđāļĨāļ°āļāļąāļāđāļāđāļāđāļ§āđāļāļĩāđāđāļŦāļāļŠāļąāļāđāļŦāđāļāļāļĩāđāļāļĨāļāļāļ āļąāļĒāļāļāļāļāļĄāļāļīāļ§āđāļāļāļĢāđāđāļāļĢāļ·āđāļāļāļāļ·āđāļ
āļŦāļēāļāļāļļāļāđāļĄāđāđāļāđāļāļīāļāļāļēāļĢāđāļāđāļāļēāļāļŦāļāđāļēāļāļāļāļąāļ§āļāļąāļāļāļēāļĢāļāļēāļāļāđāļāļĄāļđāļĨ (āļāļđāđāļŦāļāļļāļāļĨāļāļĩāđāļāļļāļāļāļ§āļĢāļāļīāļ āļāļĩāđāļāļĩāđ) āļāļļāļāļŠāļēāļĄāļēāļĢāļāđāļāđāļŦāļāđāļēāļāļāļāļĩāđ (āļĨāļīāļāļāđāļāļĩāđāļāđāļēāļāļĨāđāļēāļāļāļāļāļŦāļāđāļēāļāļāļāļēāļĢāđāļĨāļ·āļāļāļāļēāļāļāđāļāļĄāļđāļĨ) āđāļāļ·āđāļāļāļēāļ§āļāđāđāļŦāļĨāļāļāđāļāļĄāļđāļĨāļŠāļģāļĢāļāļāļāļāļāļāļēāļāļāđāļāļĄāļđāļĨāļāļāļāļāļļāļ āļŦāļēāļāļāļļāļāļāļīāļāđāļāđāļāļēāļ āđāļŦāđāđāļāđāļāļąāđāļāļāļāļāđāļāļĩāļĒāļ§āļāļąāļāļāļąāļāļāļēāļĢāļŠāļģāļĢāļāļāļāđāļāļĄāļđāļĨāļāļāļāļīāļāļāļāļāļļāļ
āļāļąāđāļāļāļāļāļāļĩāđ 3: āļāļīāļāļāļąāđāļāđāļ§āļāļĢāđāļāļąāļāļāļąāļāđāļāļÂķ
āđāļĨāļ·āļāļāļ§āļīāļāļĩāļāļēāļĢāļāļĩāđāļāļĢāļāļāļąāļāļāļēāļĢāļāļīāļāļāļąāđāļāļāļąāļāļāļļāļāļąāļāļāļāļāļāļļāļ:
āļāļąāļ§āļāļīāļāļāļąāđāļāđāļāļāđāļāđāļāđāļāļÂķ
If you installed NightPOS with an installation package downloaded on our website (the recommended method), updating is very simple. All you have to do is download the installation package corresponding to your system (see step #1) and install it on your server. They are updated daily and include the latest security fixes. Usually, you can simply double-click the package to install it on top of the current installation. After installing the package, be sure to restart the NightPOS service or reboot your server, and you're all set.
āļāļēāļĢāļāļīāļāļāļąāđāļāđāļŦāļĨāđāļāļāļĩāđāļĄāļē (Tarball)Âķ
If you have originally installed NightPOS with the "tarball" version (source code archive), you have to replace the installation directory with a newer version. First download the latest tarball from NightPOS.com. They are updated daily and include the latest security fixes (see step #1) After downloading the package, extract it to a temporary location on your server.
You will get a folder labeled with the version of the source code, for example "nightpos-13.0+e.20190719", that contains a folder "nightpos.egg-info" and the actual source code folder named "nightpos" (for NightPOS 10 and later) or "openerp" for older versions. You can ignore the nightpos.egg-info folder. Locate the folder where your current installation is deployed, and replace it with the newer "nightpos" or "openerp" folder that was in the archive you just extracted.
Be sure to match the folder layout, for example the new "addons" folder included in the source code should end up exactly at the same path it was before. Next, watch out for any specific configuration files that you may have manually copied or modified in the old folder, and copy them over to the new folder. Finally, restart the NightPOS service or reboot the machine, and you are all set.
āļāļēāļĢāļāļīāļāļāļąāđāļāđāļŦāļĨāđāļāļāļĩāđāļĄāļē (Github)Âķ
If you have originally installed NightPOS with a full Github clone of the official repositories, the update procedure requires you to pull the latest source code via git. Change into the directory for each repository (the main NightPOS repository, and the Enterprise repository), and run the following commands:
git fetch
git rebase --autostash
The last command may encounter source code conflicts if you had edited the NightPOS source code locally. The error message will give you the list of files with conflicts, and you will need to resolve the conflicts manually, by editing them and deciding which part of the code to keep.
āļŦāļĢāļ·āļāļāļĩāļāļāļēāļāļŦāļāļķāđāļ āļŦāļēāļāļāļļāļāļāđāļāļāļāļēāļĢāļĒāļāđāļĨāļīāļāļāļēāļĢāđāļāļĨāļĩāđāļĒāļāđāļāļĨāļāļāļĩāđāļāļąāļāđāļĒāđāļāļāļąāļāđāļĨāļ°āļāļđāđāļāļ·āļāđāļ§āļāļĢāđāļāļąāļāļāļĒāđāļēāļāđāļāđāļāļāļēāļāļāļēāļĢ āļāļļāļāļŠāļēāļĄāļēāļĢāļāđāļāđāļāļģāļŠāļąāđāļāļāđāļāđāļāļāļĩāđ:
git reset --hard
Finally, restart the NightPOS service or reboot the machine, and you should be done.
āļāđāļāļāđāļāļāļĢāđÂķ
Please refer to our Docker image documentation for specific update instructions.