valence/doc/ui-proxy/apache/README.md
Lin Yang 0ac90c5522 Initial import from external repository
External repo: https://github.com/mganguli/RSC
Commit: 49199a82045f1d6f231eb477de3dbcd59492e9d9

Change-Id: I9eaec387605a39ba5e4c571026cacb1845938231
2016-10-07 08:50:05 +08:00

72 lines
2.1 KiB
Markdown

Apache proxy service to pod-manager API
=======================================
This manual has been verified on Ubuntu 16.04 + Apache (2.4.18-2ubuntu3.1).
##Install
1. Use package manager tool on your distribution to install apache server.
```
sudo apt-get install apache2
```
2. Enable all related modules for Apache server.
```
sudo a2enmod proxy_http proxy ssl headers
```
3. Setup virtual host for proxy to podm.
```
sudo cp podm-proxy.conf /etc/apache2/sites-available
sudo a2ensite podm-proxy
```
4. Add listening port 6000.
Add "Listen 6000" into Apaches port setting file /etc/apache2/ports.conf.
* If need, you can change it to any available port in your server. In this case, please remember to update
"<VirtualHost *:6000>" in /etc/apache2/sites-available/podm-proxy.conf.
5. Update podm address in /etc/apache2/sites-available/podm-proxy.conf.
By default, the podm api is pointed to https://127.0.0.1:8443/. Update it to fit your environment.
6. Restart Apache server.
```
sudo systemctl restart apache2
```
The proxy is available under http://127.0.0.1:6000/redfish/v1.
```
curl http://127.0.0.1:6000/redfish/v1/
{
"@odata.context" : "/redfish/v1/$metadata#ServiceRoot",
"@odata.id" : "/redfish/v1",
"@odata.type" : "#ServiceRoot.1.0.0.ServiceRoot",
"Id" : "ServiceRoot",
"Name" : "Service root",
"RedfishVersion" : "1.0.0",
"UUID" : "3c414ee3-bd28-4e6c-b9e8-fd8008dbd0ce",
"Chassis" : {
"@odata.id" : "/redfish/v1/Chassis"
},
"Services" : {
"@odata.id" : "/redfish/v1/Services"
},
"Systems" : {
"@odata.id" : "/redfish/v1/Systems"
},
"Managers" : {
"@odata.id" : "/redfish/v1/Managers"
},
"EventService" : {
"@odata.id" : "/redfish/v1/EventService"
},
"Nodes" : {
"@odata.id" : "/redfish/v1/Nodes"
},
"EthernetSwitches" : {
"@odata.id" : "/redfish/v1/EthernetSwitches"
},
"Oem" : {
"Intel_RackScale" : {
"@odata.type" : "#Intel.Oem.ServiceRoot",
"ApiVersion" : "1.2.0"
}
},
"Links" : { }
}
```