README.md 1.09 KB
Newer Older
Misagh Moayyed's avatar
Misagh Moayyed committed
1
CAS Overlay Template
Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
2
3
============================

Misagh Moayyed's avatar
Misagh Moayyed committed
4
Generic CAS WAR overlay to exercise the latest versions of CAS. This overlay could be freely used as a starting template for local CAS war overlays. The CAS services management overlay is available [here](https://github.com/apereo/cas-services-management-overlay).
Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
5
6

# Versions
Misagh Moayyed's avatar
updated    
Misagh Moayyed committed
7

Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
8
```xml
Misagh Moayyed's avatar
Misagh Moayyed committed
9
<cas.version>5.0.x</cas.version>
Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
10
11
```

Misagh Moayyed's avatar
Misagh Moayyed committed
12
# Requirements
Misagh Moayyed's avatar
Misagh Moayyed committed
13
* JDK 1.8+
Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
14

15
16
# Configuration

Misagh Moayyed's avatar
Misagh Moayyed committed
17
The `etc` directory contains the configuration files and directories that need to be copied to `/etc/cas/config`.
18

Misagh Moayyed's avatar
Misagh Moayyed committed
19
20
21
# Build

```bash
Misagh Moayyed's avatar
Misagh Moayyed committed
22
./build.sh package
Misagh Moayyed's avatar
Misagh Moayyed committed
23
24
```

Misagh Moayyed's avatar
updated    
Misagh Moayyed committed
25
26
27
28
29
30
To update `SNAPSHOT` versions run:

```bash
./build.sh package -U
```

Dmitriy Kopylenko's avatar
Dmitriy Kopylenko committed
31
32
# Deployment

Misagh Moayyed's avatar
Misagh Moayyed committed
33
34
## Embedded Tomcat

Misagh Moayyed's avatar
Misagh Moayyed committed
35
36
- Create a keystore file `thekeystore` under `/etc/cas`. Use the password `changeit` for both the keystore and the key/certificate entries.
- Ensure the keystore is loaded up with keys and certificates of the server.
Misagh Moayyed's avatar
Misagh Moayyed committed
37

Misagh Moayyed's avatar
Misagh Moayyed committed
38
Then, run:
Misagh Moayyed's avatar
Misagh Moayyed committed
39
40

```bash
Misagh Moayyed's avatar
Misagh Moayyed committed
41
./build.sh run
Misagh Moayyed's avatar
Misagh Moayyed committed
42
43
44
```

CAS will be available at:
Misagh Moayyed's avatar
Misagh Moayyed committed
45

Misagh Moayyed's avatar
Misagh Moayyed committed
46
47
* `http://cas.server.name:8080/cas`
* `https://cas.server.name:8443/cas`
Misagh Moayyed's avatar
Misagh Moayyed committed
48

Misagh Moayyed's avatar
Misagh Moayyed committed
49
## External
Misagh Moayyed's avatar
updated    
Misagh Moayyed committed
50

Misagh Moayyed's avatar
Misagh Moayyed committed
51
Deploy resultant `target/cas.war`  to a servlet container of choice.
Misagh Moayyed's avatar
Misagh Moayyed committed
52