SysInfoTM 5.0 Installation

MagniComp Home Page
SysInfo Home Page

Contents

Documentation Guide

License Requirements

License Requirements Overview

SysInfo requires a license file containing valid license information for permanent use. If no license is provided, then SysInfo will run in DEMO mode for 60 days. During the DEMO period, SysInfo will provide the same information as is provided with a full license, but it will display a warning message stating that it is running in DEMO mode. Once the DEMO period has been reached, SysInfo will display an error stating so and will exit without providing any system information.

There is one exception to requiring a license file. If your Internet domain name is one of the domains known to SysInfo to be used exclusively by non-profit educational institutions such as .edu, then no license file is required. In this case, SysInfo will function as if a license file is present. No additional licensing is required.

Obtaining a License

You can purchase SysInfo licenses by following these steps:

  1. In a web browser, go to http://www.MagniComp.com/cgi-bin/mcservices.cgi
  2. If you do not already have an account, click on Create Account to create an account.
  3. Log in by entering your Username and Password.
  4. Click on Purchase and following the instructions to complete the purchase process.
  5. Once you have completed purchasing a license, your license will be emailed to the address you gave. Save the license to a file called license.mcl. You will be prompted for the location of this file during the installation.

Installing a License After SysInfo Installation

If you wish to install a license after you have already installed SysInfo, then use the following procedure:

  1. Obtain a License if you do not already have one.

  2. Install each license file you have by running the following command for each license file:

    /opt/sysinfo/setup --license
    Replace /opt/sysinfo with the directory name where SysInfo is installed if different. You can also specify the name of the license file to install:
    /opt/sysinfo/setup --license --licensefile file

  3. You can verify your license information by running:

    /opt/sysinfo/bin/mcsysinfo --license
    Replace /opt/sysinfo with the directory name where SysInfo is installed if different.

Overview

There are two different installation methods for installing SysInfo. Please choose one of the following:

  1. Binary (precompiled) distributions. Everything you need is precompiled and ready to install. This is the fastest and easiest means of installing SysInfo. We strongly recommend this method as option 2 can take significant time and is difficult to get right.

  2. Source distributions. Full source code is provided to build your own executable version. This method usually requires much more time and attention to detail to get things like C compiler software and versions right. It offers slightly more control over runtime configuration. This installation method is only recommended for advanced system administrators.

Installation of Binary Distributions

Introduction

With binary distributions, everything you need is precompiled and ready to install. This is the fastest and easiest means of installing SysInfo. We strongly recommend nearly all customers install our binary distributions as this will save you significant time. There is very little difference in the installed product between installing from a binary distribution and our source distribution.

Prerequisites

Installation Instructions

  1. Choose the product distribution file you wish to download. The available product distributions for download are as follows:
    Product Distribution File Contents
    mcsysinfo-5.0-os-arch.sh Standard end-user runtime with CLI, GUI, agent. You likely just want this distribution file.
    mcsysinfo-5.0-os-arch-noui.sh This distribution does not include the CLI or GUI, but does include everything you need to output mcsysinforeport(5) data. This product file is intended for our OEM customers.
    mcsysinfo-5.0-os-arch-sdk.sh This distribution contains the C Software Developers Kit for this release. It should be installed on top of the Standard end-user runtime product as it only contains the SDK and not the required base environment.
    You likely will only need the regular mcsysinfo-5.0-os-arch.sh runtime product distribution.

  2. Follow the instructions to Download the product distribution file you choose in the previous step.

  3. You should have a file named mcsysinfo-5.0-os-arch.sh  e.g. For a SunOS/Solaris SPARC distribution, the file would be called mcsysinfo-5.0-sunos-sparc.sh

  4. Become user `root' by running su or logging in as `root'.

    su
  5. If you are installing into a directory where SysInfo is already installed, you will need to uninstall the existing version or install SysInfo into a different directory. To uninstall the existing SysInfo, see the Remove Installation (UnInstall) section.

  6. Unpack the distribution and start the interactive setup program which will prompt you to enter all required information:

    /bin/sh mcsysinfo-5.0-os-arch.sh

  7. The installation is now complete. Open a shell prompt. If you are using csh(1) or tcsh(1) you will need to run:

    rehash
    To run SysInfo, run:
    mcsysinfo
    If you installed SysInfo in a directory not in your $PATH then you'll need to specify the full pathname. i.e.
    /opt/sysinfo/bin/mcsysinfo

Advanced Installation

Each binary distribution archive (the file you download which ends in .sh) is a self-contained self-extracting script. The top part of this file contains a sh(1) script which automatically unpacks the distribution files which are stored as a compressed (usually with bzip2(1)) tar(1) (using GNU tar) image in the bottom part of the archive file. The distribution archive contains within itself the compression tool and GNU tar programs necessary to extract the distribution. You therefor do not need your own copy of GNU tar or bzip2(1).

