| 1 | <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> |
|---|
| 2 | <HTML> |
|---|
| 3 | <!-- $Revision: 1.1.1.2 $ --> |
|---|
| 4 | |
|---|
| 5 | <HEAD> |
|---|
| 6 | <TITLE>MagniComp - SysInfo(tm) 4.0.2 Installation</TITLE> |
|---|
| 7 | </HEAD> |
|---|
| 8 | |
|---|
| 9 | <BODY TEXT="#000000" LINK="#ff0000" VLINK="#dd0000" BGCOLOR="#ffffff"> |
|---|
| 10 | |
|---|
| 11 | <CENTER> |
|---|
| 12 | <FONT COLOR=#FF0000 SIZE=4> |
|---|
| 13 | <b> |
|---|
| 14 | <a href="http://www.MagniComp.com"> |
|---|
| 15 | <img src="http://www.MagniComp.com/images/magnicomp-logo-2.gif" alt="MagniComp Home Page" border=0 valign=center align=center> |
|---|
| 16 | </a> |
|---|
| 17 | </b> |
|---|
| 18 | </FONT> |
|---|
| 19 | </CENTER> |
|---|
| 20 | <br> |
|---|
| 21 | |
|---|
| 22 | <center><h1><FONT COLOR="#000099">SysInfo<font size=-3><sup>TM</sup></font> 4.0.2 Installation</font></h1></center> |
|---|
| 23 | <center><h3><FONT COLOR="#000099"><a href="http://www.MagniComp.com">MagniComp</a></FONT></h3></center> |
|---|
| 24 | |
|---|
| 25 | <h1><FONT COLOR="#000099">Documentation Guide</font></h1> |
|---|
| 26 | <UL> |
|---|
| 27 | <LI><a href="README.html">SysInfo 4.0.2 README</a> - A guide to this product. |
|---|
| 28 | <LI><a href="doc/RELEASE_NOTES.html">SysInfo 4.0.2 Release Notes</a> |
|---|
| 29 | (doc/RELEASE_NOTES.html doc/RELEASE_NOTES.txt) |
|---|
| 30 | - Supported platforms, platform specific notes, and new features. |
|---|
| 31 | <LI><a href="INSTALL.html">SysInfo 4.0.2 Installation</a> |
|---|
| 32 | (INSTALL.html INSTALL.txt) |
|---|
| 33 | - Installation requirements and installation instructions |
|---|
| 34 | including how to compile from source. |
|---|
| 35 | </UL> |
|---|
| 36 | |
|---|
| 37 | <h1><FONT COLOR="#000099"><a name="license">License Requirements</a></font></h1> |
|---|
| 38 | <H2><a name="licenseover">License Requirements Overview</a></H2> |
|---|
| 39 | <P>SysInfo requires a license file containing valid license information |
|---|
| 40 | for permament use. If no license is provided, then SysInfo will run |
|---|
| 41 | in DEMO mode for 60 days. During this DEMO period, SysInfo will |
|---|
| 42 | provide the same information as is provided with a license as well |
|---|
| 43 | as a warning message stating that it is running in DEMO mode. |
|---|
| 44 | </P> |
|---|
| 45 | <P>There is one exception to requiring a license file. |
|---|
| 46 | If your Internet domain name is one of the |
|---|
| 47 | domains known to SysInfo to be used exclusively by non-profit |
|---|
| 48 | educational institutions such as <KBD>.edu</KBD>, then no license |
|---|
| 49 | file is required. In this case, SysInfo will function as if a |
|---|
| 50 | license file is present. No additional licensing is required. |
|---|
| 51 | </P> |
|---|
| 52 | <H2><a name="licenseget">Obtaining a License</a></H2> |
|---|
| 53 | <P> |
|---|
| 54 | You can purchase SysInfo licenses by following these steps:</P> |
|---|
| 55 | <OL> |
|---|
| 56 | <LI>In a web browser, go to |
|---|
| 57 | <a href="http://www.MagniComp.com/cgi-bin/mcservices.cgi">http://www.MagniComp.com/cgi-bin/mcservices.cgi</a> |
|---|
| 58 | <LI>If you do not already have an account, click on |
|---|
| 59 | <B>Create Account</b> to create an account. |
|---|
| 60 | <LI>Now log in by entering your <b>Username</b> and <B>Password</b>. |
|---|
| 61 | <LI>Click on <b>Purchase</b> and following the instructions to |
|---|
| 62 | complete the purchase process. |
|---|
| 63 | <LI>Once you have completed purchasing a license, |
|---|
| 64 | your license will be emailed to the address you gave. |
|---|
| 65 | Save the license to a file called <KBD>license.mcl</KBD>. |
|---|
| 66 | </OL> |
|---|
| 67 | |
|---|
| 68 | <h1><FONT COLOR="#000099">Overview</font></h1> |
|---|
| 69 | <P>There are two different installation methods for installing SysInfo. |
|---|
| 70 | Please choose one of the following:</P> |
|---|
| 71 | <UL> |
|---|
| 72 | <LI><P><A href="#bininstall">Binary (precompiled) distributions</a>. |
|---|
| 73 | Everything you need is |
|---|
| 74 | precompiled and ready to install. This is the fastest and easiest |
|---|
| 75 | means of installing SysInfo.</P> |
|---|
| 76 | <LI><P><a href="#srcinstall">Source distributions</a>. |
|---|
| 77 | Full source code is provided to build |
|---|
| 78 | your own executable version. This method usually requires much more |
|---|
| 79 | time and attention to detail to get things like C compiler software |
|---|
| 80 | and versions right. It offers slightly more control over runtime |
|---|
| 81 | configuration. This installation method is only recommended for |
|---|
| 82 | advanced system administrators.</P> |
|---|
| 83 | </UL> |
|---|
| 84 | |
|---|
| 85 | <h1><FONT COLOR="#000099"><a name="bininstall">Binary Distribution Installation</a></font></h1> |
|---|
| 86 | <H2>Prerequisites</H2> |
|---|
| 87 | <UL> |
|---|
| 88 | <LI><P>Have your <a href="#license">license</a> |
|---|
| 89 | file ready if you are installing a |
|---|
| 90 | permament license now. |
|---|
| 91 | See the <a href="#license">License Requirements</a> |
|---|
| 92 | section for more information.</P> |
|---|
| 93 | <LI><P>Make sure you read the <A HREF="doc/RELEASE_NOTES.html">RELEASE_NOTES.html</A> |
|---|
| 94 | (or <A HREF="doc/RELEASE_NOTES.txt">RELEASE_NOTES.txt</A>) file before |
|---|
| 95 | proceeding. This file contains valuable information on what system |
|---|
| 96 | platforms are supported.</P> |
|---|
| 97 | </UL> |
|---|
| 98 | <H2>Installation Instructions</H2> |
|---|
| 99 | <OL> |
|---|
| 100 | <LI><P>Follow the instructions to <A HREF="http://www.MagniComp.com/download">Download</A> |
|---|
| 101 | the appropriate distribution for your system. You should have a file |
|---|
| 102 | named <KBD>sysinfo-4.0.2<I>-</I><I>os</I>-<I>arch</I>.tar.gz</KBD> |
|---|
| 103 | e.g. For a SunOS SPARC distribution, the file would be called |
|---|
| 104 | <KBD>sysinfo-4.0.2-sunos-sparc.tar.gz</KBD></P> |
|---|
| 105 | <LI><P>Unpack the distribution: |
|---|
| 106 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 107 | <TD><KBD>gzip -d sysinfo-4.0.2-<I>os</I>-<I>arch</I>.tar.gz | tar -xf -</KBD></TD> |
|---|
| 108 | </TABLE></P> |
|---|
| 109 | <LI><P>Change directory into the newly unpacked distribution |
|---|
| 110 | directory: |
|---|
| 111 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 112 | <TD><KBD>cd sysinfo-4.0.2-<I>os</I>-<I>arch</I></KBD></TD> |
|---|
| 113 | </TABLE></P> |
|---|
| 114 | <LI><P>Become user `root' be running <KBD>su</KBD> |
|---|
| 115 | or logging in as `root'.</P> |
|---|
| 116 | <LI><P>To perform an interactive installation where you will |
|---|
| 117 | be prompted for required information, run the |
|---|
| 118 | setup (installation) program with no arguments |
|---|
| 119 | and follow the directions: |
|---|
| 120 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 121 | <TD><KBD>./setup</KBD></TD> |
|---|
| 122 | </TABLE></P> |
|---|
| 123 | If you wish to perform a non-interactive installation which will |
|---|
| 124 | not prompt for any information, run the following: |
|---|
| 125 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 126 | <TD><KBD>./setup --confirm --acceptlicense --installdir=<I>dir</I></KBD></TD> |
|---|
| 127 | </TABLE> |
|---|
| 128 | where <I>dir</I> is the name of the directory where you want to |
|---|
| 129 | install into. You may also want to use the <KBD>--override</KBD> |
|---|
| 130 | option which will override any detected error conditions which would |
|---|
| 131 | otherwise result in being prompted for a response.</P> |
|---|
| 132 | <LI>Installation is now complete.</P> |
|---|
| 133 | </OL> |
|---|
| 134 | <h1><FONT COLOR="#000099"><a name="srcinstall">Source Distribution Build and Installation</a></font></h1> |
|---|
| 135 | <H2>Prerequisites</H2> |
|---|
| 136 | <UL> |
|---|
| 137 | <LI><P>Have your <a href="#license">license</a> |
|---|
| 138 | file ready if you are installing a |
|---|
| 139 | permament license now. |
|---|
| 140 | See the <a href="#license">License Requirements</a> |
|---|
| 141 | section for more information.</P> |
|---|
| 142 | <LI><P>Make sure you read the <A HREF="doc/RELEASE_NOTES.html">RELEASE_NOTES.html</A> |
|---|
| 143 | (or <A HREF="doc/RELEASE_NOTES.txt">RELEASE_NOTES.txt</A>) file before |
|---|
| 144 | proceeding. This file contains valuable information on what system |
|---|
| 145 | platforms are supported.</P> |
|---|
| 146 | <LI><P>Make sure you have a supported C compiler. SysInfo usually, |
|---|
| 147 | but not always, supports <a href="http://www.gnu.org">GNU's</a> |
|---|
| 148 | <a href="http://gcc.gnu.org">GCC</a> compiler. However, GCC does not |
|---|
| 149 | always provide full support for SysInfo features. This is especially |
|---|
| 150 | true on systems running Solaris 7 and later in 64-bit mode. Please |
|---|
| 151 | read the <A HREF="doc/RELEASE_NOTES.html">RELEASE_NOTES</A> for platform |
|---|
| 152 | specific information.</P> |
|---|
| 153 | </UL> |
|---|
| 154 | <H2><a name="compilenotes">Compilation Notes</a></H2> |
|---|
| 155 | <UL> |
|---|
| 156 | <LI><P><B>Supported Platforms.</B> SysInfo uses GNU autoconfigure |
|---|
| 157 | (i.e. A "<KBD>./configure</KBD>" |
|---|
| 158 | script) to configure many system parameters before compilation. |
|---|
| 159 | However, this does not mean SysInfo will work on any system. SysInfo |
|---|
| 160 | contains very specific support for specific platforms as specified |
|---|
| 161 | in the <A HREF="doc/RELEASE_NOTES.html">RELEASE_NOTES</A>.</P> |
|---|
| 162 | |
|---|
| 163 | <LI><P><B>Compiling for different OS versions</B>: In general, |
|---|
| 164 | SysInfo will run on the OS version you compiled it on and future |
|---|
| 165 | releases. It will not run on an OS older than the OS version it |
|---|
| 166 | was compiled on. There are exceptions to this, including those |
|---|
| 167 | mentioned below for Solaris. SysInfo defines some (cryptic) rules |
|---|
| 168 | for each OS which specify these what OS versions a binary runs on. |
|---|
| 169 | These rules are defined in <KBD>config/<i>os</i>.rcf</kbd> where |
|---|
| 170 | <KBD<i>os</i></kbd> is the name of the OS in lower case. e.g. |
|---|
| 171 | <kbd>config/sunos.rcf</kbd> is the SunOS/Solaris rule file.</P> |
|---|
| 172 | |
|---|
| 173 | <LI><P><B><a name="solcompile">Solaris 7 and later</a></B>: Starting |
|---|
| 174 | with Solaris 7 and later, you will need two binaries for each |
|---|
| 175 | version of the OS - one for 32-bit systems and one for 64-bit |
|---|
| 176 | systems. (All <B>Ultra</B> machines are 64-bit). You can check which |
|---|
| 177 | version you are running by looking at the first line of |
|---|
| 178 | <kbd>/etc/motd</kbd> |
|---|
| 179 | for the phrase "64-bit". |
|---|
| 180 | </P> |
|---|
| 181 | <P>To build a binary of SysInfo |
|---|
| 182 | for a system running a 64-bit kernel, you must have a compatible |
|---|
| 183 | compiler. Sun Workshop (now Forte) |
|---|
| 184 | Compiler 5.0 is the first Sun compiler to support |
|---|
| 185 | this via the <kbd>-xarch=v9</kbd> option. GCC is suppose to support |
|---|
| 186 | 64-bit compiles via the <kbd>-m64</kbd> option in GCC 2.95.2 and later, |
|---|
| 187 | however MagniComp has been unable to make this work. |
|---|
| 188 | </P> |
|---|
| 189 | <P>By default, |
|---|
| 190 | a binary that runs on the local system will be built. You can |
|---|
| 191 | force a build of |
|---|
| 192 | a 64-bit binary on a 32-bit system and vice-versa. To |
|---|
| 193 | build a 64-bit binary on a 32-bit system, set the environment |
|---|
| 194 | variable <B>KISA</B> to be <B>sparcv9</B>. To build a 32-bit |
|---|
| 195 | binary on a 64-bit system, set <B>KISA</B> to be <B>sparcv8</B>. |
|---|
| 196 | i.e. For csh users: |
|---|
| 197 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 198 | <TD><KBD>setenv KISA sparcv9</KBD></TD> |
|---|
| 199 | </TABLE> |
|---|
| 200 | For sh/ksh users: |
|---|
| 201 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 202 | <TD><KBD>KISA=sparcv9<BR>export KISA</KBD></TD> |
|---|
| 203 | </TABLE></P> |
|---|
| 204 | |
|---|
| 205 | <LI><P><b>SunOS 4.x (Solaris 1.x)</b>. Under SunOS |
|---|
| 206 | 4.x (Solaris 1.x), |
|---|
| 207 | you must compile SysInfo for each kernel architecture |
|---|
| 208 | (karch) and each OS version. i.e. "sun4c SunOS 4.1.4", |
|---|
| 209 | "sun4m SunOS 4.1.4", etc. This is not necessary under |
|---|
| 210 | SunOS 5.x (Solaris 2.x and later).</P> |
|---|
| 211 | </OL> |
|---|
| 212 | <H2>Installation Instructions</H2> |
|---|
| 213 | <OL> |
|---|
| 214 | <LI><P>Follow the instructions to |
|---|
| 215 | <A HREF="http://www.MagniComp.com/download">Download</A> the source |
|---|
| 216 | distribution. You should have a file named <KBD>sysinfo-4.0.2.tar.gz |
|---|
| 217 | </KBD>Please note that SysInfo should only be run on the |
|---|
| 218 | same OS version as it was compiled on. i.e. If compiled on SunOS |
|---|
| 219 | 5.5, do not run the same binary on 5.6. If you attempt to do this, |
|---|
| 220 | SysInfo will issue a warning. |
|---|
| 221 | </P> |
|---|
| 222 | <LI><P>Unpack the distribution: |
|---|
| 223 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 224 | <TD><KBD>gzip -d sysinfo-4.0.2.tar.gz | tar -xf -</KBD></TD> |
|---|
| 225 | </TABLE></P> |
|---|
| 226 | <LI><P>By default, <KBD>configure</KBD> will choose the |
|---|
| 227 | name of the compiler which is correct for the system platform. |
|---|
| 228 | However, if you have done things like make <KBD>cc</KBD> a link to |
|---|
| 229 | <KBD>gcc</KBD> this may not work correctly in some cases. |
|---|
| 230 | See the <a href="#compilenotes">Compilation Notes</a> for more specific |
|---|
| 231 | details.</p> |
|---|
| 232 | <P> |
|---|
| 233 | If you need to |
|---|
| 234 | specify a compiler to use, then specify one now by setting the |
|---|
| 235 | environment variable <KBD>$CC</KBD> to the name of |
|---|
| 236 | the compiler to use. For csh users use: |
|---|
| 237 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 238 | <TD><KBD>setenv CC <i>compiler</i></KBD></TD> |
|---|
| 239 | </TABLE> |
|---|
| 240 | <P>For sh/bash/ksh users use: |
|---|
| 241 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 242 | <TD><KBD>CC=<i>compiler</i><BR>export CC</KBD></TD> |
|---|
| 243 | </TABLE> |
|---|
| 244 | <P STYLE="margin-bottom: 0in">where <i>compiler</i> is the name of the |
|---|
| 245 | compiler to use. i.e <KBD>cc</KBD> or <KBD>gcc</KBD>. |
|---|
| 246 | </P> |
|---|
| 247 | <LI>Run the <KBD>configure</KBD> program to build configuration |
|---|
| 248 | information for your system: |
|---|
| 249 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 250 | <TD><KBD>./configure</KBD></TD> |
|---|
| 251 | </TABLE> |
|---|
| 252 | </P><P>Without any options <KBD>configure</KBD> will build |
|---|
| 253 | SysInfo with an installation directory of either |
|---|
| 254 | <KBD>/opt/sysinfo</KBD> or <KBD>/usr/local/sysinfo</KBD> if your |
|---|
| 255 | system's OS does not follow the convention of <KBD>/opt</KBD>. |
|---|
| 256 | If you wish to specify an installation directory, then use the |
|---|
| 257 | <KBD>--prefix=<i>dir</i></KBD> argument. For instance, to use |
|---|
| 258 | <KBD>/tools/sysinfo</KBD> as the main directory, run: |
|---|
| 259 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 260 | <TD><KBD>./configure --prefix=/tools/sysinfo</KBD></TD> |
|---|
| 261 | </TABLE></P> |
|---|
| 262 | <LI><P>Now compile and build everything: |
|---|
| 263 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 264 | <TD><KBD>make</KBD></TD> |
|---|
| 265 | </TABLE></P> |
|---|
| 266 | |
|---|
| 267 | <LI>To install everything, run the following: |
|---|
| 268 | <TABLE border=0 bgcolor=#e6e6e6 cellpadding=20 width="80%"> |
|---|
| 269 | <TD><KBD>make install</KBD></TD> |
|---|
| 270 | </TABLE></P> |
|---|
| 271 | |
|---|
| 272 | <LI>If you are installing a license, copy the license file |
|---|
| 273 | into <KBD><i>dir</i>/config/license.mcl</KBD> where |
|---|
| 274 | <kbd><i>dir</i></kbd> |
|---|
| 275 | is the directory which SysInfo was installed into.</P> |
|---|
| 276 | <LI>The installation is now complete. |
|---|
| 277 | </OL> |
|---|
| 278 | |
|---|
| 279 | <HR> |
|---|
| 280 | <CENTER> |
|---|
| 281 | <FONT SIZE=2><i>Copyright (c) 1992-2001 MagniComp</i></FONT> |
|---|
| 282 | <BR> |
|---|
| 283 | <FONT SIZE=2><i>$Revision: 1.1.1.2 $</i></FONT> |
|---|
| 284 | </CENTER> |
|---|
| 285 | |
|---|
| 286 | </BODY> |
|---|
| 287 | </HTML> |
|---|
