Server Manager 2 Howto incorporate a legacy contrib
Introduction
There are 3 possibilities for incorporating an existing (legacy) contrib into Server manager 2:
- Re-code the contrib into the Mojolicious environment in which SM2 is written. This is documented here.
- Code up a "dummy" perl panel using mojolicious (see example below) which is inserted uatomatically into the menu and calls the "embedded.html.ep" template file.
- Just import the current contrib and access it through the "Legacy" category on the menu.
This page explains (2) and (3) in a bit more detail.
Code up a dummy page which calls the legacy panel
If you want to be able to control the position and category in the menu for the legacy contrib then you'll need to create a perl program in: the directory:
/usr/share/smanager/SrvMngr/Controller
Here is an example for the smeserver-userpanel contrib:
package SrvMngr::Controller::Userpanelaccess;
#----------------------------------------------------------------------
# heading : User management
# description : User Panel Access
# navigation : 2000 150
# menu :
#----------------------------------------------------------------------
# name : userpanelaccess, method : get, url : /userpanelaccess, ctlact : Userpanelaccess#main
#
# routes : end
#----------------------------------------------------------------------
use strict;
use warnings;
use Mojo::Base 'Mojolicious::Controller';
use Locale::gettext;
use SrvMngr::I18N;
use SrvMngr qw(theme_list init_session);
#use SrvMngr::Model::Main;
sub main {
my $c = shift;
$c->app->log->info($c->log_req);
my $title = $c->l('User panel access');
$c->stash( title => $title, modul => 'https://mailserver.bjsystems.co.uk/server-manager/cgi-bin/userpanelaccess', height => 600 );
$c->render(template => 'embedded');
}
1;
This file will need to be here:
/usr/share/smanager/SrvMngr/Controller/Userpanelaccess.pm
Note the menu entries at the top, and the route specification (the capitalisation and case matching is important here)
Also note the full URL for the SM1 (legacy) contrib, and also the window length (it defaults to 600px if you do not specify).
This all that is necessary to customise the menu entry for a legacy contrib.
Just install the contribs rpm and call it from the "Legacy" category
Server manager 2 will scan for installed contribs, and any that are not fully compatible with Mojolicious will just load the menu entry, using the package name as a link, under the "Legacy" category, normally at the bottom of the menu stack.
The need to login into Server Manager 1
If the legacy contrib does not show after clicking on the menu entry (either for mode (2) or (3) above), then it is probably that you are not logged into SM1. This can be achieved using the button in the top border of SM2 titled "Legacy SM". You can almost certainly use the same credentials that you used to go into SM2. Unfortunately the two programs use different login mechanisms.
Bugs
Please raise bugs under the SME-Server section in bugzilla
and select the component or use this link
Below is an overview of the current issues for this package:
ID | Product | Version | Status | Summary (159 tasks) ⇒ |
---|---|---|---|---|
12948 | SME Server 11.X | 11.alpha1 | CONFIRMED | Workstation backup configure form on incorrect entry and press update errors but only shows backup share field |
12947 | SME Server 11.X | 11.alpha1 | CONFIRMED | Desktop Backup does not allow anything after until screen is refreshed. |
12946 | SME Server 11.X | 11.alpha1 | CONFIRMED | "Argument "" isn't numeric" Error message on every refresh of SM2 screen |
12943 | SME Server 11.X | 11.alpha1 | RESOLVED | Warning message about order of parameters to tar on desktop backup |
12934 | SME Server 11.X | 11.alpha1 | RESOLVED | Server -Error on Backup to desktop |
12933 | SME Server 11.X | 11.alpha1 | RESOLVED | Workstation Backup/restore settings not returning changes after resetting |
12932 | SME Server 11.X | 11.alpha1 | RESOLVED | Letsencrypt certificate 'check one domain' gives 'server error' |
12927 | SME Server 11.X | 11.alpha1 | RESOLVED | Remote Access access setting ftp to Public Access entire interne fails |
12924 | SME Server 11.X | 11.alpha1 | CONFIRMED | NFR: allow smanager setting for ftp Anonymous access |
12923 | SME Server 11.X | 11.alpha1 | RESOLVED | status select field can not be set to current value |
12918 | SME Server 11.X | 11.alpha1 | RESOLVED | Include End of Life, EOL, statement in Server Manager |
12916 | SME Server 11.X | 11.alpha1 | RESOLVED | move letsencrypt panel to smeserver-certificates |
12910 | SME Server 11.X | 11.alpha1 | RESOLVED | Webmail / Roundcube access from user panel and menu does not work if local DNS not used. |
12908 | SME Server 11.X | 11.alpha1 | UNCONFIRMED | sm2 v50 - Variable "$config" is not imported at template webhosting.html.ep line 6. |
12907 | SME Server 11.X | 11.alpha1 | RESOLVED | SM2 V50 - Server-Error on Review Configuration |
12905 | SME Server 11.X | 11.alpha1 | RESOLVED | Make SM2 db opening specific to the route, rather than opening only once |
12903 | SME Server 11.X | 11.alpha1 | CONFIRMED | The jDatatable tables do not reflect the current locale in terms of language etc. Only show English |
12901 | SME Server 11.X | 11.alpha1 | CONFIRMED | Locale not consistently applied |
12900 | SME Server 11.X | 11.alpha1 | CONFIRMED | Html shown in button labels on email panel italian locale |
12893 | SME Server 11.X | -- | RESOLVED | Country flag display uses a google data lookup to find country name |
12892 | SME Server 11.X | -- | RESOLVED | CSRF protection plugin causes error message when in production mode |
12891 | SME Server 11.X | -- | VERIFIED | Should only display "Reconfiguration required" based on Configuration/UnsaveChanges DB entry |
12889 | SME Server 11.X | -- | IN_PROGRESS | Viewlogfiles panel has use perl::Time:TAI64 - not needed. |
12887 | SME Server 11.X | -- | CONFIRMED | Make Version number only display on admin login |
12886 | SME Server 11.X | -- | VERIFIED | Add Mojolicious version to footer |
12885 | SME Server 11.X | -- | RESOLVED | Update to fix crash with perl-mojolicious 9.39 |
12884 | SME Server 11.X | -- | CONFIRMED | If the First / last name are already duplicated in another account, then the error message is not specific enough (and confusing) |
12870 | SME Server 11.X | -- | RESOLVED | Messages dropdown in View Log Files for Server manager 2 is too wide. |
12866 | SME Server 11.X | -- | CONFIRMED | server-manager letsencypt should have on/off for ip check |
12865 | SME Server 11.X | -- | VERIFIED | server-manager reconfigure returns blank page |
12864 | SME Server 11.X | -- | RESOLVED | server-manager letsencrypt panel spelling |
12847 | SME Server 11.X | -- | RESOLVED | unexpected path fails some action scripts |
12846 | SME Server 11.X | -- | RESOLVED | onclick should be replaced by href |
12845 | SME Server 11.X | -- | RESOLVED | flag-icon.min.css should not be provided by cloud flare |
12844 | SME Server 11.X | -- | RESOLVED | xxcolor unknown property for selector .login-button |
12843 | SME Server 11.X | -- | RESOLVED | cross request to external website should be removed |
12840 | SME Server 11.X | -- | RESOLVED | Server-Manager 2 CSP policy |
12839 | SME Server 11.X | -- | RESOLVED | there might be something hardcoded in userpanelaccess |
12838 | SME Server 11.X | -- | RESOLVED | DevTools failed to load source map: Could not load content for https://sme11bhs.pialasse.com/smanager/js/pdfmake.min.js.map: |
12837 | SME Server 11.X | -- | RESOLVED | External files from CDN need to be internal |
12828 | SME Server 11.X | -- | RESOLVED | Update JS components to latest version |
12810 | SME Server 11.X | -- | RESOLVED | Move Letsencrypt action routines to a new package smeserver-certificates and getmyip to smeserver-lib |
12803 | SME Server 11.X | -- | RESOLVED | Add password display icon on password panels for user, ibays and system |
12802 | SME Server 11.X | -- | RESOLVED | Red Error message does not respond to being compressed onto 2 lines (see attached) |
12788 | SME Server 11.X | -- | RESOLVED | AH01215: CGI::param called in list context can lead to vulnerabilities (Persistent) |
12762 | SME Server 11.X | -- | RESOLVED | No valid prefix found in any entries |
12758 | SME Server 11.X | -- | RESOLVED | After install a "signal-event smanager-refresh" is needed before SM2 comes up. |
12757 | SME Server 11.X | -- | RESOLVED | Arrange that all language translations are installed with smeserver-manager |
12756 | SME Server 11.X | -- | CONFIRMED | Loaded Server manager 2 shows "Sme server 2 - initial" on browser tab |
12755 | SME Server 11.X | 11.alpha1 | RESOLVED | Setting deltarpm parameter in SM2 dnf/yum config results on warning on dnf call |
12753 | SME Server 11.X | -- | VERIFIED | Include release number in Version of SM2 in footer. |
12751 | SME Server 11.X | -- | RESOLVED | Add email link to action column in user accounts panel |
12748 | SME Server 11.X | -- | RESOLVED | SM2 - After hitting the "save" button on a panel, then need some feedback to show it is working on the change. |
12746 | SME Server 11.X | -- | RESOLVED | SM2 does not seem to take the passwordStrength db property into allowance when checking passwords for users |
12742 | SME Server 11.X | -- | RESOLVED | Webmail parameter "Save" on email panel gives "not updated" |
12727 | SME Server 11.X | -- | RESOLVED | Software Install panel: Submit button for subservient panels centered. |
12726 | SME Server 11.X | -- | CONFIRMED | Software Installer panel not waiting for dnf to finish and displaying log to that point. |
12725 | SME Server 11.X | -- | CONFIRMED | Top message when reconfigure required not set to be translateable. |
12724 | SME Server 11.X | -- | RESOLVED | Background update using dnf does not update software in SM2 software installer panel |
12718 | SME Server 11.X | -- | RESOLVED | Error clicking on software manager |
12714 | SME Server 11.X | -- | RESOLVED | Turkish menu missing from SM2 menu - does exist in SM1 |
12713 | SME Server 11.X | -- | CONFIRMED | Update smeserver-manager.locale with po files (for weblate import) and also fix up a few lex files |
12707 | SME Server 11.X | -- | CONFIRMED | Japanese, Norwegian and Hebrew navigation files have incorrect language codes |
12706 | SME Server 11.X | -- | RESOLVED | Add flag indication of locale in header for SM2 |
12705 | SME Server 11.X | -- | CONFIRMED | Japanese and Romanian translations only partial - headings, but not a lot more. |
12704 | SME Server 11.X | -- | CONFIRMED | Hebrew translation only has "Date and Time" panel translated. |
12703 | SME Server 11.X | -- | CONFIRMED | Greek user panel has tag showing. |
12702 | SME Server 11.X | -- | CONFIRMED | some translations missing Menu item translation |
12701 | SME Server 11.X | -- | CONFIRMED | Some translated panels are scrambled good example is Hostnames panel |
12700 | SME Server 11.X | -- | CONFIRMED | No way of programming in the translation for a contrib menu item title to be translated |
12699 | SME Server 11.X | -- | CONFIRMED | SM2 Re-configure and Reboot not translated |
12696 | SME Server 11.X | -- | CONFIRMED | Uncaught File 'Roboto-Regular.ttf' not found in virtual file system |
12695 | SME Server 11.X | -- | IN_PROGRESS | cache issue |
12680 | SME Server 11.X | -- | RESOLVED | Align "submit" button on the left consistently on initial panel for each function |
12679 | SME Server 11.X | -- | VERIFIED | Add mojolicious logo to footer |
12674 | SME Server 11.X | -- | RESOLVED | Add some margin around the table controls |
12672 | SME Server 11.X | -- | RESOLVED | Submit (Save/Perform/etc) button on the bottom each panel is often not in the same place |
12671 | SME Server 11.X | -- | RESOLVED | Remote Access form shows a empty network present - errors on save "field validation error" |
12669 | SME Server 11.X | -- | RESOLVED | After using dnf to update and reboot, unable to login to SM1 |
12667 | SME Server 11.X | -- | CONFIRMED | Workstation restore from a removeable device fails |
12666 | SME Server 11.X | -- | CONFIRMED | Legacy panels under Server Manager 2 still require login to SM1 |
12664 | SME Server 11.X | -- | RESOLVED | smanager excessive logging to messages |
12656 | SME Server 11.X | -- | RESOLVED | Tables do not show the Datatable stuff and extra buttons |
12655 | SME Server 11.X | -- | RESOLVED | Unable to reset password through "password Reset" link on login |
12652 | SME Server 11.X | -- | RESOLVED | Unable to add an ibay |
12645 | SME Server 11.X | -- | NEEDINFO | smanager - Wokstation Backup - attempt verify backup fails, does not list backups |
12644 | SME Server 11.X | -- | VERIFIED | smanager - selecting workstation backup using a removeable device no devices displayed in form |
12643 | SME Server 11.X | -- | RESOLVED | Error message in logs on Startup 'Argument "" isn't numeric' |
12640 | SME Server 11.X | -- | RESOLVED | Admin User forward not displayed in user table |
12608 | SME Server 11.X | -- | RESOLVED | AH01215: CGI::param called in list context can lead to vulnerabilities (FormMagick) |
12498 | SME Server 11.X | -- | RESOLVED | Regression - menu restore does not work |
12488 | SME Server 11.X | -- | RESOLVED | Legacy contribs (ones not converted to SM2 / mojo code) are left in the menu at the end and appear in a new browser window / tab |
12485 | SME Server 11.X | -- | RESOLVED | Run the server manager perl files through perltidy. |
12484 | SME Server 11.X | -- | CONFIRMED | Make sure that the categories/sections in the menu are in the same order. |
12483 | SME Server 11.X | -- | RESOLVED | hos_ERROR_CREATING_HOST on adding new hostname |
12482 | SME Server 11.X | -- | CONFIRMED | Make login by ordinary user show correct menu |
12480 | SME Server 11.X | -- | RESOLVED | NFR: Suppress the version number in the footer unless user logged in. |
12479 | SME Server 11.X | -- | RESOLVED | Click on "add domain" and it goes to corporate DNS Settings. |
12478 | SME Server 11.X | -- | RESOLVED | After creating I-bay it was not visible in the ibay list. |
12476 | SME Server 11.X | -- | RESOLVED | Re-organise menu as per discussions on Rocket |
- Report truncated - count greater than max allowed 101 > 100
Changelog
Only released version in smeserver are listed here.