IBM Tivoli Netcool/Impact

https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1
Admin
IBM Tivoli Netcool/Impact is an event and alert management platform that provides context-driven...
Tokens:1,226,308
Snippets:8,142
Trust Score:10
Update:15 hours ago
Show doc for...
Tokens:
Raw
### Eseguire lo script install_autostart.sh

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-installing-uninstalling-netcool-impact-auto-start-unixlinux

Comando per avviare l'installazione dell'avvio automatico. Richiede risposte Y ai prompt.

```bash
./install_autostart.sh
```

--------------------------------

### Example: Get Impact version

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command using sample credentials and host to retrieve the Impact version.

```plaintext-ibm
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/version
```

--------------------------------

### Eseguire lo script di installazione di Installation Manager (con accesso a Internet, Windows)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=planning-updating-installation-manager

Comandi per avviare Installation Manager su sistemi Windows quando la macchina ha accesso a Internet. Scegliere il comando in base alla modalità (GUI o console).

```bash
C:\Program Files\IBM\Installation Manager\eclipse\launcher
```

```bash
C:\Program Files\IBM\Installation Manager\eclipse\tools\imcl -c
```

--------------------------------

### HTTP Request Example

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=source-creating-restful-dsa-data

Example of a GET request to the REST API endpoint, including the URL, authorization header, and content type.

```plaintext
GET /api/alerts/v1 HTTP/1.1
Host: ibmnotifybm.mybluemix.net
Authorization: Basic ******************
Content-Type: application/json;charset=UTF-8
Max-Forwards: 10
```

--------------------------------

### Runtime Filter Parameter Examples

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=model-using-getbyfilter-function-handle-large-data-sets

Examples of filter syntax using runtime parameters (count, start, param_*) in GetByFilter calls.

```APIDOC
## Runtime Filter Parameters

### Description
Additional parameters can be appended to the filter string to control dataset size and pagination.

### Parameters
- **count** (integer) - Optional - Limits the number of items returned.
- **start** (integer) - Optional - Specifies the starting index for retrieval.
- **param_*** (string) - Optional - Custom parameters passed to the data provider.
- **id** (integer) - Optional - If used, retrieves a single item by ID; all other filter parameters are ignored.

### Examples

#### Example 1: No condition, limit to 6 items
```plaintext
Filter = "&count=6";
```

#### Example 2: No condition, limit to 3 items starting from index 2
```plaintext
Filter = "&count=3&start=2";
```

#### Example 3: Condition only
```plaintext
Filter = "t_DisplayName ends 'ces'";
```

#### Example 4: Condition with count and custom parameter
```plaintext
Filter = "t_DisplayName contains 'W'&count=6&param_One=paramOne";
```

#### Example 5: Custom parameter only
```plaintext
Filter = "&param_One=paramOne";
```
```

--------------------------------

### Avvio installazione GUI su UNIX: ./install_gui.sh

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=mode-starting-installation

Comando per avviare l'installazione in modalità GUI su sistemi UNIX. Da eseguire nella directory superiore dell'immagine di installazione Netcool/Impact.

```bash
./install_gui.sh
```

--------------------------------

### Cambiare directory a IMPACT_HOME/install/startup

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-installing-uninstalling-netcool-impact-auto-start-unixlinux

Comando per spostarsi nella directory di installazione dello script di avvio automatico.

```bash
IMPACT_HOME/install/startup
```

--------------------------------

### Example: Get field names of a node

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=functions-keys

Example that retrieves all nodes, takes the first node, and logs its field names using Keys.

```plaintext-ibm
MyNodes = GetByFilter("Node", "0=0", false);
MyNode = MyNodes[0];
Fields = Keys(MyNode);
Log(Fields);
```

--------------------------------

### Example: Get data type of a variable

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=functions-classof

Demonstrates how to use ClassOf to get the data type of a variable and log it. The output is 'Parser Log: String'.

```plaintext-ibm
MyString = "This is a string.";
MyType = ClassOf(MyString);
Log(MyType);
```

```plaintext-ibm
Parser Log: String
```

--------------------------------

### Eseguire lo script di installazione di Installation Manager (senza accesso a Internet)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=planning-updating-installation-manager

Comandi per installare Installation Manager dall'immagine di installazione di Netcool/Impact quando la macchina non ha accesso a Internet. Scegliere il comando in base al tipo di utente (root o non-root) e alla modalità (GUI o console).

```bash
install
```

```bash
installc -acceptLicense
```

```bash
userinst
```

```bash
userinstc -acceptLicense
```

--------------------------------

### Example: GET secondary servers list

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command using impactadmin:password and host impacthost:9081 to retrieve the secondary servers list.

```plaintext-ibm
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/secondaryservers
```

--------------------------------

### Eseguire lo script di installazione di Installation Manager (con accesso a Internet, UNIX)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=planning-updating-installation-manager

Comandi per avviare Installation Manager su sistemi UNIX quando la macchina ha accesso a Internet. Scegliere il comando in base al tipo di utente (root o non-root) e alla modalità (GUI o console).

```bash
/opt/IBM/InstallationManager/eclipse/launcher
```

