Server Manager 2 Howto incorporate a legacy contrib

From SME Server
Jump to navigationJump to search

Introduction

There are 3 possibilities for incorporating an existing (legacy) contrib into Server manager 2:

  1. Re-code the contrib into the Mojolicious environment in which SM2 is written. This is documented here.
  2. 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.
  3. 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
Screenshot from 2024-02-29 12-25-32.png

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

Screenshot from 2024-02-29 12-25-15.png

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:

IDProductVersionStatusSummary (221 tasks)
13590SME Server 11.X11.rc1CONFIRMEDRoundcube about screen is missing
13586SME Server 11.X11.rc1VERIFIEDViewlogfiles horizontal scroll bar is only visible at the bottom
13578SME Server 11.X11.rc1CONFIRMEDPassword change panel: Lex id incorrect
13574SME Server 11.X11.rc1CONFIRMEDNutUPS - Misssing entry in lex file
13570SME Server 11.X11.rc1RESOLVEDRemove old Software install panel from SM2
13569SME Server 11.X11.rc1RESOLVEDMissing entry in lex file for bug report panel
13552SME Server 11.X11.beta1CONFIRMEDUser Password for email sending display password far from the input box
13548SME Server 11.X11.beta1VERIFIEDfix RPM-GPG-KEY-MariaDB2 always readded and add zabbix keys
13538SME Server 11.X11.beta1CONFIRMEDpartial panel looses the highlight (bold) for any non front panel
13537SME Server 11.X11.beta1VERIFIEDcertificate rpm upgrade disable all domains
13526SME Server 11.X11.beta1RESOLVEDDomain panel: Error on deleting domain
13523SME Server 11.X11.beta1RESOLVEDAdd extra smarts to domain/host list according to letsencrypt status
13514SME Server 11.X11.beta1RESOLVEDUpdate favicon so that it shows correctly proportioned
13508SME Server 11.X11.beta1CONFIRMEDRemote manager panel should allow /CIDR format for network mask
13504SME Server 11.X11.beta1RESOLVEDRefactor menu so that it shows hover and current selected menu
13502SME Server 11.X11.beta1RESOLVEDSoftware installer (dnf) Configure: changing to automatically install updates gives error
13501SME Server 11.X11.beta1CONFIRMEDviewlogs panel: Add button to clear log
13500SME Server 11.X11.beta1VERIFIEDRefreshing viewed log file will display messages.log
13497SME Server 11.X11.beta1RESOLVEDRemove CSP hashes for window.onload in partial files
13496SME Server 11.X11.beta1RESOLVEDAdd lang="lang code" in html tag
13495SME Server 11.X11.beta1RESOLVEDAdd in favicon file
13492SME Server 11.X11.beta1VERIFIEDShutdown or reboot panel, selection control not properly aligned and font for second page not consistent with the rest of the system.
13487SME Server 11.X11.beta1VERIFIEDDomains panel showing dom_localhost in drop down for Domain DNS Servers.
13486SME Server 11.X11.beta1RESOLVEDSome observations on the format/alignment of the main screen and panels
13485SME Server 11.X11.beta1CONFIRMEDUse of uninitialized value in gmtime at /usr/share/perl5/vendor_perl/Mojo/Date.pm line 64
13484SME Server 11.X11.beta1RESOLVEDError on update - Can't exec "db"
13483SME Server 11.X11.beta1RESOLVEDAdd autocomplete to form in LDAP directory settings panel
13472SME Server 11.X11.beta1RESOLVEDCan't locate object method "theme_list" via package "SrvMngr::Controller::Dnf"
13466SME Server 11.X11.beta1RESOLVEDVarious alignment problems with fields and mojo logo.
13465SME Server 11.X11.beta1IN_PROGRESSFurther work on dnf panel (to replace yum panel)
13462SME Server 11.X11.beta1VERIFIEDsmanager add port forward rule, fields misaligned
13458SME Server 11.X11.beta1RESOLVEDRecast yum panel as dnf panel
13450SME Server 11.X11.beta1RESOLVEDuser password panel - after an error password description reverts to lex string
13449SME Server 11.X11.beta1RESOLVEDa CSS change has made the fields in a form extend to the right - Looks better if they are only 50%
13446SME Server 11.X11.beta1VERIFIEDviewlogfiles does not expand compressed files
13445SME Server 11.X11.beta1CONFIRMEDAdd live mode to viewlogfiles and add autoscroll to end as the file is displayed
13438SME Server 11.X11.beta1VERIFIEDUse of uninitialized value in bitwise
13424SME Server 11.X11.beta1RESOLVEDWe've lost the "please wait" on the submit buttons
13416SME Server 11.X11.beta1CONFIRMEDNeed to bring all the other languages lex files in line with the re-factored english lex file
13413SME Server 11.X11.beta1RESOLVEDPull the inline button css into the main css file
13400SME Server 11.X11.rc1RESOLVED[error] [xRIETbdv56wO] Can't use "0-9" as a method name in bracket group
13398SME Server 11.X11.beta1CONFIRMEDMove all short lexical phrases which are shared between panels into the general category
13396SME Server 11.X11.beta1RESOLVEDCheck lex files and controller and templates to make sure that all strings required are in both, english only at this point
13394SME Server 11.X11.rc1RESOLVEDDec 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.
13388SME Server 11.X11.beta1VERIFIEDvertical-align top instead of default to bottom
13378SME Server 11.X11.beta1CONFIRMEDSoftware Install panel (yum and dnf) still shows update as needed for a period after the update is run
13377SME Server 11.X11.rc1RESOLVEDErrors in system log relating to lex files for dk, ja and il
13374SME Server 11.X11.rc1RESOLVED"Locale lexicon missing for" shown in logs for some JS and util routes.
13373SME Server 11.X11.rc1VERIFIEDSoftware Install panel "Use of uninitialized value in concatenation"
13370SME Server 11.X11.rc1RESOLVEDdnf plugin temp event does not include restart of smanager.
13368SME Server 11.X11.rc1RESOLVEDJapanese 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
13366SME Server 11.X11.rc1RESOLVED"Legacy" and "Current User" section headings are not localised.
13361SME Server 11.X11.rc1RESOLVEDSome (new?) menu entries do not have translations in the lex files.
13330SME Server 11.X11.rc1RESOLVEDEmail setting panel - delivery will clear the password in the DB if the delegate server password is blank when save is clicked
13328SME Server 11.X11.beta1RESOLVEDviewlogfiles tries to display VERY long files and hangs -> proxy error
13321SME Server 11.X11.beta1RESOLVEDcontrib CSP failures on SM2 panel
13319SME Server 11.X11.rc1RESOLVEDLetsencrypt panel shows CSP failure
13317SME Server 11.X11.rc1RESOLVEDJavascript failures on console log for status panel
13316SME Server 11.X11.rc1RESOLVEDMany of the lex files for the initial panel have SM1 link to image
13314SME Server 11.X11.beta1CONFIRMEDIf there is no lex file for a specific language and that language is the browser choice, then the menu is also displayed in english.
13313SME Server 11.X11.rc1RESOLVEDswt_THEME is missing from lex files for danish and probably from most other non en files
13304SME Server 11.X11.rc1RESOLVEDLocale flag not always shown successfully on the top panel
13303SME Server 11.X11.beta1CONFIRMEDUnder firefox the intial legacy panel click is shown new browser tab, instead of re-using the original.
13283SME Server 11.X11.rc1RESOLVEDRemove "yum" and Replace by "dnf" in al lex files
13266SME Server 11.X11.beta1CONFIRMEDNeed individual group membership panel for SM2 in User mode
13265SME Server 11.X11.beta1CONFIRMEDNeed individual backup panel for SM2 in User mode.
13253SME Server 11.X11.rc1VERIFIEDUpdate jquery datatable to version 2.3.4
13247SME Server 11.X11.rc1VERIFIEDLogout button looks strange
13246SME Server 11.X11.beta1VERIFIEDSmanager debug mode
13243SME Server 11.X11.rc1VERIFIEDdebugging portforwarding template error
13238SME Server 11.X11.rc1VERIFIEDMenu section headings should not be links
13210SME Server 11.X11.rc1RESOLVEDAdd password strength indication to password reset/set panel
13207SME Server 11.X11.beta1VERIFIEDHostnames and addresses panel must blank MAC address and IP address(es) when Host type set to "Self"
13185SME Server 11.X11.beta1VERIFIEDAdd CSS to position multiple submit buttons on panel
13184SME Server 11.X11.beta1VERIFIEDChange how the "Please Wait" is displayed on Submit pressed.
13176SME Server 11.X11.beta1VERIFIEDunsafe inline in login page
13175SME Server 11.X11.beta1VERIFIEDtkt login page redirected as 307 and proto http
13130SME Server 11.X11.beta1RESOLVEDpppoe fails to recconect after update: interface or tty missing
13113SME Server 11.X11.beta1VERIFIEDSM2 login and logout buttons do not work on text based browser
13112SME Server 11.X11.beta1VERIFIEDreconfigure state is displayed without being logged in
13110SME Server 11.X11.beta1RESOLVEDServer Manager Software Updates runs updates, then still tells that there are updates
13106SME Server 11.X11.beta1RESOLVEDSoftware Update panel: Arrange for result of the dnf run to be streamed to panel
13105SME Server 11.X11.beta1VERIFIEDnew server manager LTE - window for port number in network menu is not large enough for 5 wide digits
13103SME Server 11.X11.beta1VERIFIEDRe-Format Template files for default theme to make them more readable.
13101SME Server 11.X11.beta1RESOLVEDAfter running a Backup to Desktop and saving the backup, button stays at Please wait and cursor stays spinning
13100SME Server 11.X11.beta1RESOLVEDSummary of potential sizes on Backup screen is well wrong
13099SME Server 11.X11.rc1VERIFIEDMissing argument in sprintf Viewlogfiles.pm line 213
13097SME Server 11.X11.beta1VERIFIEDRestart or shutdown function fails with theme AdminLTE
13095SME Server 11.X11.beta1VERIFIEDUpdate from AdminLTE theme fail with blank page
13090SME Server 11.X11.beta1VERIFIEDAdd text to explain rules for password (which have changed for SME11)
13082SME Server 11.X11.alpha1VERIFIEDLogin to SM2 with non admin, shows all menu entries but does not let you obey them
13080SME Server 11.X11.alpha1RESOLVEDEmail Settings panel: Some Lex strings without prefix and with very long id
13078SME Server 11.X11.alpha1RESOLVEDTypos in Error Message (lex) Ids in Datetime, UserAccounts, groups and Userpassword panels
13076SME Server 11.X11.alpha1RESOLVEDNutUPS menu item, no UPS attached, change Nut Status to enabled and save, Proxy error
13073SME Server 11.X11.alpha1VERIFIEDGroup panel: Error message in logs on entry
13064SME Server 11.X11.alpha1RESOLVEDBusy Cursor no longer shows on Submit for all SM2 panels
13062SME Server 11.X11.alpha1RESOLVEDAdd code in top level theme template to pull in panel specific css and js files.
13061SME Server 11.X11.alpha1RESOLVEDUpgrading smeserver-manager package after install does not always update Lex -> <lang>.pm files
13060SME Server 11.X11.alpha1CONFIRMEDRemoteAccess and Proxy Settings panels needs refactoring for Success and Error notification
13058SME Server 11.X11.alpha1CONFIRMEDRe-factor Samba Workgroup panel to return to main screen with success or error messge
Warnings were generated during the execution of function
  1. Report truncated - count greater than max allowed 101 > 100


Changelog

Only released version in smeserver are listed here.