MSP Server Software

solidseniorServers

Dec 9, 2013 (3 years and 8 months ago)

104 views

MSP Server Software
Installation Guide

Copyright
Copyright
©
2007 by Symbol Technologies, Inc. All rights reserved.
No part of this publication can be modified or adapted in any way, for any purposes without permission in
writing from Symbol. The material in this manual is subject to change without notice
Symbol reserves the right to make changes to any product to improve reliability, function, or design.
No license is granted, either expressly or by implication, estoppel, or otherwise under any Symbol
Technologies, Inc., intellectual property rights. An implied license only exists for equipment, circuits, and
subsystems contained in Symbol products.
Symbol, the Symbol logo are registered trademarks of Symbol Technologies, Inc.
IBM is a registered trademark of International Business Machine Corporation. Microsoft, Windows, and
Windows NT are registered trademarks of Microsoft Corporation. Novell, SUSE, and LAN Workplace are
registered trademarks of Novell Inc. Red Hat is a registered trademark of Red Hat Inc. Toshiba is a trademark
of Toshiba Corporation. All other product names referred to in this guide might be trademarks or registered
trademarks of their respective companies and are hereby acknowledged.
Patents
This product is covered by one or more of the patents listed on the website: http://www.symbol.com/patents.
Table of Contents
Chapt er 2
Table of Contents
Chapter 1: Installing MSP 2.9 Software
Supported Operating Systems ........................................................................................1
Hardware Requirements ..................................................................................................1
Partitioning the Disk .........................................................................................................2
Installing the OS ...............................................................................................................2
Installing Required Packages ................................................................................ 3
Configuring the OS ...........................................................................................................3
Specifying the hostname in the /etc/hosts file ........................................................ 3
Disabling selinux .................................................................................................... 4
Configuring the Network ..................................................................................................4
Installing MSP 2.9
Checking Prerequisites .......................................................................................... 5
Steps to install MSP 2.9 ......................................................................................... 5
Configuring MSP ...............................................................................................................6
Uninstalling MSP ..............................................................................................................7
Troubleshooting ...............................................................................................................7
Checking if the MSP processes are running .......................................................... 7
Administration Scripts ............................................................................................ 8
Appendix A 9
Appendix B 11
4 MSP Server Software Installation Guide
Installing MSP 2.9 Software
Chapt er 1
Chapt er 1
Installing MSP 2.9 Software
This document describes how to install MSP 2.9 Server Software on Intel-based hardware (specifically HP and
Dell).
Supported Operating Systems
MSP 2.9 Server Software release only supports Red Hat and SUSE versions of Linux.
-
Supported Red Hat Version: Red Hat Enterprise Linux ES release 4. Kernel version 2.6.9-5.ELsmp.
Symbol has not certified the later versions of RHEL ES v4, but MSP 2.9 might work on the later
versions.
Note
MSP 2.9 does not support selinux. The section “Disabling selinux” on page 4 tells you how to disable
selinux.
-
Supported SUSE Version: SUSE LINUX Enterprise Server 9 (i586). Kernel version 2.6.5-7.97-bigsmp.
Symbol has not certified the later versions of SLES v9, but MSP 2.9 might work on the later versions.
Hardware Requirements
MSP 2.9 works on Intel-based boxes and has been certified on the HP DL140G2 and Dell PowerEdge 1850.
The MSP 2.9 Software should be installed on a dedicated server.
Table 1-1 shows the recommended hardware requirements.
Table 1-1
Hardware Requirements
# of devices
Hard disk
RAM
CPU
Up to 2000 devices 80 GB 1 GB 3 GHz Single CPU
Up to 5000 devices 80 GB 4 GB 3 GHz Dual CPU Dual Core
2 Installing MSP 2.9 Software
Partitioning the Disk
You must partition the disk in such a way that the root directory (/) should have the basic OS and related
packages. The /var/lib directory must be large because the MSP database uses this directory. Table 1-2 shows
the recommended partitioning.
Note
Swap should be set 2 GB for MSP managing up to 100 devices and 4GB for the MSP managing up to
5000 devices.
For customized partitioning, ensure there is enough space in the directories as shown in Table 1-3.
To determine the partitions and the space allotted to them, run the command:
# df -h
Note
Partitioning is done during the OS installation. For more details, see the installation guides specific to
your OS.
Installing the OS
For installation of OS and required packages, refer to “Appendix B” on page 10
Table 1-2
Disk Partitioning
Partition
Space
Contains
/
16 GB The OS, system packages, and utilities, and the MSP distribution
reside in this partition.
/tmp
2 GB Temporary files
/boot
200 MB Boot information
/var/lib
> 50GB MSP database and the backups. The logs are also stored in this
directory.
Table 1-3
Minimum Disk Space
Directory
Size
Contains
/opt/semm ~ 50 MB SEMM binaries
/opt/jboss ~ 75 MB Jboss binaries
/usr/local/mss ~ 1 GB mss binaries
/opt/msamaint ~ 100 MB Software packages
/tftpboot ~ 50 MB Software packages
/tmp ~ 2 GB
/var/lib ~ 40 to 50 GB MSP database and MSP backups
Installing MSP 2.9 Software 3
All the required packages are listed in the Appendix A. Ensure that these packages are already installed on the
box before installing MSP.
Note
Because MSP installs the mysql database, do not install mysql when installing the OS. It is
recommended that you uninstall mysql before you install MSP (if you installed it during the OS
installation). MSP deletes the existing mysql packages during the installation if you use the force
option (-f) during the installation.
If mysql is already installed on the box before MSP is installed, the MSP 2.9 Server Software installation script,
when run, displays the list of mysql RPMs that must be uninstalled. If you run the installation script using the
force (-f) option, the, the installed mysql rpm’s are uninstalled automatically. But, if you do not want a forceful
installation of the MSP 2.9 Server Software, then you must remove these RPMs manually.
Note
Do not use your browser’s Back button when you are setting up the MSP 2.9 Server Software.
Installing Required Packages
You can find all of the required packages in the OS installation CDs as rpm packages (such as
vsftpd-2.0.1-5.rpm). If you do not find the required package/version, download it from http://rpmfind.net.
Use the following command to install the packages:
# rpm -iVh <rpm package>
For example:
rpm -iVh vsftpd-2.0.1-5.rpm
Note
You must be logged in as the root user to install the packages.
If you have done a complete installation, you might not have to install any more packages.
To find out which packages should be installed on the box before installing MSP, run the msp_config_check
script, which is in the directory in which you untar the MSP tarball (installable).
Configuring the OS
Ensure that you enter the hostname in the /etc/hosts file and that selinux is disabled.
Specifying the hostname in the /etc/hosts file
1.
Ensure that the hostname is entered in the /etc/hosts file.
a.
Enter the following command to get the hostname:
# hostname
This command displays the hostname. Enter this hostname in the /etc/hosts file. For example:
127.0.0.1 [hostname]
The following is a sample output that appears when you run the hostname command at the shell
prompt:
#hostname
Symbol
4 Installing MSP 2.9 Software
//Now open the file hosts as:
Make sure that hostname string (for example, the "Symbol" string) is present
in hosts file:
# vi /etc/hosts
//On the Redhat box hosts file might be of the sort:
# Do not remove the existing lines, or various programs
# that require network functionality will fail.
127.0.0.1 localhost.localdomain localhost
198.168.2.221 Symbol
Now in this file make an additional entry with the displayed hostname
(provided it is not present by default) as:
# Do not remove the existing lines, or various programs
# that require network functionality will fail.
127.0.0.1 Symbol
127.0.0.1 localhost.localdomain localhost
198.168.2.221 Symbol
b.
Save the file and exit.
Disabling selinux
Ensure that selinux is not enabled for Red Hat. To find out if selinux is enabled on the box:
1.
View the contents of the /etc/selinux/config file in any text editor.
2.
Ensure that the configuration file entry is:
SELINUX=disabled
3.
Comment out SELINUXTYPE=targeted.
4.
Save the file and reboot the box after you complete the above steps. After the box reboots, check that the
values you entered are retained.
If selinux is enabled, then the MSP 2.9 Server Software installation script prompts you to disable the feature.
Configuring the Network
Ensure that the IP address, netmask and default gateway is configured as per your requirements. Changing
the network parameters after the installation of MSP might render MSP unusable.
Installing MSP 2.9
This section describes how to install MSP 2.9.
Installing MSP 2.9 Software 5
Checking Prerequisites
Before you install MSP, ensure that the:

