Server Manager 2 Howto incorporate a legacy contrib
From SME Server
Jump to navigationJump to searchIntroduction
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 (195 tasks) ⇒ |
|---|---|---|---|---|
| 13458 | SME Server 11.X | 11.beta1 | IN_PROGRESS | Recast yum panel as dnf panel |
| 13450 | SME Server 11.X | 11.beta1 | RESOLVED | user password panel - after an error password description reverts to lex string |
| 13449 | SME Server 11.X | 11.beta1 | RESOLVED | a CSS change has made the fields in a form extend to the right - Looks better if they are only 50% |
| 13446 | SME Server 11.X | 11.beta1 | VERIFIED | viewlogfiles does not expand compressed files |
| 13445 | SME Server 11.X | 11.beta1 | CONFIRMED | Add live mode to viewlogfiles and add autoscroll to end as the file is displayed |
| 13439 | SME Server 11.X | 11.beta1 | CONFIRMED | legacy panel not translated |
| 13438 | SME Server 11.X | 11.beta1 | VERIFIED | Use of uninitialized value in bitwise |
| 13424 | SME Server 11.X | 11.beta1 | RESOLVED | We've lost the "please wait" on the submit buttons |
| 13416 | SME Server 11.X | 11.beta1 | CONFIRMED | Need to bring all the other languages lex files in line with the re-factored english lex file |
| 13413 | SME Server 11.X | 11.beta1 | RESOLVED | Pull the inline button css into the main css file |
| 13400 | SME Server 11.X | 11.rc1 | RESOLVED | [error] [xRIETbdv56wO] Can't use "0-9" as a method name in bracket group |
| 13398 | SME Server 11.X | 11.beta1 | CONFIRMED | Move all short lexical phrases which are shared between panels into the general category |
| 13396 | SME Server 11.X | 11.beta1 | IN_PROGRESS | Check lex files and controller and templates to make sure that all strings required are in both, english only at this point |
| 13394 | SME Server 11.X | 11.rc1 | RESOLVED | Dec 26 12:01:20 sme11.thereadclan.me.uk smanager[319091]: Use of uninitialized value in string eq at /usr/share/smanager/script/../lib/SrvMngr/Controller/Useraccounts.pm line 801. |
| 13388 | SME Server 11.X | 11.beta1 | RESOLVED | vertical-align top instead of default to bottom |
| 13378 | SME Server 11.X | 11.beta1 | CONFIRMED | Software Install panel still shows update as needed for a period after the update is run |
| 13377 | SME Server 11.X | 11.rc1 | RESOLVED | Errors in system log relating to lex files for dk, ja and il |
| 13374 | SME Server 11.X | 11.rc1 | RESOLVED | "Locale lexicon missing for" shown in logs for some JS and util routes. |
| 13373 | SME Server 11.X | 11.rc1 | VERIFIED | Software Install panel "Use of uninitialized value in concatenation" |
| 13370 | SME Server 11.X | 11.rc1 | RESOLVED | dnf plugin temp event does not include restart of smanager. |
| 13368 | SME Server 11.X | 11.rc1 | RESOLVED | Japanese lex file missing menu entries as well as most other lex files - needs audit and re-generation og the general lex files for each language |
| 13366 | SME Server 11.X | 11.rc1 | RESOLVED | "Legacy" and "Current User" section headings are not localised. |
| 13361 | SME Server 11.X | 11.rc1 | RESOLVED | Some (new?) menu entries do not have translations in the lex files. |
| 13330 | SME Server 11.X | 11.rc1 | RESOLVED | Email setting panel - delivery will clear the password in the DB if the delegate server password is blank when save is clicked |
| 13328 | SME Server 11.X | 11.beta1 | CONFIRMED | viewlogfiles tries to display VERY long files and hangs -> proxy error |
| 13319 | SME Server 11.X | 11.rc1 | RESOLVED | Letsencrypt panel shows CSP failure |
| 13317 | SME Server 11.X | 11.rc1 | RESOLVED | Javascript failures on console log for status panel |
| 13316 | SME Server 11.X | 11.rc1 | RESOLVED | Many of the lex files for the initial panel have SM1 link to image |
| 13314 | SME Server 11.X | 11.beta1 | CONFIRMED | If there is no lex file for a specific language and that language is the browser choice, then the menu is also displayed in english. |
| 13313 | SME Server 11.X | 11.rc1 | RESOLVED | swt_THEME is missing from lex files for danish and probably from most other non en files |
| 13304 | SME Server 11.X | 11.rc1 | RESOLVED | Locale flag not always shown successfully on the top panel |
| 13303 | SME Server 11.X | 11.beta1 | CONFIRMED | Under firefox a legacy panel click which results in a login request is shown new browser tab, instead of re-using the original. |
| 13283 | SME Server 11.X | 11.rc1 | RESOLVED | Remove "yum" and Replace by "dnf" in al lex files |
| 13266 | SME Server 11.X | 11.beta1 | CONFIRMED | Need individual group membership panel for SM2 in User mode |
| 13265 | SME Server 11.X | 11.beta1 | CONFIRMED | Need individual backup panel for SM2 in User mode. |
| 13253 | SME Server 11.X | 11.rc1 | VERIFIED | Update jquery datatable to version 2.3.4 |
| 13247 | SME Server 11.X | 11.rc1 | VERIFIED | Logout button looks strange |
| 13246 | SME Server 11.X | 11.beta1 | VERIFIED | Smanager debug mode |
| 13243 | SME Server 11.X | 11.rc1 | VERIFIED | debugging portforwarding template error |
| 13238 | SME Server 11.X | 11.rc1 | VERIFIED | Menu section headings should not be links |
| 13210 | SME Server 11.X | 11.rc1 | RESOLVED | Add password strength indication to password reset/set panel |
| 13207 | SME Server 11.X | 11.beta1 | VERIFIED | Hostnames and addresses panel must blank MAC address and IP address(es) when Host type set to "Self" |
| 13185 | SME Server 11.X | 11.beta1 | VERIFIED | Add CSS to position multiple submit buttons on panel |
| 13184 | SME Server 11.X | 11.beta1 | VERIFIED | Change how the "Please Wait" is displayed on Submit pressed. |
| 13176 | SME Server 11.X | 11.beta1 | VERIFIED | unsafe inline in login page |
| 13175 | SME Server 11.X | 11.beta1 | VERIFIED | tkt login page redirected as 307 and proto http |
| 13130 | SME Server 11.X | 11.beta1 | RESOLVED | pppoe fails to recconect after update: interface or tty missing |
| 13113 | SME Server 11.X | 11.beta1 | VERIFIED | SM2 login and logout buttons do not work on text based browser |
| 13112 | SME Server 11.X | 11.beta1 | VERIFIED | reconfigure state is displayed without being logged in |
| 13110 | SME Server 11.X | 11.beta1 | RESOLVED | Server Manager Software Updates runs updates, then still tells that there are updates |
| 13106 | SME Server 11.X | 11.beta1 | RESOLVED | Software Update panel: Arrange for result of the dnf run to be streamed to panel |
| 13105 | SME Server 11.X | 11.beta1 | VERIFIED | new server manager LTE - window for port number in network menu is not large enough for 5 wide digits |
| 13103 | SME Server 11.X | 11.beta1 | VERIFIED | Re-Format Template files for default theme to make them more readable. |
| 13101 | SME Server 11.X | 11.beta1 | RESOLVED | After running a Backup to Desktop and saving the backup, button stays at Please wait and cursor stays spinning |
| 13100 | SME Server 11.X | 11.beta1 | RESOLVED | Summary of potential sizes on Backup screen is well wrong |
| 13099 | SME Server 11.X | 11.rc1 | VERIFIED | Missing argument in sprintf Viewlogfiles.pm line 213 |
| 13097 | SME Server 11.X | 11.beta1 | VERIFIED | Restart or shutdown function fails with theme AdminLTE |
| 13095 | SME Server 11.X | 11.beta1 | VERIFIED | Update from AdminLTE theme fail with blank page |
| 13090 | SME Server 11.X | 11.beta1 | VERIFIED | Add text to explain rules for password (which have changed for SME11) |
| 13082 | SME Server 11.X | 11.alpha1 | VERIFIED | Login to SM2 with non admin, shows all menu entries but does not let you obey them |
| 13080 | SME Server 11.X | 11.alpha1 | RESOLVED | Email Settings panel: Some Lex strings without prefix and with very long id |
| 13078 | SME Server 11.X | 11.alpha1 | RESOLVED | Typos in Error Message (lex) Ids in Datetime, UserAccounts, groups and Userpassword panels |
| 13076 | SME Server 11.X | 11.alpha1 | RESOLVED | NutUPS menu item, no UPS attached, change Nut Status to enabled and save, Proxy error |
| 13073 | SME Server 11.X | 11.alpha1 | VERIFIED | Group panel: Error message in logs on entry |
| 13068 | SME Server 11.X | 11.alpha1 | IN_PROGRESS | User Accounts panel: Align the group membership table to the right under the others |
| 13064 | SME Server 11.X | 11.alpha1 | RESOLVED | Busy Cursor no longer shows on Submit for all SM2 panels |
| 13062 | SME Server 11.X | 11.alpha1 | RESOLVED | Add code in top level theme template to pull in panel specific css and js files. |
| 13061 | SME Server 11.X | 11.alpha1 | RESOLVED | Upgrading smeserver-manager package after install does not always update Lex -> <lang>.pm files |
| 13060 | SME Server 11.X | 11.alpha1 | CONFIRMED | RemoteAccess and Proxy Settings panels needs refactoring for Success and Error notification |
| 13058 | SME Server 11.X | 11.alpha1 | CONFIRMED | Re-factor Samba Workgroup panel to return to main screen with success or error messge |
| 13057 | SME Server 11.X | 11.alpha1 | VERIFIED | Extra white line under theme selector in the default theme |
| 13056 | SME Server 11.X | 11.alpha1 | VERIFIED | UserAccounts panel - Setting Admin email to "forward" allows email to be blank |
| 13047 | SME Server 11.X | 11.alpha1 | CONFIRMED | Unable to use SM2 after a backup restore or setting datetime manual |
| 13043 | SME Server 11.X | 11.alpha1 | RESOLVED | Port forwarding panel - error when sucess results blank |
| 13041 | SME Server 11.X | 11.alpha1 | RESOLVED | Use of uninitialized value $ret{"vars"} in split at template partials/_ln_list.html.ep lin |
| 13040 | SME Server 11.X | 11.alpha1 | CONFIRMED | Missing return button on some panels |
| 13039 | SME Server 11.X | 11.alpha1 | IN_PROGRESS | Server-manager Update flag-by-locale.js |
| 13036 | SME Server 11.X | 11.alpha1 | RESOLVED | need to convert DB call to DB::UTF8 |
| 13035 | SME Server 11.X | 11.alpha1 | RESOLVED | need to convert DB call to DB::UTF8 |
| 13031 | SME Server 11.X | 11.alpha1 | RESOLVED | Add sub getYear_list to datetime.pm |
| 13027 | SME Server 11.X | 11.alpha1 | RESOLVED | smanager open and write in db files as iso-8859 |
| 13026 | SME Server 11.X | 11.alpha1 | RESOLVED | Directory ldap page has cache issue |
| 12997 | SME Server 11.X | 11.alpha1 | VERIFIED | webmail should not show on main menu or in user accounts browse if webmail not enabled |
| 12996 | SME Server 11.X | 11.alpha1 | RESOLVED | Review and modify the categories/headings and position of admin menu entries. |
| 12991 | SME Server 11.X | 11.alpha1 | VERIFIED | Add a message on the Reset Password form giving the current rules (according to the DB entry PasswordStrength) |
| 12989 | SME Server 11.X | 11.alpha1 | CONFIRMED | Workstation Restore when reboot is selected when offered SM2 errros to a Proxy Error screen and fails to reboot |
| 12988 | SME Server 11.X | 11.alpha1 | RESOLVED | Under smanager Remote Access Secure shell access value does not match config show sshd value |
| 12974 | SME Server 11.X | 11.alpha1 | VERIFIED | clamav config panel takes a long time even if "Never" and "Disabled" are set |
| 12971 | SME Server 11.X | 11.alpha1 | CONFIRMED | Remote Access panel does not work the same way as other panels |
| 12969 | SME Server 11.X | 11.alpha1 | CONFIRMED | Error message in Local Networks panel is inconsistent with the rest of SM2 |
| 12967 | SME Server 11.X | 11.alpha1 | RESOLVED | Rationalise the css |
| 12951 | SME Server 11.X | 11.alpha1 | RESOLVED | Mail log analysis panel needs re-write for Postfix. |
| 12949 | SME Server 11.X | 11.alpha1 | RESOLVED | Panel for SM2 for Nut UPS package. |
| 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 | RESOLVED | "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' |
| 12924 | SME Server 11.X | 11.alpha1 | CONFIRMED | NFR: allow smanager setting for ftp Anonymous access |
Warnings were generated during the execution of function
- Report truncated - count greater than max allowed 101 > 100
Changelog
Only released version in smeserver are listed here.