```bash
/opt/IBM/InstallationManager/eclipse/tools/imcl -c
```

```bash
<user_home_dir>/IBM/InstallationManager/eclipse/launcher
```

```bash
<user_home_dir>/IBM/InstallationManager/eclipse/tools/imcl-c
```

--------------------------------

### Example: GET primary server name

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command using impactadmin:password and host impacthost:9081 to retrieve the primary server name.

```plaintext-ibm
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/primaryservername
```

--------------------------------

### Avvio installazione GUI su Windows: install_gui.bat

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=mode-starting-installation

Comando per avviare l'installazione in modalità GUI su sistemi Windows. Da eseguire nella directory superiore dell'immagine di installazione Netcool/Impact.

```batch
install_gui.bat
```

--------------------------------

### IPL example calling functions from UTILS_LIBRARY

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=libraries-calling-functions-in-library

Example of calling functions from a library named UTILS_LIBRARY in IPL. It normalizes a location string, gets customers at the location, and prints customer info to the policy log. The functions are the same as those defined in the previous example.

```plaintext-ibm
// Normalize location string
						
UTILS_LIBRARY.NormalizeString(Location);
						
// Get customers at the specified location
						
UTILS_LIBRARY.GetCustomersByLocation(Location, Customers);
						
// Print customer info to the policy log
						
Log(Customers);
```

--------------------------------

### Avvio installazione console su UNIX: ./install_console.sh

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=mode-starting-installation

Comando per avviare l'installazione in modalità console su sistemi UNIX. Da eseguire nella directory superiore dell'immagine di installazione Netcool/Impact.

```bash
./install_console.sh
```

--------------------------------

### Avvio di Installation Manager su UNIX in modalità GUI

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=uninstalling-netcoolimpact

Comando per avviare Installation Manager su sistemi UNIX in modalità GUI. Da eseguire prima di procedere con la disinstallazione tramite interfaccia grafica.

```bash
$HOME/IBM/InstallationManager/eclipse/launcher
```

--------------------------------

### Example GET request to retrieve XML data

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=item-xml-over-http

Shows how to call GetByFilter with a filter that uses the GET method and a script path with a query parameter. The super type is XML_http_superType and the script is getXMLdoc.pl.

```plaintext-ibm
// Call GetByFilter and pass the name of the super type// and the filter 
stringType = "XML_http_superType";Filter = "Operation = 'GET' AND 
FilePath = 'getXMLdoc.pl?node=NodeXYZ'";CountOnly = False;DocDataItem = 
GetByFilter(Type, Filter, CountOnly);
```

--------------------------------

### Example: Get total JVM memory

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command to retrieve total JVM memory in bytes for the active primary server. The response shows a JSON object with the totalmemory field.

```plaintext
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/NCI/totalmemory
{"totalmemory":2516582400}
```

--------------------------------

### Installazione dei file client Oracle con loadjava

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=server-installing-client-files-into-oracle

Comandi per installare i file client nell'ordine specificato: commons-codec-1.3.jar, oracleclient.jar, nameserver.props e impactdblistener.props. L'ordine è obbligatorio per evitare errori di risoluzione dei riferimenti esterni.

```shell
loadjava -user username/password -resolve dir/commons-codec-1.3.jar
```

```shell
loadjava -user username/password -resolve dir/oracleclient.jar
```

```shell
loadjava -user username/password nameserver.props
```

```shell
loadjava -user username/password impactdblistener.props
```

--------------------------------

### Avvio installazione console su Windows: install_console.bat

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=mode-starting-installation

Comando per avviare l'installazione in modalità console su sistemi Windows. Utilizzare il percorso completo della directory in cui è stata estratta l'immagine di installazione.

```batch
impact_install_image_dir/install_console.bat
```

--------------------------------

### Example: Get current JVM memory usage

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command to retrieve current JVM memory usage in bytes for the primary server. The response shows a JSON object with the totalmemory field.

```plaintext
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/NCI/memoryusage
{"totalmemory":158834984}
```

--------------------------------

### Length function and array indexing examples

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=values-examples-db2-sql-stored-procedures-using-parameters

Shows how to get the number of rows in a result set using Length(NetworkData) and how to access a specific field value using NetworkData[0].IPAddress. These are inline examples from the documentation.

```plaintext-ibm
Length(NetworkData);
```

```plaintext-ibm
NetworkData[0].IPAddress;
```

--------------------------------

### Accedere come root (su - root)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-installing-uninstalling-netcool-impact-auto-start-unixlinux

Comando per accedere come root, necessario per eseguire i passi di installazione.

```bash
su - root
```

--------------------------------

### Aggiungere sezione [Install] al file .service

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-installing-uninstalling-netcool-impact-auto-start-unixlinux

Aggiungere la sezione [Install] con WantedBy=multi-user.target (o default.target commentato) alla fine dei file .service.

```plaintext
[Install]
WantedBy=multi-user.target
#WantedBy=default.target
```

--------------------------------

### Example: Get cluster information

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=servers-accessing-cluster-information-using-rest-api

Example curl command using sample credentials and host to retrieve cluster information. The response shows activeClusterMembers is populated only for the active primary server; it is empty when querying a secondary server.

