This tutorial helps you to setup Apache Axis2 on Ubuntu and to add it to Eclipse IDE for Java EE Developers.
Step 1:
Download the latest version of Apache Axis2 from this
link.
Step 2:
Open the Terminal (Ctrl + Alt + T) and enter the following command to change the directory.
cd /opt/
Step 3:
Enter the command given below to extract the Axis2 from the ~/Downloads directory. If your downloaded file is in any other directory and replace the last parameter by the actual file path.
sudo unzip ~/Downloads/axis2-1.7.8-bin.zip -d .
Step 4:
Rename the folder name to
axis2.
sudo mv axis2-1.7.8/ axis2/
Step 5:
To deploy web services, you may need to add some files inside this folder. Therefore it is required to change the permission of this directory. Enter the following command to change the permission of axis2 folder.
sudo chmod -R 777 axis2/
Step 6:
Environment variables
AXIS2_HOME and
PATH have to be added to the system. Enter the following command in the terminal to open the
/etc/environment.
sudo gedit /etc/environment
Step 7:
Add the following line at the end of the file.
AXIS2_HOME="/opt/axis2"
Add the
/opt/axis2/bin to the
PATH.
The /etc/environment before the modification.
The /etc/environment after the modification.
Step 8:
Reload the environment variables to the current terminal using this command.
source /etc/environment
Step 9:
Enter the following command to start the Axis2 server.
axis2server.sh
If you are using Java 9 or latest, you may get an error similar to:
"
-Djava.endorsed.dirs=/opt/axis2/lib/endorsed:/usr/lib/jvm/jdk-10.0.2/jre/lib/endorsed:/usr/lib/jvm/jdk-10.0.2/lib/endorsed is not supported. Endorsed standards and standalone APIs
in modular form will be supported via the concept of upgradeable modules.
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit".
To fix this problem, open $AXIS2_HOME/bin/axis2Server.sh script and scroll down to the bottom. At the end of the script, you have a command like this:
java $JAVA_OPTS -classpath "$AXIS2_CLASSPATH" \
-Djava.endorsed.dirs="$AXIS2_HOME/lib/endorsed":"$JAVA_HOME/jre/lib/endorsed":"$JAVA_HOME/lib/endorsed" \
org.apache.axis2.transport.SimpleAxis2Server \
-repo "$AXIS2_HOME"/repository -conf "$AXIS2_HOME"/conf/axis2.xml $*
Replace it with the following command. As you can notice, we simply remove the JVM arguments from the command.
java $JAVA_OPTS -classpath "$AXIS2_CLASSPATH" \
org.apache.axis2.transport.SimpleAxis2Server \
-repo "$AXIS2_HOME"/repository -conf "$AXIS2_HOME"/conf/axis2.xml $*
Save all the changes and start the server again.
Step 10:
Visit to the following URL.
http://localhost:8080/axis2/services/
If you get the Deployed services page, you have successfully setup the Apache Axis2 in your system.
Step 11:
To stop the Axis2, press Ctrl + C in the terminal which is currently running the axis2server.
If you do not have Eclipse IDE for Java EE Developers, follow this
link and install the Eclipse.
Step 1:
Open the Eclipse.
Step 2:
Goto Windows → Preferences in the menu bar and select the
Axis2 Preferences under the
Web Services.
Step 3:
Click on the 'Browse' button and select the Axis2 home directory.
Step 4:
Click ‘Apply’ and ‘OK’
Now you are ready to use Apache Axis2 from Eclipse.
