COSmanager/User Guide/Installing COSmanager
From Documentation
(Difference between revisions)
| Revision as of 06:27, 18 April 2006 Daniels (Talk | contribs) ← Previous diff |
Revision as of 06:37, 20 April 2006 Daniels (Talk | contribs) Next diff → |
||
| Line 1: | Line 1: | ||
| - | COSmanager provides a framework for installing and managing COSmanager applications. | + | COSmanager provides a framework for installing and managing COSmanager applications. You first install and configure the COSmanager framework, then install and configure each COSmanager application. |
| - | You first install and configure the COSmanager framework, then install and | + | |
| - | configure each COSmanager application. | + | This section explains the steps you need to follow to install the COSmanager framework: |
| - | This chapter explains the steps you need to follow to install the COSmanager framework: | + | *run the install script to copy the files from the distribution tape |
| - | • run the install script to copy the files from the distribution tape | + | *license the software |
| - | • license the software | + | |
| - | Once COSmanager is installed, the next task is to set up the initial COSmanager | + | Once COSmanager is installed, the next task is to set up the initial COSmanager configuration — see [[Configuring COSMOS]]. |
| - | configuration—see Configuring COSMOS on page 35. | + | |
| - | Note You must have a valid license key for each host that you intend to | + | Note You must have a valid license key for each host that you intend to install COSmanager on. |
| - | install COSmanager on. See your COSmanager distributor to obtain | + | See your COSmanager distributor to obtain license keys if you don’t already have them. |
| - | license keys if you don’t already have them. | + | |
| - | 28 Installing COSmanager | + | |
| - | Installing the COSmanager Framework | + | == Installing the COSmanager Framework == |
| - | This chapter explains how to install the COSmanager application framework on a | + | This chapter explains how to install the COSmanager application framework on a host for the first time. You will only need to install the framework once. Once COSmanager is fully installed, upgrading or installing a new version of the COSmanager framework is handled in the same way as for any other COSmanager product or application. See [[Installing COSMOS Applications and Modules]]. |
| - | host for the first time. | + | |
| - | You will only need to install the framework once. Once COSmanager is fully | + | === What will happen === |
| - | installed, upgrading or installing a new version of the COSmanager framework is | + | |
| - | handled in the same way as for any other COSmanager product or application. See | + | |
| - | Installing COSMOS Applications and Modules on page 67. | + | |
| - | What will happen | + | |
| You will: | You will: | ||
| - | • open a root shell, and extract FSinstall from the distribution tape | + | *open a root shell, and extract FSinstall from the distribution tape |
| - | • run FSinstall | + | *run FSinstall |
| - | • specify a home directory and password for COSmanager | + | *specify a home directory and password for COSmanager |
| - | • enter the license key | + | *enter the license key |
| + | |||
| FSinstall will: | FSinstall will: | ||
| - | • check whether you are installing COSmanager for the first time or reinstalling | + | *check whether you are installing COSmanager for the first time or reinstalling over a previous or partial installation |
| - | over a previous or partial installation | + | *create an account and group for COSmanager |
| - | • create an account and group for COSmanager | + | *copy the COSmanager files from the distribution tape, and set their ownership and permissions |
| - | • copy the COSmanager files from the distribution tape, and set their ownership | + | *verify your license key |
| - | and permissions | + | |
| - | • verify your license key | + | === Remote installation === |
| - | Remote installation | + | You may wish to install COSmanager applications on a host that does not have an attached tape drive. [[Installing From a Remote Host]] describes how to allow COSmanager access to the target host. |
| - | You may wish to install COSmanager applications on a host that does not have an | + | |
| - | attached tape drive. Installing From a Remote Host on page 72 describes how to allow | + | Alternatively, you can use dd to extract selected files from the tape and ftp or rcp to copy them to the remote host. |
| - | COSmanager access to the target host. | + | |
| - | Alternatively, you can use dd to extract selected files from the tape and ftp or rcp | + | The first file on the distribution tape (file 0) contains the install script FSinstall and a ‘table of contents’ listing the COSmanager applications stored on this tape. The second file contains the COSmanager framework. Each subsequent file contains |
| - | to copy them to the remote host. | + | a COSmanager application. |
| - | Installing COSmanager 29 | + | |
| - | The first file on the distribution tape (file 0) contains the install script FSinstall | + | == To install the COSmanager distribution === |
| - | and a ‘table of contents’ listing the COSmanager applications stored on this tape. | + | *Open a root shell, either by logging in as root or running su from a shell prompt. |
| - | The second file contains the COSmanager framework. Each subsequent file contains | + | |
| - | a COSmanager application. | + | Caution Don’t shell out from an existing COSmanager application. |
| - | To install the COSmanager distribution | + | If you attempt to install or upgrade COSmanager from a COSmanager shell, the environment will not be set up correctly and you may damage the existing software. |
| - | 1. Open a root shell, either by logging in as root or running su from a shell | + | |
| - | prompt. | + | *Change directory to /tmp. |
| - | Caution Don’t shell out from an existing COSmanager application. If you attempt to install | + | *Retrieve the installation script FSinstall from the distribution tape: cpio -icvB FSinstall < no-rewind device |
| - | or upgrade COSmanager from a COSmanager shell, the environment will not be set | + | *Run FSinstall: ./FSinstall [ -h Drivehost ] no-rewind device where no-rewind device is the name of the drive containing the distribution tape, and -h Drivehost is the name of the host to which the drive is attached (the default is the current host). |
| - | up correctly and you may damage the existing software. | + | |
| - | 2. Change directory to /tmp. | + | FSinstall checks the password file to see if there is an existing copy of the COSmanager framework on this host. |
| - | Figure 4 — Preparing to unload FSinstall | + | |
| - | 3. Retrieve the installation script FSinstall from the distribution tape: | + | If an older version of COSmanager is found, FSinstall terminates. You should run the existing COSmanager and install this new version using the Application > Install option. See [[Installing COSMOS Applications and Modules]]. |
| - | cpio -icvB FSinstall < no-rewind device | + | |
| - | 4. Run FSinstall: | + | If you are reinstalling over a previous installation, FSinstall will save a copy of the old database. |
| - | ./FSinstall [ -h Drivehost ] no-rewind device | + | |
| - | where no-rewind device is the name of the drive containing the distribution | + | *If you are installing for the first time, FSinstall prompts you for the home directory for COSmanager. Enter a directory name or press Return to accept the default. |
| - | tape, and -h Drivehost is the name of the host to which the | + | *FSinstall creates an account for COSmanager, using the highest free UID lower than 100. Then it creates a group, also called COSmanager, using the highest free GID lower than 100. |
| - | drive is attached (the default is the current host). | + | |
| - | 30 Installing COSmanager | + | Note Some UNIX systems may warn you that the UID used for COSmanager is in the range usually reserved for system accounts. |
| - | Figure 5 — Extract and run FSinstall | + | The warning can be ignored. |
| - | FSinstall checks the password file to see if there is an existing copy of | + | |
| - | the COSmanager framework on this host. | + | *Now enter a password for the COSmanager account. Once you have finished running FSinstall, you will need this password to log in to the COSmanager account to configure COSmanager. |
| - | If an older version of COSmanager is found, FSinstall terminates. You | + | |
| - | should run the existing COSmanager and install this new version using the | + | :FSinstall now: |
| - | Application > Install option. See Installing COSMOS Applications | + | :*unloads the files from the distribution into the COSmanager home directory |
| - | and Modules on page 67. | + | :*sets their ownership and permissions |
| - | If you are reinstalling over a previous installation, FSinstall will save a | + | :*synchronizes COSmanager’s own hostinfo and netinfo tables with information from your system hosts and networks files |
| - | copy of the old database. | + | :*creates audit trails and log files |
| - | 5. If you are installing for the first time, FSinstall prompts you for the | + | |
| - | home directory for COSmanager. Enter a directory name or press Return | + | *The next step is to license the software. You can find this information on the Licence Key Details form, which you should have received with the COSmanager package. If you don’t have this form, or if there is any problem with licensing, contact your COSmanager distributor. |
| - | to accept the default. | + | |
| - | Figure 6 — Enter COSmanager home directory | + | COSmanager must be licensed separately on each host on which it is installed. |
| - | Installing COSmanager 31 | + | |
| - | 6. FSinstall creates an account for COSmanager, using the highest free | + | *Once all the licensing information has been successfully entered, the installation is complete. |
| - | UID lower than 100. Then it creates a group, also called COSmanager, | + | |
| - | using the highest free GID lower than 100. | + | The next step is to set up the initial COSmanager configuration. See [[Configuring COSMOS]]. |
| - | Note Some UNIX systems may warn you that the UID used for | + | |
| - | COSmanager is in the range usually reserved for system accounts. The | + | |
| - | warning can be ignored. | + | |
| - | 7. Now enter a password for the COSmanager account. Once you have finished | + | |
| - | running FSinstall, you will need this password to log in to the | + | |
| - | COSmanager account to configure COSmanager. | + | |
| - | Figure 7 — Create COSmanager UID and group, and set password | + | |
| - | FSinstall now: | + | |
| - | • unloads the files from the distribution into the COSmanager home directory | + | |
| - | • sets their ownership and permissions | + | |
| - | • synchronizes COSmanager’s own hostinfo and netinfo tables with | + | |
| - | information from your system hosts and networks files | + | |
| - | • creates audit trails and log files | + | |
| - | 32 Installing COSmanager | + | |
| - | Figure 8 — Create directory structure and audit trails | + | |
| - | 8. The next step is to license the software. You can find this information on | + | |
| - | the Licence Key Details form, which you should have received with the | + | |
| - | COSmanager package. If you don’t have this form, or if there is any problem | + | |
| - | with licensing, contact your COSmanager distributor. | + | |
| - | Figure 9 — Enter product code(s) and licence key | + | |
| - | Installing COSmanager 33 | + | |
| - | COSmanager must be licensed separately on each host on which it is | + | |
| - | installed. | + | |
| - | 9. Once all the licensing information has been successfully entered, the installation | + | |
| - | is complete. | + | |
| - | Figure 10 — Successful COSmanager installation | + | |
| - | The next step is to set up the initial COSmanager configuration. See Configuring | + | |
| - | COSMOS on page 35. | + | |
Revision as of 06:37, 20 April 2006
COSmanager provides a framework for installing and managing COSmanager applications. You first install and configure the COSmanager framework, then install and configure each COSmanager application.
This section explains the steps you need to follow to install the COSmanager framework:
- run the install script to copy the files from the distribution tape
- license the software
Once COSmanager is installed, the next task is to set up the initial COSmanager configuration — see Configuring COSMOS.
Note You must have a valid license key for each host that you intend to install COSmanager on. See your COSmanager distributor to obtain license keys if you don’t already have them.
Contents |
Installing the COSmanager Framework
This chapter explains how to install the COSmanager application framework on a host for the first time. You will only need to install the framework once. Once COSmanager is fully installed, upgrading or installing a new version of the COSmanager framework is handled in the same way as for any other COSmanager product or application. See Installing COSMOS Applications and Modules.
What will happen
You will:
- open a root shell, and extract FSinstall from the distribution tape
- run FSinstall
- specify a home directory and password for COSmanager
- enter the license key
FSinstall will:
- check whether you are installing COSmanager for the first time or reinstalling over a previous or partial installation
- create an account and group for COSmanager
- copy the COSmanager files from the distribution tape, and set their ownership and permissions
- verify your license key
Remote installation
You may wish to install COSmanager applications on a host that does not have an attached tape drive. Installing From a Remote Host describes how to allow COSmanager access to the target host.
Alternatively, you can use dd to extract selected files from the tape and ftp or rcp to copy them to the remote host.
The first file on the distribution tape (file 0) contains the install script FSinstall and a ‘table of contents’ listing the COSmanager applications stored on this tape. The second file contains the COSmanager framework. Each subsequent file contains a COSmanager application.
To install the COSmanager distribution =
- Open a root shell, either by logging in as root or running su from a shell prompt.
Caution Don’t shell out from an existing COSmanager application. If you attempt to install or upgrade COSmanager from a COSmanager shell, the environment will not be set up correctly and you may damage the existing software.
- Change directory to /tmp.
- Retrieve the installation script FSinstall from the distribution tape: cpio -icvB FSinstall < no-rewind device
- Run FSinstall: ./FSinstall [ -h Drivehost ] no-rewind device where no-rewind device is the name of the drive containing the distribution tape, and -h Drivehost is the name of the host to which the drive is attached (the default is the current host).
FSinstall checks the password file to see if there is an existing copy of the COSmanager framework on this host.
If an older version of COSmanager is found, FSinstall terminates. You should run the existing COSmanager and install this new version using the Application > Install option. See Installing COSMOS Applications and Modules.
If you are reinstalling over a previous installation, FSinstall will save a copy of the old database.
- If you are installing for the first time, FSinstall prompts you for the home directory for COSmanager. Enter a directory name or press Return to accept the default.
- FSinstall creates an account for COSmanager, using the highest free UID lower than 100. Then it creates a group, also called COSmanager, using the highest free GID lower than 100.
Note Some UNIX systems may warn you that the UID used for COSmanager is in the range usually reserved for system accounts. The warning can be ignored.
- Now enter a password for the COSmanager account. Once you have finished running FSinstall, you will need this password to log in to the COSmanager account to configure COSmanager.
- FSinstall now:
- unloads the files from the distribution into the COSmanager home directory
- sets their ownership and permissions
- synchronizes COSmanager’s own hostinfo and netinfo tables with information from your system hosts and networks files
- creates audit trails and log files
- The next step is to license the software. You can find this information on the Licence Key Details form, which you should have received with the COSmanager package. If you don’t have this form, or if there is any problem with licensing, contact your COSmanager distributor.
COSmanager must be licensed separately on each host on which it is installed.
- Once all the licensing information has been successfully entered, the installation is complete.
The next step is to set up the initial COSmanager configuration. See Configuring COSMOS.