The default OS installation is done and additional packages (as described in “Appendix B” on page 10)
are installed.

Hard disk partitioning matches the values in Table 1-2 on page 2.
/ is 16 GB
/tmp is 2 GB
/boot is 200 MB
/var/lib is greater than 50GB

Network interfaces are configured.

After the installation, login directly as the root user.

The hostname entry is made in the hosts file.

selinux is disabled if you are using the Red Hat OS.
The installable MSP 2.9 software is in the tar format. The installable name is in the format:
msp_<timestamp>_<os>.tar. For example:
msp_2006052201_suse.tar
Steps to install MSP 2.9
To install MSP 2.9:
1.
Copy the tarball into the server directory (such as the /tmp directory) and untar the tarball.
# tar xvf <msp..tar>
Example:
tar xvf msp_0+2006052201_suse.tar
This command creates a directory with the same name as tar file's timestamp prefixed with msp_0+ and
all of the installable contents are stored in it.
2.
Change to new directory.
# cd msp_0+2006052201
3.
Run the msp_config_check script to check whether you need to install any packages before installing MSP.
#./ msp_config_check
4.
Run the install script using the command:
Usage: msp_install [ -v ] [ -f ] [ -h | --help ]
-v verbose more information.
-f do a force full install. Do not prompt for user input.
-h | --help help
6 Installing MSP 2.9 Software
The force option does not prompt for user confirmation provided selinux is disabled on Red Hat. If you
choose the force option, then MSP:
-
Deletes all of the existing mysql rpms.
-
Installs the necessary packages.
-
Upgrades the necessary packages.
The msp_install installation script does not install/upgrade the packages that are listed as required
packages (listed in “Appendix A” on page 8).
If the msp_install script prompts to remove mysql rpms (if mysql is already present in the server before you
installed MSP and it is not a force installation), uninstall the mysql rpms and install MSP again.
To uninstall mysql rpms, use the command:
# rpm -e --nodeps <mysql rpm names>
Or
# rpm -e <Mysql rpms> --nodeps
The names of the existing mysql rpms appear on the console if they are present.
If the msp_install script cannot determine the OS version, it prompts you to set the OS_TYPE and rerun the
script. In such a case, export the OS_TYPE variable set to either suse or redhat using the command:
# export OS_TYPE=suse (for SUSE installation)
and
# export OS_TYPE=redhat (for Redhat installation)
After you install MSP 2.9, the system reboots. The Xserver on the server is turned off for optimization. Do not
turn the Xserver back on because it degrades MSP’s performance.
Upgrading to MSP 2.9
You can upgrade to MSP 2.9 only from MSP 2.8 and from MSP 2.8.1. If you have an MSP version earlier than
MSP 2.8, you must upgrade to MSP 2.8/2.8.1, before upgrading to MSP 2.9.
To upgrade to MSP 2.9:
1.
Change to /root/usrbin on the MSP 2.8/2.8.1 appliance.
2.
Either:

