Contents
- How do I provide my company's logo for NEXThink Portal or report generated by NEXThink Portal?
- How to change NEXThink Portal Nightly computation time? OR Where can I change NEXThink Portal configurations?
- How to change the Portal GUI language?
- How to change the TimeZone of NEXThink Portal?
- How to reset the admin password?
- How do I increase JVM memory for NEXThink Portal?
- How do I set a widget to debug logging mode?
- How could I import the server certificate to the java keystore?
- How could I configure SMTP from commandline?
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:
Create your logo with same resolutions as Web Logo and Report Logo
- Copy the logos to /var/nexthink/portal/conf
- 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?
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:
- nxinfo shell
- 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
