FS
Documentation

COSmanager/User Guide/Installing COSmanager

This page was last modified 05:58, 6 August 2007.

From Documentation

< COSmanager | User Guide(Difference between revisions)
Jump to: navigation, search
Revision as of 12:52, 24 April 2006
Moff (Talk | contribs)

← Previous diff
Current revision
Daniels (Talk | contribs)
(To install the COSmanager distribution)
Line 6: Line 6:
-Once COSmanager is installed, the next task is to set up the initial COSmanager configuration — see [[#Configuring COSmanager|Configuring COSmanager]].+Once COSmanager is installed, the next task is to set up the initial COSmanager configuration — see [[COSmanager/User Guide/Configuring COSmanager|Configuring COSmanager]].
-----+{{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.}}
-;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.+
-----+
<br> <br>
== Installing the COSmanager Framework == == Installing the COSmanager Framework ==
-This section 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 COSmanager Applications and Modules|Installing COSmanager Applications and Modules]].+This section 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 [[COSmanager/User Guide/Installing Applications and Modules|Installing COSmanager Applications and Modules]].
<br> <br>
Line 40: Line 38:
*Open a root shell, either by logging in as root or running su from a shell prompt. *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.}}
-;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 file: <tt>cpio -icvB FSinstall < <file></tt>+*Change directory to {{icode|cd /tmp}}
-*Run FSinstall: <tt>./FSinstall ./<file></tt>+*Retrieve the installation script FSinstall from the distribution file: {{icode|cpio -icvB FSinstall < <file>}}
 +*Run {{icode|FSinstall: ./FSinstall ./<file>}}
FSinstall checks the password file to see if there is an existing copy of the COSmanager framework on this 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 COSmanager Applications and Modules|Installing COSmanager Applications and Modules]].+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 [[COSmanager/User Guide/Installing Applications and Modules|Installing COSmanager Applications and Modules]].
If you are reinstalling over a previous installation, FSinstall will save a copy of the old database. If you are reinstalling over a previous installation, FSinstall will save a copy of the old database.
Line 58: Line 55:
*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. *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.}}
-;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. *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.
Line 76: Line 71:
*Once all the licensing information has been successfully entered, the installation is complete. *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 COSmanager|Configuring COSmanager]].+The next step is to set up the initial COSmanager configuration. See [[COSmanager/User Guide/Configuring COSmanager|Configuring COSmanager]].
<br> <br>

Current revision

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:


Once COSmanager is installed, the next task is to set up the initial COSmanager configuration — see Configuring COSmanager.


Note
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.


Installing the COSmanager Framework

This section 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 COSmanager Applications and Modules.


What will happen

You will:


FSinstall will:


To install the COSmanager distribution


Caution
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.



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 COSmanager Applications and Modules.

If you are reinstalling over a previous installation, FSinstall will save a copy of the old database.


Note
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.
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

COSmanager must be licensed separately on each host on which it is installed.

The next step is to set up the initial COSmanager configuration. See Configuring COSmanager.