One of the distribution files is a program called setup which is used to actually install and configure SysInfo. When the distribution archive is run, it extracts the distribution files and executes setup unless certain command line options are used.

  1. Follow the instructions to Download the appropriate binary distribution for your system. You should have a file named mcsysinfo-5.0-os-arch.sh  e.g. For a SunOS SPARC distribution, the file would be called mcsysinfo-5.0-sunos-sparc.sh

  2. Become user `root' by running su or logging in as `root'.

    su

  3. To see a list of available options which are supported by the self-extracting archive, run the following:

    /bin/sh mcsysinfo-5.0-os-arch.sh --help

  4. To see a list of available options which are supported by the SysInfo setup program, run the following:

    /bin/sh mcsysinfo-5.0-os-arch.sh -- --help
    Note the first -- option which tells the archive to pass all remaining arguments to the setup program.

  5. To extract the distribution into the directory /tmp/mcsysinfo run the following:

    /bin/sh mcsysinfo-5.0-os-arch.sh --extract --target /tmp/mcsysinfo

  6. If you wish to perform a non-interactive installation which will not prompt for any information, run the following:

    /bin/sh mcsysinfo-5.0-os-arch.sh -- --confirm --acceptlicense --installdir dir
    where dir is the name of the directory where you want to install into. You may also want to use the --override option which will override any detected error conditions which would otherwise result in being prompted for a response.

    You can also specify which packages to install using --packages name1,name2,... where nameX is the name of a package. i.e. --packages base,config specifies the base and config packages. To obtain the list of valid package names, run the installation in interactive mode.

Installation of Source Distribution

Introduction

Full source code is provided to allow you to build your own executable version if you so choose. This method usually requires much more time and attention to detail to get things like C compiler software and versions right. It offers slightly more control over runtime configuration. This installation method is only recommended for advanced system administrators. We highly recommend that most customers install the binary distribution. It's much faster and easier.

Prerequisites

Compilation Notes

Installation Instructions

  1. Obtain Perl 5.6.1 or later. Download it and unpack it into a directory srcdir/perl/src where srcdir is the directory containing the source to SysInfo. As of SysInfo 5.0, Perl is a required component. Without Perl, SysInfo CLI, GUI, and Perl APIs will not function.

  2. If you wish to use the SysInfo GUI, download a copy of Perl-Tk and unpack it into a directory srcdir/perlmodules/Tk/src where srcdir is the directory containing the source to SysInfo. If you just want to use the SysInfo Command Line Interface (CLI), you can skip this step.

  3. Follow the instructions to Download the source distribution. You should have a file named mcsysinfo-5.0.tar.gz

  4. Unpack the distribution:

    gzip -d mcsysinfo-5.0.tar.gz | tar -xf -

  5. By default, configure will choose the name of the compiler which is correct for the system platform. However, if you have done things like make cc a link to gcc this may not work correctly in some cases. See the Compilation Notes for more specific details.

    If you need to specify a compiler to use, then specify one now by setting the environment variable $CC to the name of the compiler to use. For csh users use:

    setenv CC compiler

    For sh/bash/ksh users use:

    CC=compiler
    export CC

    where compiler is the name of the compiler to use. i.e cc or gcc.

  6. Run the configure program to build configuration information for your system:
    ./configure

    Without any options configure will build SysInfo with an installation directory of /opt/sysinfo. If you wish to specify an installation directory, then use the --prefix=dir argument. For instance, to use /tools/sysinfo as the main directory, run:

    ./configure --prefix=/tools/sysinfo

  7. Now compile and build everything by running make (make sure to use GNU make):

    make

  8. If you are installing into a directory where SysInfo is already installed, you will need to uninstall the existing version or install SysInfo into a different directory. To uninstall the existing SysInfo, run

    rm -rf dir
    where dir is the directory where SysInfo is installed.

  9. To install everything, run the following:
    make install

  10. If you are installing a license, copy the license file into prefix/config/license.mcl where prefix is the directory which SysInfo was installed into.

  11. The installation is now complete. To run SysInfo, open a shell prompt and run:
    mcsysinfo
    If you installed SysInfo in a directory not in your $PATH then you'll need to specify the full pathname. i.e.
    /tools/sysinfo/bin/mcsysinfo

Remove Installation (UnInstall)

To remove the software installed using setup, use the following procedure:
  1. Become user `root' be running su or logging in as `root'.

  2. To perform an interactive uninstall where you will be prompted for required information, run the setup (installation) program as follows and follow the directions:

    dir/setup --uninstall
    where dir is the directory where the software is installed.

    If you wish to perform a non-interactive uninstall which will not prompt for any information, run the following:
    dir/setup --uninstall --confirm
    where dir is the name of the directory where the software is installed. You may also want to use the --override option which will override any detected error conditions which would otherwise result in being prompted for a response.

  3. The uninstall operation is now complete.



 Copyright (c) 1992-2002 MagniComp
 This software may only be used in accordance with the license which is
 available as http://www.magnicomp.com/sysinfo/5.0/sysinfo-eu-license.shtml

$Revision: #2 $