```plaintext-ibm
curl -u impactadmin:password -k https://impacthost:9081/restui/serverinfo/clustername
```

--------------------------------

### Importa un elenco di voci Server dei nomi (setNameServer.sh -import)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-reconfiguring-name-server

Procedura per importare un elenco di voci Server dei nomi su sistemi UNIX: copiare il file di configurazione, modificarlo e quindi eseguire lo script con l'opzione -import.

```bash
cp $IMPACT_HOME/etc/nameserver.props /tmp/nameserver.props
```

```bash
$IMPACT_HOME/install/nameserver/setNameServer.sh -import /tmp/nameserver.props
```

--------------------------------

### Superior Scheduler Policy Example

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=schedules-writing-top-scheduler-policy

Example policy that retrieves a schedule data item, gets the current task, and activates the associated policy. Uses DataType 'Schedule', Key 'TasksSchedule', and the Tasks data type with a PolicyName field.

```plaintext-ibm
// Call GetByKey and retrieve the schedule data item that contains
// the schedule of tasks

DataType = "Schedule";
Key = "TasksSchedule";
MaxNum = 1;

Schedules = GetByKey(DataType, Key, MaxNum);

// Call GetScheduleMember and retrieve the task that is currently
// "on call"

Tasks = GetScheduleMember(Schedules[0], 0, False, GetDate());

// Call Activate and launch the policy associated with the task

Activate(Null, Tasks[0].PolicyName);
```

--------------------------------

### Comando Java per avviare TestClient

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=server-testing-socket

Comando da digitare dal prompt della riga di comando sul sistema in cui è in esecuzione Tivoli Netcool/Impact per testare un server socket. Sostituire _hostname_ con il nome del sistema del server socket e _port_ con il numero di porta utilizzato dal server.

```bash
java -cp [$Impact_home]/wlp/usr/servers/NCI_A/apps/NCI_A.ear/nci.jar com.micromuse.dsa.socketdsa.TestClient _hostname_ _port_
```

--------------------------------

### JavaCall - Get System Property with Logging (JavaScript)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=functions-javacall

Example of using JavaCall to retrieve a system property and log its value in JavaScript.

```APIDOC
## JavaCall - Get System Property with Logging (JavaScript)

### Description
Calls `java.lang.System.getProperty` to retrieve a system property and logs the result.

### Method
JavaCall

### Signature
`JavaCall("java.lang.System", null, "getProperty", [ "app" ])`

### Parameters
- **className** (string) - Required - `"java.lang.System"`
- **object** (object) - Required - `null` for static method.
- **methodName** (string) - Required - `"getProperty"`
- **args** (array) - Required - `[ "app" ]`

### Return Value
Returns the value of the system property.

### Example (JavaScript)
```plaintext-ibm
propvalue = JavaCall("java.lang.System", null, "getProperty",
[ "app" ] );
Log("Property \"app\" is " + propvalue);
```
```

--------------------------------

### Comando CLI per aggiungere vista operatore

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=page-viewing-operator-view-from-views-menu

Comando java -jar cli.jar -addWebPage per aggiungere una vista operatore al menu Viste. Richiede parametri come -label, -folderid, -device, -consoleRest, -username e -password.

```plaintext-ibm
java -jar cli.jar -addWebPage /opview/displays/<CLUSTERNAME>-<OPERATOR_VIEW_NAME>.html -label "<OPERATOR_VIEW_NAME>" -folderid viewsFolder -device DESKTOP -consoleRest https://localhost:<port>/ibm/console/rest -username "<IMPACT_ADMIN>" -password "<IMPACT_ADMIN_PASSWORD>"
```

--------------------------------

### JavaCall - Get System Property with Logging (IPL)

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=functions-javacall

Example of using JavaCall to retrieve a system property and log its value in IPL.

```APIDOC
## JavaCall - Get System Property with Logging (IPL)

### Description
Calls `java.lang.System.getProperty` to retrieve a system property and logs the result.

### Method
JavaCall

### Signature
`JavaCall("java.lang.System", null, "getProperty", { "app" })`

### Parameters
- **className** (string) - Required - `"java.lang.System"`
- **object** (object) - Required - `null` for static method.
- **methodName** (string) - Required - `"getProperty"`
- **args** (array) - Required - `{ "app" }`

### Return Value
Returns the value of the system property.

### Example (IPL)
```plaintext-ibm
propvalue = JavaCall("java.lang.System", null, "getProperty",
{ "app" } );
log("Property \"app\" is " + propvalue);
```
```

--------------------------------

### Elenco script di riconfigurazione

Source: https://www.ibm.com/docs/it/tivoli-netcoolimpact/7.1.1?topic=steps-changing-host-name-netcoolimpact-installation

Elenco dei percorsi degli script disponibili per riconfigurare host, porta e porta GUI dopo l'installazione.

```plaintext
$IMPACT_HOME/install/tools/nci_changehost
$IMPACT_HOME/install/tools/nci_changeport
$IMPACT_HOME/install/tools/nci_changeguiport
```
Tokens:
Raw