Configuring for First Use
Changing Admin Password
Global Component Settings
User Interface Settings
Tracking and Recipient Profiles
Editing INI Files
User Interface Branding
International Character Sets
Standard Default Ports
User Interface Branding
The Maestro User Interface and the Administration Hub components
permit limited user interface branding by allowing the administrator
the choice of using institutional or company logo images instead
of the LISTSERV Maestro logos, and by adding a few text strings
at prominent locations, like in the header and footer of each
To do this,
the administrator must create a text file called "custom.properties"
that must be located in the folder
the Maestro User Interface component and/or
to customize the Administration Hub component. This file
must be a text file that follows the rule of LISTSERV Maestro INI files
(see Section 14 for more information).
This means that the file must consist of entries of the form "key=value",
with which the administrator can define customized text strings or point
to customized logo image files.
16.1 Adding Custom Text Strings
Each custom text string consists of a "key=value"
pair, where the key is as listed below, and the value is the
text that is supposed to appear in the user interface (and
follows the INI file rules). The following text string keys
are currently available for customization:
to be used in the window title bar of each browser window
that is used to access the Maestro User Interface or
the Administration Hub component. The text will appear
as the first text in the title bar, before the application
name. If this key is not included, the text "L-Soft"
will be shown. Supply an empty value "app.title.companyName="
to not show any text before the application name.
32 Browser Window Branding
as a header text at the top of the page. The header text
will be drawn so that it will appear on top of the blue
header bar that is shown at the top of each page so that
the blue header bar will be the background behind the
text, which is drawn with a white, bold faced font, about
as large as the page headers that appear on each page
right below the header bar. If this key is not included,
no text will be shown.
Figure 33 LISTSERV
Maestro Header Branding
as a footer text at the bottom of the page. The footer
text will be drawn in the bottom left corner of each
page where it will appear to the left of the "Secured
by F-Secure" message (in the Maestro User Interface).
It will be drawn in the same small standard page font
as the F-Secure message. If this key is not included,
no text will be shown.
Figure 34 LISTSERV
Maestro Footer Branding
Uses "YOUR_URL" (must be a valid "http://…"
URL) as the target link of the logo that appears
at the top-right of each page. This logo is set
to the LISTSERV Maestro logo with a target URL of
"http://www.lsoft.com". Customizing the logo's target
URL is the most effective when used together with
exchanging the LISTSERV Maestro logo with a customized
institutional or company logo (see below). If this
key is not included the URL will point to "http://www.lsoft.com".
Exchanging Logo Images
In order to replace the LISTSERV Maestro logo image
files, prepare the customized image files and save them in
either GIF or JPG format. There are size restrictions for
the files, which are detailed below. Create a folder named
"custom" in the directories below. Save the image files in
these "custom" folders so that the files are accessible to
LISTSERV Maestro and so that the files will not be changed
or deleted by LISTSERV Maestro's upgrade routine (although
the folders may be deleted during a full deinstallation of
For the Maestro
User Interface component, create a "custom"
folder so that the path to save the image files reads:
For the Administration
Hub component, a "custom" folder so that the path to save
the image files reads:
files anywhere else will either have the effect that LISTSERV
Maestro will not be able to find them, or they may be lost
during an upgrade.
images are saved in the "custom"
folder, LISTSERV Maestro needs to know about them. Do so
with the same sort of "key=value"
entries in the "custom.properties" file(s) as described above.
Each key's value must be a relative filename starting with
a forward slash "/"
and including the name of the "custom"
folder itself as the first path element, using the forward
slash as the separator (not backslash).
image file keys are currently available:
Uses the image file with the name "FILENAME"
from the "custom" folder to replace the LISTSERV
Maestro logo image that is shown at the right of
the header bar that appears at the top of each page.
This logo also is a clickable link that may be customized.
Set the target URL with the "app.url.companyURL"
key (see above). This image must be 60 x 60 pixels
in size. If this key is not included, the LISTSERV
Maestro logo will be used.
35 Right Logo Branding
Uses the file with the name "FILENAME" from
the "custom" folder to replace the LISTSERV Maestro logo image that
is shown on the login page when the Maestro User Interface or Administration
Hub is not accessible: Under normal conditions, the login page only
shows the image in the header bar, plus the edit fields for the login.
However, if the Maestro User Interface or Administration Hub is for
some reason not correctly started, the login page displays this logo
and a short message text, instead of the login edit fields. This logo
image should be about 113 x 113 pixels in size, but the size
may vary (within reasonable limits). If you do not include this key,
a version of the LISTSERV Maestro logo will be used.
36 Error Screen Logo Branding