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
7

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

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

14
15
# Configuration

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

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

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

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

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

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

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

Misagh Moayyed's avatar
Misagh Moayyed committed
34
35
- 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
36

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

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

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

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

Misagh Moayyed's avatar
Misagh Moayyed committed
48
## External
Misagh Moayyed's avatar
Misagh Moayyed committed
49
Deploy resultant `target/cas.war`  to a servlet container of choice.
Misagh Moayyed's avatar
Misagh Moayyed committed
50