Follow the instructions below to download WSO2 Identity Server from the WSO2 middleware products stack.
...
1. Open a Web browser and access one of the following URLs:
...
the product from the product web page. You can also download and build the source code.
- In your Web browser, go to http://
...
...
2. Pick the product from the Products menu and click on it to access its product page. For example,
3. You will be navigated to the product page. On the right-hand side of the page, you can find download options.
The following distribution packages are typically available for download:
...
- com/products/identity-server.
- If you are a new user downloading WSO2 products for the first time, register and log in.
- Once you are logged in, click the Binary button in the upper right corner of the page.
The binary distribution contains the Carbon binary files for both MS Windows and Linux operating systems, compressed into a single ZIP file.
...
4. Click on any option to download the relevant distribution package.
...
1. Establish a SSH connection to the Linux machine or log in on the text Linux console.
2. Download the binary distribution installation pack via the wget command. For example,
| Code Block |
|---|
wget http://dist.wso2.org/products/identity-server/4.1.0/wso2is-4.1.0.zip
|
...
You can also download the source and build the Identity Server. The source can be checked out from SVN using the following commands. This project uses Subversion to manage its source code. Instructions on Subversion can be found at http://svnbook.red-bean.com.
The WSO2 Identity Server release 4.1.0 is based on Carbon 4.0.7.
Anonymous/Developer Checkout
A user can download the complete WSO2 Carbon platform, which is recommended if he/she intends to modify the source. The complete source can be checked out anonymously from SVN with the following commands. The Carbon project comes in three sub projects as Orbit, Kernel and Platform. They should be downloaded and built in that particular order.
Orbit:
| Code Block |
|---|
$ svn checkout https://svn.wso2.org/repos/wso2/carbon/orbit/branches/4.0.0 wso2carbon |
Carbon kernel:
| Code Block |
|---|
$ svn checkout https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.0.0 wso2carbon |
Carbon Platform:
| Code Block |
|---|
$ svn checkout https://svn.wso2.org/repos/wso2/carbon/platform/branches/4.0.0 wso2carbon |
The list of commands that can be run are as follows. If you only want to build the Identity Server, you have to always use the option "-Dproduct=is".
| mvn clean install -Dproduct=is | To create the complete release artifacts of WSO2 Identity Server including the binary and source distributions. |
| mvn clean install -Dmaven.test.skip=true -Dproduct=is | To create the complete release artifacts of WSO2 Identity Server including the binary and source distributions, without running any of the unit tests. |
| mvn clean install -Dmaven.test.skip=true -Dproduct=is -o | To create the complete release artifacts of WSO2 Identity Server including the binary and source distributions, without running any of the unit tests, in offline mode. This can be done only if you've already built the source at least once. |
The Carbon core project is the root project of the OSGi platform on which the Java product stack is built. The Carbon components contain all the components not just the Identity Server specific ones. Therefore, you need to build just the set of components required by the Identity Server, using the following command:
| Code Block |
|---|
$ mvn clean install -Dproduct=is |
Execute the following command to commit your changes (SVN will prompt you for password).
| Code Block |
|---|
$ svn commit --username your-username -m "A message" |
Access through a Firewall
If you are behind a corporate firewall which is blocking http access to the Subversion repository, you can try the developer connection:
| Code Block |
|---|
$ svn checkout https://svn.wso2.org/repos/wso2/carbon/platform/trunk carbon |
Access through a Proxy
The Subversion client can be configured to access through a proxy.
1) Specify the proxy to use in the "servers" configuration file in:
- "~/.subversion" directory for Linux/Unix
- "%APPDATA%\Subversion" hidden directory for Windows. (Try "echo %APPDATA%")
2) There are comments in the file explaining what to do. If you don't have this file, get the latest Subversion client and run any command. It will create the configuration directory and template files.
Example : Edit the 'servers' file and add something similar to:
| Code Block |
|---|
[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128 |
...
| hidden | true |
|---|
...
This distribution is recommended for many users.