Difference between revisions of "Update 5.2"

From regify WIKI
Jump to navigation Jump to search
 
(22 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
== Generic information ==
 +
 +
The whole update with restart usually takes less than 7 minutes. But it can take 10 to 15 minutes or even more, depending on the amount of data in your system, the network connection and the system i/o speed. We suggest to plan for that.
 +
 
== Starting the upgrade ==
 
== Starting the upgrade ==
 +
 +
=== 1) Enable maintenance mode ===
 +
 +
Please log-in to your web-administration and go to "Provider maintenance". Enable maintenance mode by clicking "Enable maintenance mode" on the upper left.
 +
 +
=== 2) Do the update ===
 +
 
To update your regify provider appliance, please log in via SSH (or PuTTY).  
 
To update your regify provider appliance, please log in via SSH (or PuTTY).  
  
Line 8: Line 19:
 
to run the appliance menu.  
 
to run the appliance menu.  
  
Now select the first menu item "Check for updates". There is a huge list of packages. Use TAB to switch focus to "Yes" and press Enter to start the update. The update process can take up to 10 minutes. If you are running a redundant system, do this directly one after the other on each appliance.
+
Now select the first menu item "Check for updates". There is a huge list of packages. Use TAB to switch focus to "Yes" and press Enter to start the update. '''The update process can take 10 to 15 minutes or even more''', depending on the amount of data in your system and the speed of your machines.
 +
 
 +
==== Notes about Cross-Master-Replication ====
 +
If you are running a redundant system in cross-master-replication, '''start with the appliance that is the currently active system''' (working the traffic). Upgrade the second appliance directly after you upgraded the active system.
 +
 
 +
==== Notes about Master-Slave-Replication ====
 +
If you are running a redundant system in master-slave-replication, '''start with the master system'''. Upgrade the slave directly after the master appliance.
 +
 
 +
=== 3) Disable maintenance mode ===
 +
 
 +
Now, please re-login to your web-administration and go to "Provider maintenance". Disable maintenance mode by clicking "Remove maintenance mode" on the upper left.
  
 
== Finish with restart==
 
== Finish with restart==
The update also updates the kernel of the system, so you need to make a restart after the update has finished. Logged in using SSH (PuTTY), you can restart the appliance using the appliance menu "Appliance..." -> "Other Settings..." -> "Reboot the appliance".
+
The update also updates the kernel of the system, so you need to make a restart after the update has finished. The upate will ask you for a restart and you should answer with YES.
 +
 
 +
'''NOTE:''' Logged in using SSH (PuTTY), you can restart the appliance using the appliance menu "Appliance..." -> "Other Settings..." -> "Reboot the appliance".
  
 
In case you log in with root account, you can also enter
 
In case you log in with root account, you can also enter
  
 
  shutdown -r now
 
  shutdown -r now
 +
 +
'''NOTE:''' The shutdown can take a minute or even more. Please do not power off the machine during restart manually.
  
 
== ToDo after upgrading ==
 
== ToDo after upgrading ==
 
=== System in maintenance mode? ===
 
=== System in maintenance mode? ===
If you turned on maintenance mode before upgrade, the system will come up in maintenance mode after update. Please enter Administration and use "Provider maintenance" dialogue to restore operation.
+
If you turned on maintenance mode before upgrade, the system will come up in maintenance mode after update. Please enter Administration and use "Provider maintenance" dialog to restore operation.
  
 
=== CSS modifications ===
 
=== CSS modifications ===
We modified the CSS structure and especially the units. All units are now given in rem. Rem means relative to the root html element font size. By this, switching the font size for the html tag element will switch the whole scaling of all the dialoges and elements.
+
==== Size and scaling ====
 +
