This chapter includes information for preliminary system troubleshooting and disaster recovery. You should perform these activities before contacting Oracle Support for assistance. The following information is included:
The DIVAdirector installer will install two additional Windows services and the DIVAdirector web application. You can configure both of these services in the Windows Services console or using the command line with the options listed as follows:
servicename.exe {option}
Note:
Theservicename.exe in the previous syntax represents the name of the service you are working on.installThis option installs the service.
uninstallThis option uninstalls the service.
startThis option starts the service if it is not already running.
stopThis option stops the running service.
The Task Manager service is responsible for handling any long running background tasks needed by DIVAdirector. The binaries for this service are installed in the TaskManager subdirectory, located under the DIVAdirector installation directory (for example, C:\Program Files (x86)\DIVAdirector 5\TaskManager). This service is visible in the Windows Services console under the name Oracle.DIVAdirector.TaskManager.
The DIVAdirector API service is a web service responsible for handling authentication, authorization, and file upload requests for the Local Archive process. This service currently only handles a subset of the application's responsibilities.
The binaries for this service are installed in the Api subdirectory located under the DIVAdirector installation directory (for example, C:\Program Files (x86)\DIVAdirector 5\Api). This service is visible in the Windows Services console under the name Oracle.DIVAdirector.Api.
You can start and stop the DIVAdirector Web Server manually if issues arise pertaining to the web-based user interface using the following procedure:
Open the Internet Services Manager (inetmgr).
Click the computer's computer name and then locate DIVAdirector 5 under the Sites menu.
In the Actions panel (on the right side of the screen), under the Manage Web Site section, click Start to start the web server, Restart to stop a running server and then start the web server again, or Stop to stop it completely.
A menu item that is grayed out and not selectable indicates the current state of the web server. For example, if the Start menu item is grayed out, the web server is currently running.
DIVAdirector creates log files for both the system and for Drop Folders during normal operations. You configured the log file names, sizes and locations in the initial DIVAdirector configuration. See Logging Configuration if you need a reminder of the file names and locations you assigned to the logs.
The DIVAdirector server logs contain information regarding the various server operations and possible operation processing error information. The Drop Folder logs contain information specific to the Drop Folders.
You can find the web server logs in the DIVADirector_HOME\www\logs\log.txt file. The web server logs are used for troubleshooting the system and may be requested by Oracle Support when you request assistance.
You may need to change the levels you set during initial system configuration to assist in troubleshooting activities. During troubleshooting it may be necessary to raise the logging level higher to assist in locating the source of an error or fault. The recommended log file level settings for normal system operation are as follows:
For DIVAdirector server logs set the log level no higher than Level 2 unless you are trying to locate an error or instructed to do so by Oracle Support.
For Drop Folder logs set the log level no higher than Level 0 unless you are trying to locate an error or instructed to do so by Oracle Support.
The manual backup and restore of the database are very important operations in any data system. DIVAdirector provides you a simple way to perform these operations when necessary.
Use the following procedure to perform a manual backup of the DIVAdirector database:
Navigate to the Admin, Backup, Manual Backup and Restore screen.
Click the option for Backup on the Manual Backup and Restore screen next to Operation.Browse the directory and select the backup destination folder.
Note:
The backup file nameDIVAdirector_database_timestamp.sql is predefined and cannot be modified.The time stamp format is DDMMYY-hhmm, where:
DD = day of month
MM = month
YY = year
hh = hour
mm = minute
Click Backup Now on the top right side of the screen to begin the backup operation.
A message will appear at the bottom of the screen stating that the backup process has started and normally takes approximately 3-5 minutes to complete (depending on the amount of data in the database). The message is displayed in red text at the bottom of the Manual Backup and Restore screen.
Caution:
A manual backup of the database should be completed first before performing a database restore operation.Use the following procedure to manually restore the DIVAdirector database:
Click the option for Restore on the Manual Backup and Restore screen next to Operation.
Browse the From area to display the server's remote file system tree.
Select the database snapshot file to be restored (click once on the file name).
Browse the To area and select a restore destination folder, or select Restore to Active Database (logs off all connected users).
If you select the Restore to Active Database (logs off all connected users) option, the restore process will replace the existing database with the restored database. A confirmation dialog box is displayed notifying you that all connected users will be logged off.
If you have not selected the Restore to Active Database (logs off all connected users) option, click Restore Now to begin the restore process.