Enter ./Get_MSP_Update <datestamp> [KEEPDB] [RECONFIGURE] [NOSTART]
Example: ./Get_MSP_Update 0+2006052102 KEEPDB
Or

Enter ./Get_MSP_Update <datestamp>
Example: ./Get_MSP_Update 0+2006052102
Note
This option upgrades MSP without KEEPDB.
Installing MSP 2.9 Software 7
Configuring MSP
You must configure MSP before using it. To configure MSP, open the Internet Explorer browser (version 6.0
and above only) and enter the URL http://<machine IP>. It may take some time for the page to load.
1.
Configure the following:

MSP login credentials

ftp site credentials

Device discovery (if you want to do this as a part of the configuration)
2.
Restart MSP when you reach the last page. This might take about 10 minutes.
3.
Wait until you see a message stating that web server is ready. Then, access the MSP console using the
URL http://<machine IP>.
Uninstalling MSP
To uninstall MSP:
1.
Login as the root user.
2.
Change directory to /root/usrbin
# cd /root/usrbin
3.
Run the uninstall script
# ./msp_uninstall
# Usage: msp_uninstall [-v] [-h | --help]
The system prompts you to confirm that you want to uninstall MSP. If you enter yes, it uninstalls MSP.
Troubleshooting
This section provides troubleshooting tips.
Checking if the MSP processes are running
Enter the following command to check if the mss processes are running:
# ps - aef | grep mss
This command displays at least six lines of output. The following are the most important:
-
/usr/lib/j2sdk/bin/java -server -Djboss.bind.address=192.192.7.249
-Djava.rmi.server.hostname=192.192.7.249 -Dprogram.name=run.sh -classpath
/opt/jboss/bin/run.jar:/usr/lib/j2sdk/lib/tools.jar org.jboss.Main
-
/usr/lib/j2sdk/bin/java -server -Xmx1024m -Djava.ext.dirs=/usr/local/mss/lib -Djava.security.manager
-Djava.ext.dirs=/usr/local/mss/lib -Djava.security.manager
-Djava.security.policy=jar:file:/usr/local/mss/bin/phoenix-loader.jar!/META-INF/java.policy
-Dairprism.home=/usr/local/mss/airprism -Djava.awt.headless=true -Dphoenix.home=/usr/local/mss
8 Installing MSP 2.9 Software
-Djava.io.tmpdir=/usr/local/mss/temp -classpath
/usr/lib/j2sdk/lib/tools.jar:/usr/lib/j2sdk/jre/lib/ext/sunjce_provider.jar:/usr/local/mss/bin/phoenix-loader.
jar org.apache.avalon.phoenix.launcher.Main
If these two processes are running, then MSP is running.
1.
Check that the SEMM processes are running.
# ps -aef | grep semm
This command displays at least three lines of output. The following line is important:
/opt/semm/bin/semmd
2.
Check that mysql processes are running:
# ps -aef | grep mysql
This command displays at least four lines of output. The following line is important:
/bin/sh /usr/bin/mysqld_safe
3.
Check that the ftp server is running using the command:
# ps -aef | grep vsftp
The line that is important is:
/usr/sbin/vsftpd
Administration Scripts
Table 1-4 describes the administration scripts in the /root/usr/bin directory.
Appendix A
Before installing MSP 2.9, ensure that you install the following software packages on SUSE or Redhat
systems. Except for the tftp package for SUSE, all other packages are automatically installed during a
complete installation.
You must install the tftp package for the SUSE OS using the instructions in the section, ‘Installing Packages
Required for MSP on SUSE” on page 11.
Table 1-4
Administration Scripts
Script
Description
msp_health_check
Shows the status of the MSP
stop_msp
Stops MSP processes
restart_msp
Restarts MSP processes
msp_config_check
Compares the system configuration with the required configuration and
displays the discrepancies.
Installing MSP 2.9 Software 9
Table 1-5 shows the software packages and version for the SUSE OS.
Table 1-6 shows the software packages and version for the Red Hat OS.
Table 1-5
Software Packages for the SUSE OS
Package
Version
Remarks
Postfix 2.1.1 Postfix is SMTP server needed for MSP
Vsftpd 1.2.1 ftp server needed for MSP
tftp 0.36 The tftp package is the only package that is
not automatically installed. You must install
the package manually after a complete
installation. See ‘Installing Packages
Required for MSP on SUSE” on page 11.
tftp-server 0.36 Tftp server
apache v2 2.0.49 Apache server
libc6 2.3.3 > 2.3.2 is fine
Openssl 0.9.7d-15.10 > 0.9.7d-5 is fine
Expat 1.95.7 > 1.95.6-8 is fine
Gcc 3.3.3 > 3.3.3 is fine
Table 1-6
Software Packages for the Red Hat OS
Package
Version
Remarks
Postfix 2.1.5-2.3 Postfix is SMTP server needed for MSP
Vsftpd 2.0.1.5 ftp server needed for MSP
tftp-server 0.39-1 Tftp server
apache v2 2.0.52-9.ent Apache server
libc6 2.3.4.2 > 2.3.2 is fine
Openssl 0.9.7a-43.1 > 0.9.7d-5 is fine
Expat 1.95.7-4 > 1.95.6-8 is fine
zlib1g 1.2.1.2-1
libsnmp5 5.1.2-11 > 5.1.2-5 is fine
libpcap0.8 0.8.3-7 > 0.8.3-5 is fine
libstdc++ 3.4.3-9.EL4 > 3.3.4-13 is fine
libgcc1 3.4.3-9.EL4 > 3.4.2-2
Gcc 3.4.3 > 3.3.3 is fine
10 Installing MSP 2.9 Software
Appendix B
This appendix describes how to install the packages required for MSP on the Red Hat and SUSE OS. For
sample installation documents, see the Installing MSP 2.9 on Red Hat OS and Installing MSP 2.9 on SUSE
OS.You can download these documents from the Symbol Developer zone at: http://devzone.symbol.com.
Installing Packages Required for MSP on Red Hat
During installation of Red Hat OS, choose the default installation. This will install the standard set of packages
that are needed for the OS. For installing the OS, see the Red Hat Installation Guide provided by the vendor.
After installing the OS using the default option, install the MSP required packages using the following steps:
1.
Select
Applications > System Settings > Add/Remove Applications
.
Under the Servers section:
1. Select Mail Server
i.
Check postfix.
ii.
Uncheck other packages.
2. Select FTP Server.
3. Select Legacy Network Server
i.
Select tftp.
ii.
Uncheck others packages.
4. Select MySQL Database
i.
Check perl-DBD-MySQL.
ii.
Uncheck other packages.
Under the Development Section
1. Select Development Tools
i.
Check elfutils.
ii.
Check all perl*** packages.
iii.
Uncheck other packages.
2. Select Legacy Software Development.
Under the System Section
Select System Tools
i.
Check net-snmp-utils.
ii.
Check samba-client
iii.
Check festival.
iv.
Uncheck all other packages.
2.
Click Update.
The system prompts for Linux CDs.
Installing MSP 2.9 Software 11
3.
Insert the CDs.
This installs the required packages on the Red Hat box.
Installing Packages Required for MSP on SUSE
During installation of the SUSE OS, choose the default installation. This will install the standard set of
packages that are needed for the OS. For installing the OS, see the SUSE installation guide provided by the
vendor.
After installing the OS using the default option, install the MSP required packages using the following steps:
1.
Select
Start > System> Yast
.
2.
Select the Software tab.
3.
Select the
Install and Remove Software package
option on the right pane.
a.
In the search text box, search for gcc.
i.
Select gcc.
ii.
Select libgcc.
iii.
Install the selected; choose ignore for any conflicts.
b.
Search for tftp
i.
Select yast2-tftpserver.
ii.
Select tftp.
iii.
Install the selected; choose ignore for any conflicts.
c.
Search for perl-DBI
i.
Select perl-DBI.
ii.
Install the selected, choose ignore for any conflicts.
d.
Search for apache2
i.
Select apache2.
ii.
Select apache2-prefork.
iii.
Install the selected; choose ignore for any conflicts.
12 Installing MSP 2.9 Software
Symbol Technologies, Inc.
One Symbol Plaza
Holtsville, New York 11742-1300
http://www.symbol.com
72-91852-02
Revision A - January 2007