Page History
...
Anchor | ||||
---|---|---|---|---|
|
For each AppTier, specific Collectors collect performance data from instances in your environment. These agents need to be installed for each instance you want to monitor, and activated on the server computer where the instance resides. The Collectors send this data to the relevant product FocalPoint, which processes the information and stores it in the PMDB. The PMDB keeps the data for long-term trend and capacity analyses.
...
Info |
---|
Insight, Report Manager FocalPoints, and PMDB FocalPoints must be running during the Add-on AppTier plug-in process. |
Anchor | ||||
---|---|---|---|---|
|
Once you have installed the Precise framework, you can install the Add-on AppTier Collector for the AppTiers that are part of your environment. For each AppTier, specific Collectors collect performance data from the instances in your environment. These agents need to be installed for each instance you want to monitor, and activated on the server where the instance resides. The Collectors send this data to the relevant product FocalPoint, which processes the information and stores it in the PMDB. The PMDB keeps the data for long-term trend and capacity analyses.
...
For more information, see Add-on AppTier installation package contents. For more information, see the Precise Installation Guide and the the Precise Administration Guide.
Adding a new Add-on AppTier
All Add-on AppTiers are added to the Precise environment using AdminPoint.
...
- Launch AdminPoint and go to Setup > Instances & Clusters.
- Click Add Instance.
- From the drop-down menu, select Add a new Technology.
- In the new dialog box, choose the Package file you created. The SDK Collector version is automatically filled in.
- Click OK.
About error messages when installing an Add-on AppTier
Certain error messages can appear during a plug-in installation.
Table 3- 1 Typical error messages when installing an Add-on AppTier
Message | Description |
---|---|
ZIP_SECURITY_CHECK_FAIL | The security check for the installation package files has failed. Contact PreciseTechnical Support. |
ZIP_FILES_NOT_VALID | The zip files are not valid. For example: XML validation has failed or the application tag does not exist. |
APPLICATION_NAME_ALREA DY_EXISTS | The unique AppTier Name (Application Name) already exists. Rename this AppTier Name. |
About installing an instance for an Add-on AppTier
After the Add-on AppTier installation has finished, AdminPoint lets you install (add), update, or uninstall the Precise environment instance for the Add-on AppTier.
...
- Add a new instance
- Edit an existing instance
- Uninstall (Delete) an instance
Installing an instance for an Add-on AppTier
Before installing an instance for an Add-on AppTier, define it by AppTier instance name, monitored server name, and collection server name.
...
- Launch AdminPoint and select Setup > Instances & Clusters.
- Click Add Instance.
- From the dropdown menu, select the Add-on technology.
- Click OK.
In the SDK Instance Installation - Property Settings dialog box, insert the Instance Server name, the Instance Name, and the Collect Activity from This Server name.
Info The name used in Collect Activity from This Server must be the same as the Instance Server name.
- Click Next.
- Click Finished.
Installing the Insight ARM extension dynamic library
When using the ARM API option, the Insight SDK Collector is installed on the monitored server. At the end of an instance installation, manual action items are displayed and must be performed. Follow the instructions on the screen to complete instance installation.
...
After completing installation, use the Precise AdminPoint PMDB, Warehouse Status, and Agents screens to manage Add-on AppTier instances. You can also use Environment Settings. For more information see the Precise Administration Guide.
About the Agents workspace for an Insight SDK AppTier instance
The Insight SDK Collector is installed for each Add-on AppTier instance which uses the ARM API option. Each agent is displayed in a row in the AdminPoint's Agents workspace.
Info |
---|
The Agents workspace does not display any rows Add-on AppTier instances which use the files API option. These Collectors are not managed by Precise. |
Removing an Add-on AppTier instance installation package
Use the Setup > Instances and Clusters option in AdminPoint to uninstall Add-on AppTier instances and remove the Add-on AppTier installation package completely. Use the following procedures to uninstall Add-on AppTier instances and remove the Add-on AppTier completely.
...
- Launch AdminPoint and select Setup > Instances & Clusters.
- Select the instance you wish to delete.
Click Delete.
Info If the deleted instance was the last instance in an AppTier, you will have the option of deleting the AppTier. All AppTier instances must be deleted before the AppTier can be deleted.
Deleting an Add-on AppTier instance which works with an ARM API option
When deleting an Add-on AppTier instance, which is monitored by the Insight SDK Collector for the ARM API, Precise removes the Insight Collector for this Insight. At the end of the process, you are instructed to undo the manual action items you had performed during instance installation.
...
- In AdminPoint, launch the Agents workspace and click Stop to stop running the Add-on AppTier agent. Select the Insight SDK Agent row which monitors the Add-on AppTier instance on the relevant server.
- Replace the Insight SDK extension dynamic library with the original ARM dynamic library (previously stored as backup in another directory during installation).
- Remove the Insight environment variables from the Add-on AppTier application environment variables.
- In AdminPoint, launch the Agents workspace and click Start to restart the agent.
Updating an Existing Add-on AppTier
If the Add-on AppTier definition has changed, you must update the definition for the Add-on AppTier.
...
- Uninstall Add-on AppTier instances
- Remove the Add-on AppTier before performing a new plug-in (updated version) of the Add-on AppTier installation package.
...