Skip to content

Upload Service

Nimisha Gupta edited this page Jun 2, 2017 · 3 revisions

iManage Upload Service

Description

Background upload service for acquisition client is a process which runs as native operating system service and can be used for uploading the records. Once the process is registered as native service: user can acquire records using Acquisition Client, schedule the records to upload in background and can safely quit Acquisition Client and log out from the operating system session. The uploads will continue even after logging out from OS session. Following is the steps for installing the upload process as operating system service Install

  1. Download and unzip attached file upload-daemon.zip.

    1. Check Java Version
    2. Call java -version and make sure that your default java installation is 1.5 or higher If this is not the case make sure that java 1.5 or higher is installed. NOTE: to display system tray java 1.6 is required. For thread dump with locks java 1.6 is required.
  2. Edit bat/setenv.sh or bin/setenv.sh and adapt the environment variable java_exe to point to java executable installed.

  3. Start the upload-service you would like to wrap.
    ( In case of windows user it is run-upload-daemon.bat, in case of unix users it is run-upload-daemon.sh )

  4. Check the process id of your upload-service.

    1. Windows: go to command prompt and type jps -lv. Search for process id of java -cp lib client-jar.jar;lib loci_tools.jar;. com.strandgenomics.imaging.iclient.daemon.UploadDaemonServiceImpl? iuploader.properties

    2. Unix: go to command prompt and type "ps -aux | grep java". Search for process id of "java -cp lib client-jar.jar;lib loci_tools.jar;. com.strandgenomics.imaging.iclient.daemon.UploadDaemonServiceImpl? iuploader.properties"

  5. Goto yajsw/bat and execute genConfig.bat (genConfig.sh for unix users) (give pid as argument to genConfig) NOTE: on posix systems (Linux) this command requires root priviliges to access information on other processes This generates the file yajsw/conf/wrapper.conf which is the configuration file for the upload service

  6. Stop the upload-service (run-upload-daemon.bat/run-upload-daemon.sh from task manager) Windows: go to command prompt and type "taskkill /PID /F" Unix: go to command prompt and type "kill "

  7. Execute your wrapped upload-service by calling runConsole.bat(runConsole.sh)

  8. Check that your upload-service is running Windows: go to command prompt and type "jps -lv". confirm the process is running "java -cp lib client-jar.jar;lib loci_tools.jar;" Unix: go to command prompt and type "ps -aux | grep java". confirm the process is running "java -cp lib client-jar.jar;lib loci_tools.jar;"

  9. Terminate the wrapped service process.

  10. To Install the upload-service as service, call installService.bat(installDaemon.sh). (Administrator rights needed)

    1. To start the service: startService.bat(startDaemon.sh) (Administrator rights needed)
      It will say "com.strandgenomics.imaging.iclient.daemon.UploadDaemonServiceImpl? service started". Also,it will appear in Task Manager > Services tab.
    2. After this the Upload-Deamon for Acquisition client is running. You can use upload/upload in background menu from acquisition client to start uploading in background.
  11. For More Information:

    1. To stop the service:
    2. stopService.bat(stopService.sh)
    3. To uninstall the service:
    4. uninstallService.bat(uninstallService.sh)