Toshiba SG20 - Magnia - Web Server Customization Manual
  1. Manuals
  2. Brands
  3. Toshiba Manuals
  4. Server
  5. SG20 - Magnia - Web Server
  6. Customization manual

Toshiba SG20 - Magnia - Web Server Customization Manual

General customization guide
Hide thumbs Also See for SG20 - Magnia - Web Server:
Table of Contents

Advertisement

Quick Links

See also: User Manual
Magnia
General
Customization Guide
Contacting Toshiba
If you need assistance:
❖
support.toshiba.com
Download the latest drivers, view detailed installation instructions, and access the
latest server information
❖
InTouch™ Center
Calling within the United States (800) 457-7777
Calling from outside the United States (949) 859-4273
TOSHIBA
®
SG20
1
SV142-1002M1

Advertisement

Table of Contents
loading

Related Manuals for Toshiba SG20 - Magnia - Web Server

Summary of Contents for Toshiba SG20 - Magnia - Web Server

  • Page 1 ® Magnia SG20 General Customization Guide Contacting Toshiba If you need assistance: ❖ support.toshiba.com Download the latest drivers, view detailed installation instructions, and access the latest server information ❖ InTouch™ Center Calling within the United States (800) 457-7777 Calling from outside the United States (949) 859-4273...

  • Page 2: About This Guide

    This guide is copyrighted by Toshiba America Information Systems, Inc., with all rights reserved. Under the copyright laws, this guide cannot be reproduced in any form without the prior written permission of Toshiba. No patent liability is assumed, however, with respect to the use of the information contained herein.
  • Page 3 About This Guide Icons used in this guide The following icons are used in this guide to indicate important information. NOTE: This icon indicates information that relates to the safe operation of the equipment or related items. CAUTION: This icon indicates the existence of a hazard that could result in the damage to equipment or property if the safety instruction is not observed.

  • Page 4: Table Of Contents

    Contents About This Guide..................2 Chapter 1: Customization..............6 Introduction....................6 Customization overview ................8 Accessing the Magnia SG20.............. 8 Copying software to the Magnia SG20 ..........8 Modifying the Magnia SG20 GUI ............9 Listing installed Linux packages............9 User accounts and passwords ..............
  • Page 5 Magnia SG20 queued LCD message interface........ 36 Direct command line interface............37 Queued LCD messages..............38 Adding LCD messages ..............38 LCD message display options............40 Reader Response Questionnaire ............42...

  • Page 6: Chapter 1: Customization

    Customization Introduction The Toshiba Magnia SG20 is a multifunction server appliance, designed to provide ease of use and a friendly setup and management environment. The appliance is based on Red Hat Linux 7.3. Because the Magnia SG20 is an appliance, it contains the Red Hat 7.3 RPMs needed to provide its feature set, as well as a variety of tools that allow direct...
  • Page 7 Doing so can result in a custom image shipped from the Toshiba factory to your end users with modifications which may result in increased service calls and a reduced initial customer satisfaction with the new system.

  • Page 8: Customization Overview

    192.168.1.1 When the Linux login prompt appears, use the account “telnetuser” with the default password “toshiba”. When at a shell prompt, you can switch to the root account using the su command. When at a root command prompt, you can install, recompile or modify software for your application integration.

  • Page 9: Modifying The Magnia Sg20 Gui

    Customization Customization overview ❖ ❖ SMB file sharing access (Samba) To copy files using FTP, invoke a command prompt from any client attached to the Magnia SG20 built-in Ethernet switch. When prompted, log in to the FTP as an anonymous user (the default Magnia SG20 configuration only allows anonymous access).

  • Page 10: User Accounts And Passwords

    This is the standard linux root administrative account with complete system privileges. All accounts are assigned a default password of “toshiba” when delivered from the factory. Changing this password is not recommended, because doing so can make it difficult or impossible for the end user to log in and administer the system.

  • Page 11: Server Setup Wizard

    Customization Server setup wizard This process of assigning an initial user account password to the three predefined accounts takes place when the first user account is created. The creation of subsequent user accounts does not affect account passwords. NOTE: This process will take place when creating an account using either the Magnia SG20 Setup CD, or using the Administrative Web interface.

  • Page 12: Network Configurations

    Internet or corporate LAN access. This can be done, but you should be aware that after changing networking configurations, they should be returned to their original state prior to shipping an image back to Toshiba. If you do not, unintended preset networking configurations could be delivered to your end users.

  • Page 13: Custom Image Backup

    Customization Custom image backup Custom image backup When implementing the custom image, it is easy to make a mistake, requiring you to restore the system to a factory-original state, or recover it from an earlier version of your custom image. The easiest and best way to create an earlier version of your custom image is to take the original Magnia SG20 SDK preinstall image, and create a copy of it prior to doing any work using the disk snapshot feature.

  • Page 14: Software Upgrades Support

    If you wish to retest your image after this change, or if you do not want Toshiba to make this change, inform your Toshiba sales person.
  • Page 15 Customization General system architecture This directory is a premapped location for a customized /home/intranet intranet. You can reach it using the URL . You can easily create your own http://myserver/intranet intranet site by placing the Web pages here. /home/public This directory is the open, public directory in which users can share files.
  • Page 16 Customization General system architecture The file system reflects the following elements in its directory organization: Directory Description /sa2/templates This directory contains the configuration file templates that are used to regenerate the system configuration files. /sa2/lang This directory contains the HTML and other files used to generate the actual Magnia SG20 user interface are contained in this directory.

  • Page 17: Customizing The Firewall

    Because this area is downloaded from, and communicates with, the Toshiba Software Upgrades site, it is a good idea not to modify it. If your preinstall image is sent to the Toshiba factory, Toshiba changes a file in this directory to point to a custom software upgrade Web site for your company.
  • Page 18 Customization Customizing the firewall In this new directory, create a new file named “rule” which contains the IP Tables command for the rule you wish to add. You can use other rule files in /sa2/firewall as examples. For example, you might add the following contents to a rule file: [% IF firewall.enabled -%] # allow VPN clients through # Note that port 500 is the source port, not destination port.

  • Page 19: Template-Based Configuration Files

    Customization Template-based configuration files Template-based configuration files Many of the configuration files in the Magnia SG20 are managed using templates. With this methodology, a set of templates for each configuration file is maintained. Then, when a change is made to the configuration file by the Magnia SG20 user interface or other mechanism, the configuration file is regenerated using these templates.
  • Page 20 Customization Template-based configuration files To place additional elements in the configuration file, such as a new user in the password file, you can add a new template file in the configuration files template directory. Add the text desired for placement in the configuration file in a new template file. The file name should contain two leading digits that will determine your additions placement within the regenerated configuration file.
  • Page 21 Customization Template-based configuration files NOTE: Adding a template file does not cause the configuration file to be regenerated. Regeneration of a configuration file from its templates is only performed when the system determines that a change has been requested by the user in the user interface.
  • Page 22 Customization Template-based configuration files /etc/mail access genericstable local-host-names sendmail.mc virtusertable /etc/mgetty+sendfax login.config mgetty.config /etc/ppp chap-secrets ioptions ioptions.dialin pap-secrets pppoe.conf /etc/ppp/peers dialin pptp /etc/rc.d/init.d dhcpd iptables named network pcmcia /etc/samba smb.conf smbpasswd /etc/squid squid.conf /etc/sysconfig clock ipchains iptables.sh network /etc/sysconfig/network-scripts ifcfg-ethn ifdown-ippp ifdown-ppp ifup-ippp...

  • Page 23: Template Perl Programming Interface

    Customization Template-based configuration files key3 key4 keys mac_accept multicast_rate network_name reject_any station_name transmit_key_id /etc/xinet.d ipop3 telnet wu-ftpd /sa2/conf lcdkbd.conf /sa2/web/admin htaccess /sa2/sbin ifdown-local ifup ifup-local /var/named domain domain.rev /var/spool/cron root Template Perl programming interface The template processor has a Perl object-oriented interface and a command line wrapper.

  • Page 24: System Startup Scripts

    Customization System startup scripts The Perl object interface works like this: use SA::Template; my $tmpl = new SA::Template; $tmpl->process('/etc/sysconfig/ipchains', '0700') or die "Couldn't process firewall"; $tmpl->process('/etc/sysconfig/network', '0700') or die "Couldn't process network globals"; This will take the template files contained in the relative path under /sa2/templates/, concatenate them, and process the concatenated value using the Template Toolkit and the values contained in the /sa2/conf/main.conf.

  • Page 25: Triggers

    Customization Triggers orderly manner. Doing so helps to avoid termination of the application tasks and loss of data when the system is shut down. Your start and stop script should accept a "stop" parameter which will send signals to your application and daemon tasks, arranging for an orderly shutdown. Tasks that are not shut down in an orderly manner at this time are terminated by the operating system during the last stage of system shutdown.

  • Page 26: Trigger Interface

    Customization Triggers Trigger interface The most common use of triggers in custom applications is to assure that template- based configuration changes are applied to the system after modification. In this case, executing the proper trigger from the command line is all that is needed. The usage statement of the trigger command is: usage: trigger <trigger name>...

  • Page 27: Manually Executing A Trigger

    Customization Triggers However, assume that every action script could be fired by a trigger without any data and should be designed so that it regenerates all of its configuration files and restarts all services that use those files. Be very careful not to fire recursive events. Also, determine whether the service is enabled (most likely through consulting the centralized configuration file through SA:Config) and whether you need to fire given the change that was made.

  • Page 28: Implemented Triggers

    Customization Triggers Implemented Triggers The following list of triggers is accurate at the time of the publication of this guide, and can help you understand how this mechanism is used. Verify the triggers on your system for any recent changes. Trigger Associated configuration files Triggering Events...
  • Page 29 Customization Triggers mod_syslang UI change mod_time /etc/sysconfig/clock UI change /var/spool/cron/root mod_users /etc/passwd Add/Remove system /etc/shadow user /etc/group /etc/htpasswd /etc/htgroup /etc/samba/smbpasswd /etc/ppp/pap-secrets /etc/ppp/chap-secrets mod_wireless /etc/sysconfig/tsb/tsb_app_proc/ UI change to wireless channel card settings, fullrestore /etc/sysconfig/tsb/tsb_app_proc/ trigger distance_between_aps /etc/sysconfig/tsb/tsb_app_proc/ dtim_period /etc/sysconfig/tsb/tsb_app_proc/ enable_macfilter /etc/sysconfig/tsb/tsb_app_proc/keys /etc/sysconfig/tsb/tsb_app_proc/ mac_accept /etc/sysconfig/tsb/tsb_app_proc/...
  • Page 30 Customization Triggers network/enable_isdn UI change network/mod_dialin /etc/ppp/ioptions.dialin UI change /etc/ppp/pap-secrets /etc/inittab /etc/mgetty+sendfax/login.config /etc/mgetty+sendfax/mgetty.config /etc/ppp/peers/dialin network/mod_ipsec /etc/ipsec.conf UI change /etc/ipsec.secrets network/mod_proxy /etc/squid/squid.conf UI change network/mod_staticip /etc/named.conf UI change of private IP /var/named/domain address var/named/domain.rev network/bringup Starting of any network interface network/mod_config /etc/sysctl.conf Any network setting /etc/sysconfig/network...
  • Page 31 Customization Triggers network/mod_pptp /etc/inittab UI change to pptp VPN /etc/pptp.conf settings /etc/ppp/peers/pptp /etc/ppp/chap-secrets network/mod_snmp /etc/snmp/snmp.conf UI change to SNMP /etc/snmp/snmpd.conf settings remote_health System Health Report shutdown Shutdown of system started Boot time startup scripts started/lcdmsg Boot time LCD initialization starting Boot time startup scripts status_backup Backup completion...

  • Page 32: Useful Files

    16-character LCD window (along with the other build information). LCD panel customization The Toshiba Magnia SG20 contains a built-in, easy-to-read and use LCD panel. This display is normally used to present information to the user concerning the system status and operations.

  • Page 33: Lcd Interface Technical Overview

    Customization LCD panel customization This section describes the LCD panel operation, its interface, the software controlling message display, and how to display information on the panel directly without using the Magnia SG20-provided software. There are two methods to interact with the Magnia SG20 LCD panel.

  • Page 34: Lcd Panel Direct Access

    The techniques described in this section are for use with operating systems other than the one normally supplied with the Magnia SG20 by Toshiba. The standard Magnia SG20 software contains a Linux daemon that controls and monitors the LCD and system buttons.

  • Page 35: Lcd Control Codes

    Customization LCD panel customization LCD Control Codes In addition to direct transmission of characters to the LCD, there are several special command sequences that can be sent to the LCD controller. These sequences are designed to ease formatting and manipulation of the LCD display. All command sequences begin with the escape character, and are following by a character indicating a specific action.

  • Page 36: Button Status Codes

    Magnia SG20 queued LCD message interface To add custom LCD messages when using a Toshiba Magnia SG20 preinstall, you need to integrate your messaging into the internal messaging management system. The internal queuing system manages the display of LCD messages, their positioning, translation and cycling through the multiple messages available for display using the LCD scroll button.

  • Page 37: Direct Command Line Interface

    Customization LCD panel customization Application ShowMsg Controller LCDKB Daemon Panel COM1 ShowMsg LCD message definition files Application Direct command line interface The command line interface to the LCD/KB port is used for direct display of messages on the LCD panel. The following describes the command line interface for script access.

  • Page 38: Queued Lcd Messages

    Customization LCD panel customization Queued LCD messages Under normal circumstances, all LCD messages are displayed and managed by the LCDKBD daemon. This daemon takes messages that should be displayed on the LCD panel and places them in a queue. Because multiple messages are available for display on the LCD panel, the LCD scroll button on the front of the machine is used to communicate with the LCDKBD daemon.
  • Page 39 Customization LCD panel customization newmsg.desc=Acme Application Messages newmsg.name=ACME newmsg.readonly=0 newmsg.hidden=0 newmsg.msgup=-center “Acme App” –center “Running” newmsg.msgdown=-center “Acme App” –center “Not Running” newmsg.msgalert=-ontop -center “Acme App” –center “%s Error” newmsg.msgmail=-ontop -onetime –center “Acme App” –center “Check Mail” LCD message display options on page 40 for more information about these fields and their operation.

  • Page 40: Lcd Message Display Options

    Customization LCD panel customization LCD message display options The LCD message definition files contained in the /sa2/lang/en/lcdmsg directory contain a variety of options (see Step 2 of the preceding example). Fields are defined by the name of the message with a specific configuration parameter suffix. newmsg.desc=Acme Application Messages The “desc”...
  • Page 41 Customization LCD panel customization newmsg.hidden=0 The hidden field specifies whether the LCD message appears on the configuration screen. Some messages, such as health monitoring, do not even appear on the user LCD configuration screen, and are always displayed. To prevent a message from appearing on the configuration screen, set the hidden field to 1.

  • Page 42: Reader Response Questionnaire

    Reader Response Questionnaire Toshiba welcomes your opinion. Your comments provide valuable information that helps us refine the documentation that ships with our products and evaluate the usefulness of support services that Toshiba currently offers. A Reader Response Questionnaire and self-addressed mailer are on the following two pages.
  • Page 43 United Linux .NET Windows Embedded other ________________________________ Please answer each question below by checking the appropriate response: 1. I think the Toshiba provided Quick Start Card would be helpful for our end user’s. strongly agree agree neutral disagree strongly disagree 2.
  • Page 44 Fold here Fold here Toshiba America Information Systems, Inc. Attn: Magnia Product Manager A135E Computer Systems Division 9740 Irvine Blvd. Irvine, CA 92618-1697...

Table of Contents