Install CSEG
CSEG WebService was built to run on an existing Apache Tomcat installation. Since you may want to install Tomcat just to test the product, this article includes the basic installation procedures and some troubleshooting tips to get the web server running. These instructions should not be used to create a secure, professional, efficient or production-ready web server. These instructions are here to give you a quick way to test CSEG.
The steps provided here are tested on Apache Tomcat 9.0.4. Your results may vary.
Prerequisites
Any of the supported Java version is installed on your machine. Refer to General system architecture for details.
Tomcat versions 7, 8, 9, or 10 must be installed on your machine. For details, refer to http://tomcat.apache.org/.
CADP for Java must be installed.
Note
We are migrating CSEG support to open-source as integration. To handle this migration, 8.15.0 release onward, the safenetcloud.war
file will not be bundled with the CADP for Java package. Soon, CSEG support will be available as open-source.
Steps
Apache CXF gives us flexibility to deploy REST based services. The URL link is:
http://<ip address>/safenetcloud/storage/
Copy the
safenetcloud.war
, from theCADP_for_JAVA\lib\cseg
directory to the%CATALINA_HOME%\webapps
directory.Restart the Apache-Tomcat server.
Note
While deploying the
safenetcloud.war
in Tomcat, if folder with same name already exists in the webapps directory then it should be deleted for clean deployment before starting Tomcat.Note
To deploy CSEG WebService on Apache Tomcat version 10.1.x follow the steps below:
Create a folder named
webapps-javaee
in the Apache Tomcat 10 directory.Place the
safenetcloud.war
file in thewebapps-javaee
folder.Run the startup batch file placed in the
bin
directory of Apache 10.
Configure HTTPS Support for Tomcat
CSEG WebServices can be accessed using both http and https protocols. The following steps describes how to configure the HTTPS support.
Create a self-signed KeyStore or keystore attested with Certificate Authority (CA). For self-signed KeyStore using Java, use the following command:
keytool -genkey -alias tomcat -keyalg RSA -keystore <keystore_name>.keystore
Edit the
server.xml
file under the/CATALINA_HOME/conf
directory. Add/uncomment the following changes in the connector port.<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="150" SSLEnabled="true" scheme="https" secure="true" keystoreFile="<keystore_path>" keystorePass="changeit" clientAuth="false" sslProtocol="TLS" />
Where, keystoreFile is the path of keystore file generated in step 1 and keystorePass is the password used during the keystore generation.
Note
The changes in the server.xml file depends on the Tomcat server. The changes suggested in this step are for Tomcat 8 and 9.
Restart the Tomcat server.
Check through browser for
HTTPS: https://< host-name>:<Port>/