1. I am not getting the graphical installer while installing Webtop, what do I do?
Unless the display variable is set the x-windows session can’t start on your working desktop. The error will be displayed as ‘Error: Failed to open the display.’ Or ‘can't open display, exiting...’
Export the display to your desktop on which you are currently working as below
export DISPLAY=172.22.23.180:0.0
2. I am not getting the GUI for webtop installer or omnibus admin pages, instead a java exception is displayed. What do I do?
Probable reason for this is the remote terminals you are using to connect with your server don’t have display capabilities (e.g.: PuTTY). In that case you will see an exception like
-------------------------------------------------------------------------------------------
Exception in thread "main" java.lang.InternalError: Can't connect to X11 window server using '172.22.23.180:0.0' as the value of the DISPLAY variable.
at sun.awt.X11GraphicsEnvironment.initDisplay(Native Method)
at sun.awt.X11GraphicsEnvironment.
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(Class.java:140)
at java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment raphicsEnvironment.java:62) at com.micromuse.centralconfig.LaunchApplication.for(Unknown Source)
------------------------------------------------------------------------------------------------------
Open a GUI based X-windows terminal (e.g.: Hummingbird, exceed) to connect to the server. Now you should be able to get the GUI.
3. My Webtop server is not starting, what do I do?
Your Webtop installation can encounter with four major issues in general – Environmental variables, Security manager, License server & Port conflicts. The following steps in sequence will help in resolving them.
Solution 1:-The environmental variables for Webtop & Security manager are not set in the current shell. A message like the following will be displayed.
------------------------
NCHOME not set
------------------------
do the following
Check if the environmental variables are set for the working shell
Example: export NCSM_HOME=/opt/rnagaraj/netcool/security
export NCHOME=/opt/rnagaraj/netcool/
export OMNIHOME=/space/rnagaraj/netcool/omnibus
Solution 2:- The Security manager is not running. Here you go.
Start the Security manager first. Check if it is up & running.
$NCSM_HOME/bin/ncsm_server &
Wait for few minutes after Security manager starts, then start NGF
$NCHOME/bin/ngf_server start
Solution 3:-The Webtop server to start up needs licenses. Possibly the license server is down or it may not have sufficient licenses to run the application. Do the following:-
Check webtop.log for any error messages regarding licenses, something like
Webtop.log
-------------------------------------------------------------------------------------------
Mon Nov 28 13:37:21 IST 2005: Error reporting license count. reporting 0
Mon Nov 28 13:38:37 IST 2005: Unable to checkout a RW license
--------------------------------------------------------------------------------------------
Check whether the webtop is pointing to the correct license server in the webtop configuration file.
i.e. Go to $NCHOME/etc/webtop/server.init & lookout for the entry
license.file:27000@
Check if the license server is up & have sufficient webtop licenses.
o Ping the license server with its name or IP address
i.e. ping dewey or ping 172.22.23.14
o If you are using the flex license server check if there are sufficient licenses
i.e. Go to $NCHOME/common/license/bin
o Run the command ./ nc_print_license This will display the available no. of licenses in the license server
Check out for the availability of license types ‘cro_webtop’ (Webtop
connection) & ‘cro_ncw_os_con’ (Object server connection)
If you are using the locally installed license server check the hostname in $NCLICENSE/bin/etc/license.lic file is present & the code is complete as generated & sent to you. Check for the availability of licenses as above.
Solution 4:- There can be some other process running over the same ports defined in the Webtop installation. Check for the availability of ports
i.e. netstat –a (to see all the occupied ports)
netstat –a | grep
If the port specified for webtop is already in use you will find an entry in webtop.log
Webtop.log
--------------------------------------------------------------------------------------------
Fri Nov 04 10:16:32 CST 2005: LifecycleException: null.open: java.net.BindException: The socket name is already in use.:8080
--------------------------------------------------------------------------------------------
Check for the tomcat port (default:8085) in $NCHOME /guifoundation/conf/server.xml & change to some other port if it is occupied
Check for the http port (default:8080) in $NCHOME /guifoundation/conf/server.xml & change to some other port if it is occupied
4. My Security Manager is not starting, what do I do?
Solution 1:-The environmental variables for Security manager are not set in the current shell. Do the following
Check if the environmental variables are set for the working shell
echo $NCSM_HOME
Set NCSM_HOME if it not set or if it is pointing to some invalid location
Example: export NCSM_HOME=/opt/rnagaraj/netcool/security
Solution 2:- There can be some other process running over the same ports defined in the Webtop installation.
Check for the availability of ports
i.e. netstat –a (to see all the occupied ports)
netstat –a | grep
If the port specified for SM is already in use you will find an entry in SM_server.log something like this
SM-server.log
--------------------------------------------------------------------------------------------
Fri Nov 04 10:16:32 CST 2005: LifecycleException: null.open: java.net.BindException: The socket name is already in use.:8097
--------------------------------------------------------------------------------------------
Check for the tomcat port (default:8085) in $NCHOME /guifoundation/conf/server.xml & change to some other port if it is occupied
Check for the http port (default:8080) in $NCHOME /guifoundation/conf/server.xml & change to some other port if it is occupied
Start the Security manager
$NCSM_HOME/bin/ncsm_server &
5. My license server is up & running but my webtop server is not starting, what do I do?
Check whether the webtop is pointing to the correct license server. (Follow Solution 3 of FAQ.3)
Check if the environmental variables are set for the working shell. i.e. the webtop starter is not aware of the paths where Omnibus, License server, Java are installed when you are in a new shell as shown in above example
Example: export NCSM_HOME=/opt/rnagaraj/netcool/security
export NCHOME=/opt/rnagaraj/netcool/
export OMNIHOME=/space/rnagaraj/netcool/omnibus
Check if the Security manager is up & running.
Wait for few minutes after Security manager starts, then start NGF
Follow Solution 4 of FAQ.3 above to resolve port conflicts if any
6. My locally installed license server is not working. What do I do?
The Webtop server to start up needs licenses. Possibly the license server is down or it may not have sufficient licenses to run the application. Do the following:-
Check whether the webtop is pointing to the correct license server in the webtop configuration file.
i.e. Go to $NCHOME/etc/webtop/server.init & lookout for the entry
license.file:27000@
Check whether the licence.lic file exists in $NCLICENSE/bin/etc
Check whether the licenses are valid in the license server for the current date.
Check if the hostname in $NCLICENSE/bin/etc/license.lic file is valid & correct, the code is complete as generated & sent by Micromuse license generation team.
Check if the license server for sufficient licenses.
i.e. Go to $NCHOME/common/license/bin & Run the command ./nc_print_license. This will display all the licenses available & used Check out for the availability of license types ‘cro_webtop’ (Webtop connection) & ‘cro_ncw_os_con’ (Object server connection)
Try with flex license server (if available & has sufficient licenses) for cross verification.
7. My Webtop Server is running but I am not getting the login page. What do I do?
This is possibly a license issue. You may not find immediate errors too. Here webtop is unable to check out the license to start the services.
Check webtop.log file after some delay & look if there any error like this.
Webtop.log
-------------------------------------------------------------------------------------------
Mon Nov 28 13:37:21 IST 2005: Error reporting license count. reporting 0
Mon Nov 28 13:38:37 IST 2005: Error reporting license count. reporting 0
--------------------------------------------------------------------------------------------
Solution: - The license server configured/specified with the webtop installation is not
working or down.
Check the license server for no. of licenses contained. (See FAQ 3 –solution 3)
Bring it up if it is down or point the installation to some other license server.
Restart the NGF
8. My Webtop Server is running but unable to login. What do I do?
The possible reason for this could be the user, you are logging in as is not existing, or not valid. The OS is not running to authenticate if you are a root user. And not the least the user may not be able to check out a license to login to the webtop. We have the following.
If you are trying to login as a non-root user, probably the user with which you are trying to login doesn’t exist in Webtop. Try logging in as root or admin
If you are an admin user (root/admin) or any OS validated user, you will be authenticated at the OS. Hence the OS needs to be up & running by the command
ps –ef | grep nco
You should be able to see something like this if your OS is running
-------------------------------------------------------------------------------------------
rnagaraj 19146 23020 1 Dec 08 pts/5 58:05 /data/webtop/netcool/omnibus//bin/aix4/nco_objserv -name NCOMS
-------------------------------------------------------------------------------------------
Check whether the same Object server is defined in your Webtop installation in
$NCHOME/etc/webtop/datasources/ncwDataSourceDefinitions.xml
Check whether the environmental variable for omnibus is set
i.e. export OMNIHOME=/opt/rnagaraj/Netcool/omnibus
Check the license server for no. of licenses contained. (See FAQ 3 –solution 3)
Start the OS & try logging in to Webtop again
9. My Webtop Server is running but I am not able to get the Webtop pages. It says ‘No Datasource available’. What do I do?
This message will be displayed when the OS configured in your Webtop installation is not accessible to the webtop. There can be two reasons for this:-
(i) The object server configured in your webtop installation exists but is not running
(ii) The Webtop installation is pointing to an invalid or non-existing Object server.
Go with the following
Check if the OS is up & running by the command
ps –ef | grep nco
You should be able to see something like this if your OS is running
-------------------------------------------------------------------------------------------
rnagaraj 19146 23020 1 Dec 08 pts/5 58:05 /data/webtop/netcool/omnibus//bin/aix4/nco_objserv -name NCOMS
Check for the log entry in webtop.log.
------------------------------------------------------------------------------------------
Fri Nov 04 13:10:52 CST 2005: No DataSources currently available. Webtop service unavailable.
(=>OS in not running)
Fri Nov 04 13:08:21 CST 2005: Bringing up datasource WEBTOP
(=>OS in running)
------------------------------------------------------------------------------------------
Check whether the same Object server is defined in
$NCHOME/etc/webtop/datasources/ncwDataSourceDefinitions.xml
Check whether the environmental variable for omnibus is set
i.e. echo $OMNIHOME
This should display the Omnibus installation path. If not displayed set it
i.e. export OMNIHOME=/opt/rnagaraj/netcool/omnibus
Start the OS & try refreshing the Webtop page again
10. My Webtop Server, SM & OS are running but in place of Webtop pages I am getting a error page referring to velocity template. What do I do?
This error occurs when you start the browser immediately after starting the SM & NGF. Webtop requires some time to get in sync with the security manager for the first time. One more probable reason is your Webtop is pointing to an invalid or not existing security manager.
In this case instead of webtop page you could see an error message as
-----------------------------------------------------------------------------------------------
Sorry, there has been a problem responding to your request. Database may be unavailable. Please report this to the server administrator: Error rendering Velocity
template: layouts/ngf-default.vm: Unable to find resource 'layouts/ngf-default.vm'
----------------------------------------------------------------------------------------------
Solution 1:- after starting the SM & NGF Wait for some time & then start the browser.
Solution 2:- if the problem persists check the mach.out log file for the information at $NCHOME/guifoundation/logs/mach.out
Check for the entry in mach.out if your webtop is pointing to an invalid or non
existing security manager you could see an error message as
mach.out
----------------------------------------------------------------------------------------------
GenericAntTask: initializing...
sm_host set to 172.2.^?2.23.40
sm_port set to 8013
sm_proto set to http
Received exception while getting reference to user interface.
Could not log into Security Manager - fix host/port in $NCHOME/etc/sm/server.props or
username/password in your ant.xml file:null
com.micromuse.common.security.SecurityModelException: null
----------------------------------------------------------------------------------------------
See that line 2 has errors here - sm_host name has taken some invalid characters while installation.
Correct the entries in $NCHOME/etc/sm referencing to a wrong IP of sec_mgr
i.e. sm.security.host=172.22.23.40
sm.security.port=8013
Restart both Security manager & webtop, wait for two minutes & then login
11. I am not getting the default views for webtop & admin pages. Instead error message “Error retrieving Portal Page: Profile not found” displayed. What do I do?
This is once again the synchronization issue between webtop & security manager. The ant process initiating the webtop is not able to communicate with the security manager at one hit.
Check for the entry in mach.out for any errors regarding the users. If there any go to FAQ 7.
There is a check which is a workaround rather than a direct troubleshooting for
this. The ant process needs to be manually made to re-execute to get the
configuration inline.
Step 1: Look for $NCHOME/etc/guifoundation/antonce/machant_webtop.xml
$NCHOME/etc/guifoundation/antonce/00_smprovision_init.xml
Step 2: Once the webtop is started these files had got transformed & looks as
machant_webtop.processed &
00_smprovision_init.xml.processed.
Step 3: Rename the files back to .xml form
machant_webtop.xml
00_smprovision_init.xml
Step 4: Wait for a while (webtop server is kept running) till the xml files get
processed again.
12. My WAAPI script is not running. Am not getting any errors. What do I do?
The possible reasons for this are you may not have permissions to run the waapi command ./runwaapi and/or to the waapi XML file you want to execute or you may not have the file permissions to execute the command.
You may get errors like:-
----------------------------------------------------------------------------------------------
‘No XML configuration file was specified!’ Or something like
‘File permission will not support the specified action’
----------------------------------------------------------------------------------------------
Tail your $WAAPI_HOME/waapi.log file, look for the entry something like:-
Webtop.log
----------------------------------------------------------------------------------------------
Thu Dec 29 18:30:47 IST 2005: No XML configuration file was specified!
----------------------------------------------------------------------------------------------
Check for the file permissions in $NCHOME/webtop/waapi/bin & set if there are no execute permissions
- i.e. chmod 777 * or chmod 777
Check for the file permissions for the XMLs you want to run in $NCHOME/webtop/waapi/create or replace
- i.e. chmod 777 * or chmod 777
Check for the correctness of the XML file. Check for the syntax, correct path of
the files defined if any (like .cgi files) or valid ACLs.
Check whether java is properly installed along with the Webtop installation
at $NCHOME/platform/
Set the JAVA_HOME Set NCHOME, WAAPI_HOME
Example: export NCHOME==/opt/webtop/netcool/
export WAAPI_HOME=/opt/webtop/netcool/webtop/waapi
Set JAVA_HOME (if it is not working with just NCHOME, WAAPI_HOME) to the location where Java (JRE) in installed.
Example: export JAVA_HOME=/space/rnagaraj/netcool/webtop/jre/1.4.2
13. My WAAPI script is not running says ‘Java not found’, what do I do?
The WAAPI clients need to connect to the webtop server to execute the desired procedure. To run the script it need to initiate a java process. The above error will be displayed when it is unable to find the java installation. This can be resolved by setting the java environmental variable.
Check whether java is properly installed along with the Webtop installation at $NCHOME/platform/
Unix:-
which java Displays where java is installed. Go to that path
java –version or simply ‘java’ Displays java info
Windows:-
java –version or simply ‘java’ Displays java info
No information will be displayed or message like “There is no java in /usr/bin /etc” will be displayed if there is no java installed.
If not install the desired version of JRE & set the Java paths in your working shell.
Example: export JAVA_HOME=/space/rnagaraj/netcool/webtop/jre/1.4.2
14. I have problems in running WAAPI scripts and I am not finding the waapi.log file, what do I do?
This problem may arise due to the WAAPI command is not finding the entry in the properties file to create the log.
check whether the following line is enabled in WAAPI.init
logfile: %%\log\waapi.log.
Restart the Webtop server
If still the issue still continues to exist manually create the waapi.log file at $NCHOME/ webtop/waapi/log
15. My cgi script won’t run, what do I do?
To run these scripts the Perl needs to be installed within the environment & the path need to set properly. You may get “Failed to execute CGI "/cgi-bin/nco_ping.cgi". Contact your administrator”.
Check the file is executable – check for the file permissions & set them
- i.e. chmod 777 * or chmod 777
Look out for the error in webtop.log like
--------------------------------------------------------------------------------------------
Thu Jan 12 15:29:11 GMT+05:30 2006: Failed to execute CGI "/cgi-bin/nco_ping.cgi". Check that the file exists and is executable.
--------------------------------------------------------------------------------------------
Check Perl location
-Check whether Perl is present by typing in the command line/shell
$which Perl (in Unix) Or check for the installed programs (in windows)
This will display the path of the Perl installed on the machine. If not install Perl
Check for the Perl path specified at the first line of the script. If not valid one change it to the current path.
Check cgi is registered in webtop – if not register.
- Go to CGI Registry, Enter the CGI name, file name & click Register
Check whether the user is in ACL associated with CGI.
– Go to CGI Registry, Check for the CGI script created-> modify -> ACL -> change the ACL to the user group or select * (for all users).
16. The tool created is not getting listed in the AEL menu, what do I do?
Tools are user specific. They are abstracted from the access by other users, the following could be some simple tips to get them on.
Check whether the tool has been added to the intended menu.
Check whether the user is in ACL associated with that tool.
- Go to Tools –> Modify Tool -> ACL -> change the ACL to the user group or select * (for all users).
Check for the correctness of the syntax of the tool & make sure it has been created.
17. The maps created are not getting displayed, what do I do?
Maps are once again secured & available to the one who created. they are abstracted from the access by other users. the following could be some simple tips to get them on.
Check whether the map created is saved in
$NCHOME/ guifoundation/webapps/webtop/
Check for the ACL & Permissions
– Go to Map Editor –>select the map created -> Modify map -> change the ACL to the user group or select * (for all users).
18. The HTML pages I created are not getting displayed when entered in browsers URL, what do I do?
Html pages will be displayed well despite the syntax errors if accessed after a successful login. Some simple tips could help out in resolving the issue if any.
Error on browser
---------------------------------------------------------------------------------------------
The page cannot be found - HTTP 404 - File not found
---------------------------------------------------------------------------------------------
Webtop.log
---------------------------------------------------------------------------------------------
Thu Jan 12 15:46:15 GMT+05:30 2006: Unable to process 'system/filenotfound.html' page
---------------------------------------------------------------------------------------------
Solution:-
Check whether the html file exists in the correct location i.e.
$NCHOME/guifoundation/webapps/webtop
Check whether the file extension is the same you are referring to (.htm & .html are not same)
Check the maps defined with in html (if any) exists.
Check the smart page commands used (if any) are correct
19. While using the firefox browser on windows not able to open two sessions, it is leading to the desktop page bi-passing the login page what do I do?
This happens because firefox can maintain only one session with the web server. So new tab and new windows use any existing sessions similar to Netscape. you can’t open one more browser window in the same machine, except using a different machine for a second session
Solution:-
Use a different windows machine to open a second firefox browser.
Go with any Unix box where you can create separate profiles & hence multiple
sessions can be opened.
One workaround can be thought to open more than one session in windows. Each time you open a new browser clear off the cache, cookies to avoid the caching and then log in as usual.
* * * End of the document
No comments:
Post a Comment