Prerequisite:

  • Proper censhare Admin Client version installed

  • Access to the login data of the censhare user

  • SSH access to censhare server

  • SSH access to Service Client machine(if Service Client is external)

How to enable service client autostart?

systemctl enable censhare.serviceclient
CODE

Where can the configuration files be found in service client?

The service client configuration file can be found at:

~/service-client/config/.hosts/localhost/
CODE

How to switch the service mode of image processing in service client?

Go to Admin Client --> Configuration --> Services --> Image --> Configuration --> Service Mode

Here you can switch between different available modes. There are 3 modes available to switch to:

1. Exclusively local(no Service-Client) --> service client will run on local machine only.

2. Local only if no Service-Client is usable --> service client will run on local if external SC machine is unavailable.

3. Exclusively via Service-Client(Recommended for Production Systems) --> service client will only run on external SC machine.


Some Interesting tickets, solutions and hints

Error: 
com.censhare.client.uisupport.application.GenericLoginAction$1.run(GenericLoginAction.java:124) 
Caused by: java.lang.ClassNotFoundException: com.censhare.vfs.AbstractCsVfs 
Solution:
FS driver / kernel module is not available for Linux. For the service client this makes no sense. VFS is interesting in conjunction with InDesign.
To get rid of the error message, it is enough in the hosts.xml the line with the entry "<censhare-vfs ....>" either remove or set the value of "use =" 0.
CODE 
Error:
2015.01.16-17:08:25.787 SEVERE : T043: ClientCLIService: 20150116.170656.481[online-image-s+b]: error by trying to exec renderer command for process: 10.100.133.11[-2615532701560011072].ClientCLIService error during JRMP connection establishment; nested exception is: java.net.SocketTimeoutException: Read timed out
Solution:
One of the connected service client is not available. Please check and maybe restart the service client
CODE 
Error:
java.io.IOException: Cannot run program "/opt/corpus/tools/imagemagick/bin/convert": error=12, Not enough space
Solution:
The error happened because the server was using local service client even when there were two service client connected.
This added much load to java and process forking was blocked.
Switched service mode from "Exclusively local" to "Local only if no Service-Client is usable" and this fixed the problem
CODE 
Error:
PSB files don't generate previews
Solution:
No solution yet. Service client do not support psb files till date. This is a feature request and dev will work on this.
CODE 
Error:
CLIENTCLISERVICE CRITICAL - All of 6-client service instance (s) 
Monitoring shows service-clients unavailable. But status check shows the clients available.
Solution:
This is a bug in service clients which is resolved from version 4.8
CODE 
Error:
failed with exit code 1. timeout reached, process destroyed 
Solution:
This error is thrown by imageMagick
Please check the timeout value of service client. Try running the same command on the same file on a different machine. 
Probably the hardware where service-client is running is too slow. 
It could also be due to slow network connection or utilization of the service client computer by other processes.
CODE 
Error:
java.lang.IllegalStateException: ImageJAI: only RGB or B/W color mode implemented! Please use a different ImageService backend 
Solution:
Please ensure that all ICC profiles from the server directory
app/services/image/ICCProfiles/
are installed in the same service client.
Question:
The preview is still not generated?
Answer:
Please check the naming convention of ICC profile. There shouldn't be a space.
CODE 
Question:
How to change to the correct color space for the creation of Thumbnails and Previews
Answer:
this is defined in the censhareAdmin Client. 
Please goto Configuration/Services/Image/Configuration and look for the settings of "Color Management".  
Before changing anything here please keep in mind you must provide your desired color profiles at first on the service clients in: Users/<user>/censhare/v4/hosts/<system name from hosts.xml>/iccprofiles/  and on the censhare server in: /opt/corpus/.censhare/v4/.hosts/localhost/iccprofiles/  All ServiceClients (also the one on the censhareServer) need to be restarted if additional icc profiles have been added.
CODE 
Error:
2014.10.08-17:21:18.174 INFO : Thread-19: log: Will try again to re-connect in 30 seconds ... 
2014.10.08-17:21:48.174 INFO : Thread-19: log: Sending “ping” to server ... 
2014.10.08-17:21:48.174 WARNING: Thread-19: log: Connection could not be re-established: 
2014.10.08-17:21:48.174 INFO : Thread-19: log: host not set
Hint:
Please check if the default user for service-client is System user using admin client.
Please check if the password of the default-user has expired.
CODE 
Problem:
Service-client was connected to a server but not doing anything, thereby passing the load on to the application server causing it to run slow. Restarting the service-client was enough to solve the problem and get it working. 
Hint:
The problem was reproducible or at least the serviceclient showed the same behaviour on our tests when the host went to sleep.
Please check if the the machine is set to go to sleep.
CODE