Install censhare Service Client on Windows, macOS and headless on Linux. 

Prerequisites

  • censhare Service Client. We recommend a Service client on Linux.

  • create censhare user, e.g.: service-client (as "System user")

  • latest java version

  • latest ImageService tools installed

Supported platforms:

  • latest release of RHEL, SLES, macOS and Windows

Install on Windows

  1. Unzip censhare Service-Client.
  2. Start censhare Service-Client.exe and if required enter your hostname and host URL and click OK.
  3. Enter User, Password, activate Log on automatically and log on.
  4. Set up the correct path to your ImageService tools by editing File|Preferences|General on the censhare Service Client.

Install on macOS 

  1. Open censhare Service-Client, drag & drop censhare Service-Client.app  to /Applications/  and execute it. If required, enter your hostname and host URL and click OK.
  2. Enter User, Password, and click Log on automatically  and log in.
  3. Set up the path to your ImageService tools by editing File|Preferences|General  on the censhare Service Client.

Install on Linux

  1. Copy censhareService-Client to corpus_user@application_host.

Important! If you use a Service Client with multiple network interfaces, you need to adjust the serviceclient.sh start script:

vi /opt/corpus/service-client/serviceclient.sh

under:

 # Set JVM properties 


JAVA_PROPERTIES="$JAVA_PROPERTIES -Djava.rmi.server.hostname=
            <IP address of service client host
            >
          "
XML


Replace <IP address of service client host> with either the IP or the hostname of you service client (the one the app server should connect to).

  • Install censhare Service-Client

    { # as corpus_user@application_host tar=tar; test $(uname) = SunOS && 
{ x=$(type -p gtar) && tar=$x }; cd csc=$(\ls -1tr censhare-Service-Client-v[45]*tar.gz | tail -1); test -z "$csc" && 
{ echo "nothing found to unpack..." } || 
{ echo "installing $csc" } $tar -xzf ~/$csc mv $csc ~/censhare/ ln -s ~/censhare/censhare-Service-Client ~/service-client echo "running setup"; echo ./service-client/serviceclient.sh setup 
}
    XML

     

  • Follow the setup.

  • Set up service client configurations:

    Setup serviceclient configurations
=== Service-Client auto setup 1.0.5 ===
** uppercase values in [ ] are default and set when you hit enter **
= init =
$ User for autologin: service-client
$ Password for autologin: supersecurepassword
$ Url in hosts.xml [rmi://localhost/corpus.RMIServer]:
$ Name in hosts.xml [localhost]:
censhare.preferences.dir=null
user.home=/opt/corpus
user.dir (working directory)=/opt/corpus/censhare-Server-v5.1.2-b130/censhare-Service-Client
Using preferences folder: /opt/corpus/.censhare/v4
= hosts.xml =
Using hosts.xml: /opt/corpus/.censhare/v4/hosts.xml
OK host and url allready in hosts.xml: localhost
= autologin =
writing service-client.autologin
Reading auto login information from file: /opt/corpus/.censhare/v4/service-client.autologin
check, read service-client.autologin
Reading auto login information from file: /opt/corpus/.censhare/v4/service-client.autologin
OK auto-login
= copy icc-profiles =
OK icc-profiles copied to /opt/corpus/.censhare/v4/.hosts/localhost/iccprofiles
= edit user-preferences =
server is online
loading preferences from server
loaded user-preferences from server
$ Instance count [4]:
checking facilities
** uppercase values in [ ] are default and set when you hit enter **
$ imagemagick enable? [Yn]:
-enabling-
$ exiftool enable? [Yn]:
-enabling-
$ ghostscript enable? [Yn]:
-enabling-
$ helios enable? [yN]:
-disabling-
$ xinet enable? [yN]:
-disabling-
$ wkhtmltoimage enable? [Yn]:
-enabling-
$ video enable? [yN]:
-disabling-
$ office enable? [yN]:
-disabling-
$ pngquant enable? [yN]:
-disabling-
$ mathml enable? [yN]:
-disabling-
$ ffmpeg enable? [yN]:
-disabling-

writing prefs to disk
OK writing user-preferences done (file:///opt/corpus/.censhare/v4/.hosts/localhost/ for user service-client)
DONE with setup, have a nice day.
    XML

  • Start the Service Client:

    { # as corpus_user@application_host
 ~/service-client/serviceclient.sh start
}
    XML
  • Enable Service Client

  • Start Service Client automatically after a server restart:

    rccss enable css_serviceclient
    XML

  • Check log file for censhare Service Client >=5.5:

    { # as corpus_user@application_host
less ~/service-client/logs/service-client-0.0.log
}
    XML

  • If everything is ok, the log should look like this:

    Logging started at 2015.06.18-15:46:55.565:
2015.06.18-15:46:55.565 INFO : LoginAction: log: Application started: SERVICE_CLIENT, version: 5.1.3, build date: 09.06.2015
2015.06.18-15:46:55.618 INFO : LoginAction: log: Register service "ClientCLIService", 4 instances
2015.06.18-15:46:55.618 INFO : LoginAction: log: Facilities: [imagemagick, exiftool, ghostscript, wkhtmltoimage]
2015.06.18-15:46:55.852 INFO : LoginAction: log: Registering ICC-Profile: ISOcoated_v2_300_eci.icc
2015.06.18-15:46:55.853 INFO : LoginAction: log: Registering ICC-Profile: sRGB_Color_Space_Profile.icm
2015.06.18-15:46:55.853 INFO : LoginAction: log: Registering ICC-Profile: eciRGB_v2.icc
2015.06.18-15:46:55.854 INFO : LoginAction: log: Registering ICC-Profile: ISOcoated_v2_300_eci-grau.icc
2015.06.18-15:46:55.855 INFO : LoginAction: log: Registering ICC-Profile: PSRgravureLWC.icc
2015.06.18-15:46:55.856 INFO : LoginAction: log: Registering ICC-Profile: EuropeISOCoatedFOGRA27.icc
2015.06.18-15:46:55.856 INFO : LoginAction: log: Registering ICC-Profile: ISOcoated.icc
2015.06.18-15:46:55.857 INFO : LoginAction: log: Registering ICC-Profile: ECI-RGB-V1-0.icc
2015.06.18-15:46:55.858 INFO : LoginAction: log: Registering ICC-Profile: AdobeRGB1998.icc
2015.06.18-15:46:55.859 INFO : LoginAction: log: Registering ICC-Profile: GenericGrayProfile.icc
2015.06.18-15:46:55.860 INFO : LoginAction: log: Registering ICC-Profile: AppleRGB.icc
    CODE