Attachments

FAQ/Portal FAQ

1. How do I provide my company's logo for NEXThink Portal or report generated by NEXThink Portal?

Answer: Starting from V4 you can provide your company's logo for report and NEXThink Portal web UI screen.

Steps:

  1. Create your logo with same resolutions as Web Logo and Report Logo

  2. Copy the logos to /var/nexthink/portal/conf
  3. Restart NEXThink Portal: service nxt-tomcat restart

2. How to change NEXThink Portal Nightly computation time? OR Where can I change NEXThink Portal configurations?

1. Portal configuration file is located at: /var/nexthink/portal/conf/portal-general-config.xml. Refer to the defaults file located at: /var/nexthink /portal/conf/portal-general-config.defaults.xml for the available options.

2. For nightly collection time add the following tags (and their parent tags else NEXThink Portal restart will fail) as in portal-general-config.defaults.xml to /var/nexthink/portal/conf/portal-general-config.xml:

      <!--Time at which collection for the previous day takes place-->
      <timeToCollect>1</timeToCollect>
      <!--Time at which collection for the previous day takes place (minutes)-->
      <timeToCollectMinutes>0</timeToCollectMinutes>

3. Restart NEXThink Portal after changing the configurations: service nxt-tomcat restart

3. How to change the Portal GUI language?

See advanced/Portal Locale

4. How to change the TimeZone of NEXThink Portal?

Time Zone of the system running NEXThink Portal can be changed by Web console. You can change it under https://<Webconsole>:99/network/general

You should also change the time zone of portal account in the NEXThink Engine for NEXThink Portal to perform the computation in the correct time zone.

To do this:

  1. nxinfo shell
  2. update login.timezone="europe/zurich" where login.name=portal (Change “Europe/Zurich” to your customer’s timezone)

5. How to reset the admin password?

Answer: Script to reset must be located here: /var/nexthink/portal/database/reset-admin-pw.sh or you can retrieve it here: reset-admin-pw.sh.

How to solve it: Just follow this instruction:

  * cd /var/nexthink/portal/database/ (or upload the file in this directory)
  * ./reset-admin-pw.sh
  * sudo /etc/init.d/nxt-tomcat start

6. How do I increase JVM memory for NEXThink Portal?

Answer: JVM configuration could be set here: /etc/nxt-tomcat.conf To set JVM memory change teh value after -Xmx. Note that the value specified is in MB

Check this file for more info: /etc/nxt-tomcat.conf.sample

Fo eg, to set JVM to 2GB

JAVA_OPTS="-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/nexthink/portal/log -Xmx2048m"

Restart the NEXThink Portal after editing the file.

To verify:

ps aux | grep java (it should have the new value set after -Xmx)

root 17774 2.1 34.5 740200 178240 ? Sl Jun21 286:35 /usr/java/default/bin/java -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/nexthink/portal/log -Xmx2048m -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.util.logging.config.file=/usr/local/tomcat/conf/logging.properties -server -Djava.endorsed.dirs=/usr/local/tomcat/common/endorsed -classpath :/usr/local/tomcat/bin/bootstrap.jar:/usr/local/tomcat/bin/commons-logging-api.jar -Dcatalina.base=/usr/local/tomcat -Dcatalina.home=/usr/local/tomcat -Djava.io.tmpdir=/usr/local/tomcat/temp org.apache.catalina.startup.Bootstrap start

7. How do I set a widget to debug logging mode?

Sometimes to get more information for a widget computation, we might need to set the widget in debug mode. To do this:

1. Set the widget in debug mode:

 cd /var/nexthink/portal/pinfo
 ./pinfo.sh log set -d "Script.com_nexthink_ServiceAvailabilityNGet" (Depending on the widget type, parameter will change, see below for the command to execute)

Widegt Type

Command

Inventory

./pinfo.sh log set -d "Script.com_nexthink_InventoryNGet"

Investigation Time Series

./pinfo.sh log set -d "Script.com_nexthink_InvestigationTimeSeriesNGet"

Issues

./pinfo.sh log set -d "Script.com_nexthink_IssuesNGet"

Service Availability

./pinfo.sh log set -d "Script.com_nexthink_ServiceAvailabilityNGet"

Software Metering

./pinfo.sh log set -d "Script.com_nexthink_SoftwareMeteringNGet"

2. Compute the widget

3. Send the /var/nexthink/portal/log/portal.log to NEXThink support

4. Reset the widget in info mode:

 cd /var/nexthink/portal/pinfo
 ./pinfo.sh log set -i "Script.com_nexthink_ServiceAvailabilityNGet" (Depending on the widget type, parameter will change, see here for the command to execute)

Widegt Type

Command

Inventory

./pinfo.sh log set -i "Script.com_nexthink_InventoryNGet"

Investigation Time Series

./pinfo.sh log set -i "Script.com_nexthink_InvestigationTimeSeriesNGet"

Issues

./pinfo.sh log set -i "Script.com_nexthink_IssuesNGet"

Service Availability

./pinfo.sh log set -i "Script.com_nexthink_ServiceAvailabilityNGet"

Software Metering

./pinfo.sh log set -i "Script.com_nexthink_SoftwareMeteringNGet"

8. How could I import the server certificate to the java keystore?

Unable to send an e-mail due to the following error:

com.nexthink.portal.notification.NotificationException: Send failed: javax.mail.MessagingException: Can't send command to SMTP host;
nested exception is:
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

This means that the SMTP server NEXThink Portal trying to connect does not have a valid certificate from an authorized CA.

You can import the server certificate to the java keystore to fix this. In order to import, you will need to use 'keytool', available on the NEXThink Portal server at:

/usr/java/default/bin/keytool

The documentation for the tool is at: http://download.oracle.com/javase/6/docs/technotes/tools/windows/keytool.html

You could import the certificate using "keytool -importcert", like:

sudo /usr/java/default/bin/keytool -keystore /usr/java/default/jre/lib/security/cacerts -alias <ALIAS> -import -file <PATH/TO/CERTIFICATE>

where as, <ALIAS> shall be replaced with a recognizable name <PATH/TO/CERTIFICATE> full path of certificate. Please check this with mail admin if it is not available to you.

You need to enter the keystore passowrd. Default password is - "changeit"

Restart NEXThink Portal after adding the certificate.

9. How could I configure SMTP from commandline?

You could use the script available at /var/nexthink/portal/rsquery/simpleEmailConfig.py

Help is available: ./simpleEmailConfig.py –help

Sample configuration:

./simpleEmailConfig.py --mail-smtp-host "mail.infomaniak.ch" --mail-smtp-port "25" --mail-user " user@nexthink.com " --mail-password "password" --mail-smtp-auth --mail-smtp-starttls-enable --mail-from " admin@nexthink.com "

Sample configuration test:

./simpleEmailConfig.py --mail-smtp-host "mail.infomaniak.ch" --mail-smtp-port "25" --mail-user " frommen@nexthink.com " --mail-password "password" --mail-smtp-auth --mail-smtp-starttls-enable --mail-from " fromme@nexthink.com " -t " saheer.babu@nexthink.com "

To get the current config:

./simpleEmailConfig.py –g


CategoryPortal CategoryV4