|Changing the SysAid Login URL|
|Changing the SysAid Listening Port|
|Changing the SysAid Session Timeout|
|Reseting the Main Administrator Password|
|Restoring the Derby Database from a Backup|
|Storing Attachments in the File System Instead of the DB|
The SysAid Administrator Guide was written to assist you in making system level changes to SysAid that do not involve the GUI. The changes described below should only be performed by an administrator who is familiar with both the workings of his network and with SysAid.
For your reference, the default installation directory for SysAid is C:\Program Files\SysAidServer\.
Terms in orange are variables that you must replace with the appropriate value.
By default, the SysAid server login URL is taken from the hostname of your local machine. In order to change the SysAid server URL to another (e.g. external) hostname / IP address, please do the following:
If you do not have the above tag, then insert it on the line immediately after <externalLoginClass>.
Note: After changing the SysAid login URL, you must redeploy the SysAid Agent with the new URL.
When you first install SysAid, you choose the listening port for Tomcat. The listening port becomes part of the SysAid URL:
In order to change the port which tomcat listens on, please do the following:
<Connector port="8080" protocol="HTTP/1.1"
(Note that if you chose a different port during SysAid installation, that port number will be shown here instead of 8080.)
If you do not have this line, go to step 8.
If you do have this line, change PortNumber to the new port number you chose in step 4 above.
You must now use the new port number whenever you log in to SysAid.
If you find that you frequently need to log back into SysAid because your session times out, you might want to lengthen the SysAid session timeout. In order to increase the session timeout interval in SysAid, please do the following:
If you choose a timeout interval of greater than 30 minutes, you must also update the timeout interval for the Tomcat web server.
The SysAid login page allows you to reset your password if you've forgotten it. This is true for any password stored in SysAid except for the main administrator password (the main administrator is the administrator you created during SysAid installation). If you forget this password, you must use the SysAid password reset utility as described below. This utility is also useful if you've forgotten the username of the main administrator.
If you have forgotten the main administrator's username or if you need to reset the main administrator's password, please do the following:
Note: On windows Vista, you need to run CMD as an administrator. Go to Start --> All programs --> Accessories --> right click on Command Prompt and select "Run as Administrator".
The script to reset the main administrator password is located at http://webdist.sysaid.com/resetpassword.sh. The script should be run with the following two parameters:
Note: You need to stop Tomcat before running the script. Your terminal environment also needs to support Java commands. If you can run "java -version" from the terminal, then the script should work.
Example: ./resetpassword.sh /var/tomcat/webapps/sysaid Acme
The script will show you the administrator username and the new password (which is "changeit").
There may be times when you need to restore a backup of an earlier version of your database. If you are using an external database, such as MS SQL, MySQL, or Oracle, please consult your DB documentation. If you are using the embedded Derby Database, please follow the instructions below.
In order to restore the Derby database from a backup, please do the following:
Before you begin, please note the Derby Database backup folder. This folder is specified in SysAid under Preferences --> Integration --> Backup.
By default, attachments in SysAid are stored in the database. If you store very large attachments in SysAid, you may find that the database size grows very quickly, and that backups take a long time. For this reason, you may want to store attachments in the file system instead. Please note that if you use this option, you will need to back up the attachments seperately.
In order for SysAid to store attachments in the file system:
From now on, any time you save an attachment in SysAid, it will be saved on the SysAid Server under ..\SysAidServer\root\WEB-INF\attachments\. Please make sure to back up this folder on a regular basis.
SysAid welcomes your questions and suggestions. We can be reached via phone and e-mail:
Toll Free phone center (U.S): 800-686-7047
Tel (U.S): +1 617-231-0124
Fax (U.S): +1 617 507 2559
Tel (Israel): +972 3 533 3675
Fax (Israel): +972 3 761 7205
SysAid community: http://www.sysaid.com/Sysforums/forums/home.page
You can also view our full support page at http://www.sysaid.com/contact_support.htm.