JManage FAQ

From jManage

Contents 1 How can I unlock the jManage admin account? 2 How do I start jManage without manually typing in the password? 3 jManage is throwing an error while sending alert email 4 How do I debug jManage code? 5 How do I write a custom jManage alert delivery mechanism?

How can I unlock the jManage admin account?

Edit JMANAGE_HOME/config/jmanage-users.xml, to set status="A" and lockCount="0".

How do I start jManage without manually typing in the password?

There are couple of ways:

a) If you not concerned about security, you can pass the password as the argument to the startup script:

  > startup.sh 123456

b) A secure way to achieve this is to store the password in a file (and make sure this file is only readable by appropriate people). Then you can start jmanage as:

> nohup ./startup.sh < password 2>&1 > ../logs/startup.log &

where "password" is the name of the file containing the admin password.

jManage is throwing an error while sending alert email

If the error looks like:

 SEVERE: Error sending alert email. Error: Could not connect to SMTP host: localhost, port: 25;

You need to point jManage to your SMTP server. To do this, change the following property in jmanage.properties:

email.host=localhost

How do I debug jManage code?

You can set the following environment variable before starting jmanage:

 set DEBUG_OPTIONS=-Xdebug -Xnoagent -Djava.compiler=NONE 
            -Xrunjdwp:transport=dt_socket, server=y, address=8000, suspend=n

You can then connect to jManage via socket at port 8000.

How do I write a custom jManage alert delivery mechanism?

Currently jManage only supports email and console alert mechanisms. However the alert framework allows one to extend the framework and build their own custom delivery mechanisms.

Here are the steps to be taken...

1. Implement org.jmanage.core.alert.AlertDelivery interface to build your custom delivery mechanism.

2. Register the above implementation in JMANAGE_HOME\config\system\alert-config.xml (note that email and console delivery registration for reference).

3. Edit addAlert.jsp to add the new type to the drop down field. Make sure the type string matches exactly with the type string in alert-config.xml. We are going to remove this step in a future release, by reading this information from alert-config.xml.