In order to respect the growing number of huge screens and better screen resolutions, we modified the CSS structure and especially the used sizing-units of the regify provider CSS. All units are now given in '''rem'''. Rem means relative to the root ''html'' element font size. By this, switching the font size for the ''html'' element will switch the whole scaling of all the dialogs and elements ([https://www.digitalocean.com/community/tutorials/css-rem-vs-em-units more information]).
  
We implemented automatic size due to the following rules:
+
As a side effect, you can simply zoom your pages by defining a different font size for the ''html'' element using '''_customized.css'''.
  
* Screen width below 1200px, the font size is 12px
+
Thus, we recommend you to edit your CSS in '''_customized.css''', especially for the logo, to also use '''rem''' or '''em''' units for sizing and positioning. Scale your webbrowser and make sure the logo scales correctly with the border elements.
* Screen width between 1200px and 1800px, the font size is 1% of the screen width (1200px => 12px)
 
* Screen width is bigger than 1800px, the font size is 18px
 
* All elements properties, positions and sizes are based on rem, too (margins, padding, border etc). So their sizes will change with the font size, too.
 
  
Thus, we recommend you to edit your CSS in '''_customized.css''', especially for the logo, to also use rem as unit for sizing and positioning.
+
==== Branding and Corporate Identity ====
 +
If you changed the colors in general (eg all button colors), we recommend you to re-do using the current CSS template from the [[Provider_customization|Provider Customization]] page. This is the fastest way to cover all elements and icons for a quick branding.
  
 
=== Images ===
 
=== Images ===
 
We replaced most of the used icons and symbols by fonticons. Due to this, it is more easy to change colors and also it is good in all scalings. Please verify any images you changed by using '''_customized.css'''.
 
We replaced most of the used icons and symbols by fonticons. Due to this, it is more easy to change colors and also it is good in all scalings. Please verify any images you changed by using '''_customized.css'''.
 +
 +
=== BubbleHelp ===
 +
If you changed the BubbleHelp class, you very likely have to re-do your styling because the CSS has changed very much. Or remove your BubbleHelp modifications and stay with the default :-)
  
 
== Check ==
 
== Check ==
 
Please log in to your web administration now and check for any problems or error messages.
 
Please log in to your web administration now and check for any problems or error messages.

Latest revision as of 15:08, 25 March 2022

Generic information

The whole update with restart usually takes less than 7 minutes. But it can take 10 to 15 minutes or even more, depending on the amount of data in your system, the network connection and the system i/o speed. We suggest to plan for that.

Starting the upgrade

1) Enable maintenance mode

Please log-in to your web-administration and go to "Provider maintenance". Enable maintenance mode by clicking "Enable maintenance mode" on the upper left.

2) Do the update

To update your regify provider appliance, please log in via SSH (or PuTTY).

In case you log in with root account, you have to enter

providerConfig

to run the appliance menu.

Now select the first menu item "Check for updates". There is a huge list of packages. Use TAB to switch focus to "Yes" and press Enter to start the update. The update process can take 10 to 15 minutes or even more, depending on the amount of data in your system and the speed of your machines.

Notes about Cross-Master-Replication

If you are running a redundant system in cross-master-replication, start with the appliance that is the currently active system (working the traffic). Upgrade the second appliance directly after you upgraded the active system.

Notes about Master-Slave-Replication

If you are running a redundant system in master-slave-replication, start with the master system. Upgrade the slave directly after the master appliance.

3) Disable maintenance mode

Now, please re-login to your web-administration and go to "Provider maintenance". Disable maintenance mode by clicking "Remove maintenance mode" on the upper left.

Finish with restart

The update also updates the kernel of the system, so you need to make a restart after the update has finished. The upate will ask you for a restart and you should answer with YES.

NOTE: Logged in using SSH (PuTTY), you can restart the appliance using the appliance menu "Appliance..." -> "Other Settings..." -> "Reboot the appliance".

In case you log in with root account, you can also enter

shutdown -r now

NOTE: The shutdown can take a minute or even more. Please do not power off the machine during restart manually.

ToDo after upgrading

System in maintenance mode?

If you turned on maintenance mode before upgrade, the system will come up in maintenance mode after update. Please enter Administration and use "Provider maintenance" dialog to restore operation.

CSS modifications

Size and scaling

In order to respect the growing number of huge screens and better screen resolutions, we modified the CSS structure and especially the used sizing-units of the regify provider CSS. All units are now given in rem. Rem means relative to the root html element font size. By this, switching the font size for the html element will switch the whole scaling of all the dialogs and elements (more information).

As a side effect, you can simply zoom your pages by defining a different font size for the html element using _customized.css.

Thus, we recommend you to edit your CSS in _customized.css, especially for the logo, to also use rem or em units for sizing and positioning. Scale your webbrowser and make sure the logo scales correctly with the border elements.

Branding and Corporate Identity

If you changed the colors in general (eg all button colors), we recommend you to re-do using the current CSS template from the Provider Customization page. This is the fastest way to cover all elements and icons for a quick branding.

Images

We replaced most of the used icons and symbols by fonticons. Due to this, it is more easy to change colors and also it is good in all scalings. Please verify any images you changed by using _customized.css.

BubbleHelp

If you changed the BubbleHelp class, you very likely have to re-do your styling because the CSS has changed very much. Or remove your BubbleHelp modifications and stay with the default :-)

Check

Please log in to your web administration now and check for any problems or error messages.