| 1 | [MagniComp Systems] |
|---|
| 2 | ------------------------------------------------------------------------ |
|---|
| 3 | |
|---|
| 4 | SysInfo Installation |
|---|
| 5 | |
|---|
| 6 | 1. Follow the instructions to Download and unpack a distribution. You can |
|---|
| 7 | either download complete source and build (compile) from scratch, or |
|---|
| 8 | you can choose to download a precompiled (binary) distribution. We |
|---|
| 9 | recommend that you use the binary distributions if there is one |
|---|
| 10 | available for your platform. You must download the source and compile |
|---|
| 11 | otherwise. Please note that sysinfo should only be run on the same OS |
|---|
| 12 | version as it was compiled on. i.e. If compiled on SunOS 5.5, do not |
|---|
| 13 | run the same binary on 5.6. If you attempt to do this, sysinfo will |
|---|
| 14 | issue a warning. |
|---|
| 15 | 2. Read the RELEASE_NOTES BEFORE proceeding. |
|---|
| 16 | 3. If compiling from source: |
|---|
| 17 | 1. Read the comments in `Makefile' and make any necessary changes. |
|---|
| 18 | The defaults should be fine for most sites. You may want to change |
|---|
| 19 | the PREFIX and/or CONFDIR variables. |
|---|
| 20 | 2. Run `make'. Please note the following: |
|---|
| 21 | + You will almost always need to compile sysinfo on EACH |
|---|
| 22 | version of your operating system (OS). |
|---|
| 23 | + Starting with Solaris 7 and later, you will need two binaries |
|---|
| 24 | for each version of the OS - one for 32-bit systems and one |
|---|
| 25 | for 64-bit systems (all Ultra machines are 64-bit). You can |
|---|
| 26 | check which version you are running by looking at the first |
|---|
| 27 | line of /etc/motd for the phrase "64-bit". |
|---|
| 28 | |
|---|
| 29 | To build a binary of sysinfo for a system running a 64-bit |
|---|
| 30 | kernel, you must have a compatible compiler. Sun Compiler 5.0 |
|---|
| 31 | is the first Sun compiler to support this via the -xarch=v9 |
|---|
| 32 | option. At the time this document was written there was no |
|---|
| 33 | version of GCC which supports 64-bit compiles. |
|---|
| 34 | |
|---|
| 35 | By default, the make will build a binary that runs on the |
|---|
| 36 | local system. You can also force make to build a 64-bit |
|---|
| 37 | binary on a 32-bit system and vice-versa. To build a 64-bit |
|---|
| 38 | binary on a 32-bit system, set the environment variable KISA |
|---|
| 39 | to be sparcv9. To build a 32-bit binary on a 64-bit system, |
|---|
| 40 | set KISA to be sparcv8. i.e. For csh users: |
|---|
| 41 | |
|---|
| 42 | setenv KISA sparcv9 |
|---|
| 43 | |
|---|
| 44 | For sh/ksh users: |
|---|
| 45 | |
|---|
| 46 | KISA=sparcv9 |
|---|
| 47 | export KISA |
|---|
| 48 | |
|---|
| 49 | + Under SunOS 4.x, you must compile sysinfo for each kernel |
|---|
| 50 | architecture (karch) and each OS version. i.e. "sun4c SunOS |
|---|
| 51 | 4.1.4", "sun4m SunOS 4.1.4", etc. This is not necessary under |
|---|
| 52 | SunOS 5.x. |
|---|
| 53 | 4. Continue with the following instructions for both source compiles and |
|---|
| 54 | binary distribution downloads... |
|---|
| 55 | 5. Run `make test' to run sysinfo right now as a test. This should be done |
|---|
| 56 | as `root' in order for sysinfo to function properly. |
|---|
| 57 | 6. To install the sysinfo program and all required files, run `make |
|---|
| 58 | install'. If you are installing a Binary distribution and installed the |
|---|
| 59 | config files into a non-default location (somewhere other than |
|---|
| 60 | /var/local/sysinfo/conf), you need to create a file called |
|---|
| 61 | /etc/sysinfo.cf with the entry: |
|---|
| 62 | |
|---|
| 63 | ConfDir Dir |
|---|
| 64 | |
|---|
| 65 | where Dir is the directory the *.cf files where installed in. |
|---|
| 66 | 7. To install man pages, run `make install.man'. |
|---|
| 67 | 8. You may need a license to run SysInfo. Go to |
|---|
| 68 | http://www.magnicomp.com/sysinfo for more information. |
|---|
| 69 | |
|---|
| 70 | ------------------------------------------------------------------------ |
|---|
