# Ood splash screen?

**URL:** <https://discourse.openondemand.org/t/ood-splash-screen/77>\
**Category:** Get Help\
**Created:** [November 14, 2018, 9:14pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77 "2018-11-14T21:14:19Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 14, 2018, 9:14pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/1 "2018-11-14T21:14:19Z")

</div>

I have not been abl to locate any documntation that talks about how to set up the opening ood dashboard page or any way to display the motd. Where can these be set?

Thanks.

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 14, 2018, 11:36pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/2 "2018-11-14T23:36:58Z")

</div>

Also, the verion of ood should be on the dashboard screen.

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 3:22pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/3 "2018-11-15T15:22:31Z")

</div>

Is it possible to change what is shown on the Dashboard? a motd? Customized display? Anything?

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [November 15, 2018, 3:27pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/4 "2018-11-15T15:27:56Z")

</div>

Yes, it is possible to customize the dash. At OSC we display a motd. I need to look into how we do it, and I’ll get back to you.

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [November 15, 2018, 4:33pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/5 "2018-11-15T16:33:35Z")

</div>

Two hooks for customizing the dashboard are announcements and motd. Announcements get the classes `alert alert-warning` and appear above the `OOD_DASHBOARD_LOGO` . Announcement files are expected to be found at: `/etc/ood/config/announcement.(md|yml)` or `/etc/ood/config/announcements.d/any_file_name.(md|yml)`. To display a motd file on the dashboard ensure that the file `/etc/ood/config/apps/dashboard/env` exists at minimum with the following content:

```auto
MOTD_PATH="/path/to/your/motd" # this supports any uri including RSS feeds
MOTD_FORMAT="$MOTD_FORMAT_HERE" # markdown, txt, rss

```

More complex behavior is possible and is detailed at: [https://github.com/OSC/ood-dashboard/tree/master/config/examples](https://github.com/OSC/ood-dashboard/tree/master/config/examples) and a more complete `env` file is available here: [https://github.com/OSC/ood-dashboard/blob/master/config/examples/osc/env](https://github.com/OSC/ood-dashboard/blob/master/config/examples/osc/env)

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 4:38pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/6 "2018-11-15T16:38:23Z")

</div>

If changes are made to these files, is it necessary to do the update\_ood\_portal?

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [November 15, 2018, 4:48pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/7 "2018-11-15T16:48:05Z")

</div>

No: `update_ood_portal` does not need to be run.

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 6:07pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/8 "2018-11-15T18:07:42Z")

</div>

We have the motd set and it is not picking it up. We’ve restarted httpd24-httpd, does anything else need a restart?

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [November 15, 2018, 6:20pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/9 "2018-11-15T18:20:44Z")

</div>

You may need to restart your per-user-nginx.

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 6:37pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/10 "2018-11-15T18:37:02Z")

</div>

service nginx16-nginx restart  
nginx: [emerg] listen() to 0.0.0.0:80, backlog 511 failed (98: Address already in use)  
nginx: configuration file /opt/rh/nginx16/root/etc/nginx/nginx.conf test failed

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [November 15, 2018, 6:51pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/11 "2018-11-15T18:51:18Z")

</div>

In general with OOD you don’t need to interact directly with the Nginx installation. As you noted it is trying to listen on port 80 which is being used by Apache. We provide a couple ways to interact with the PUNs.

From the OOD dashboard if development mode is enabled you can just select the option to restart web server which in this context is nginx. For example if you were serving OOD from localhost on port 8080 the URL looks like this: [http://localhost:8080/nginx/stop?redir=/pun/sys/dashboard/](http://localhost:8080/nginx/stop?redir=/pun/sys/dashboard/)

If on the other hand you as a super user need to restart the PUN of a specific user you can use the [`nginx_stage`](https://osc.github.io/ood-documentation/master/infrastructure/nginx-stage/usage.html) command:

`root@localhost: /opt/ood/nginx_stage/sbin/nginx_stage nginx --user=$USER_OF_INTEREST --signal=reload`

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 6:56pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/12 "2018-11-15T18:56:27Z")

</div>

Still does not show with a fresh connection or with a restart of the webserver from the dashboard. I even logged out of the dashboard, closed the web browser application, and then restarted and reconnected. No motd displayed.

---

<div class="post-metadata">

**Author:** ![wew](https://avatars.discourse-cdn.com/v4/letter/w/8edcca/32.png) [@wew](https://discourse.openondemand.org/u/wew)\
**Post date:** [November 15, 2018, 7:02pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/13 "2018-11-15T19:02:48Z")

</div>

Looks like I finally got it with enough wrangling.

---

<div class="post-metadata">

**Author:** ![efranz](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/efranz/32/27_2.png) [@efranz](https://discourse.openondemand.org/u/efranz)\
**Post date:** [November 20, 2018, 7:15pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/14 "2018-11-20T19:15:20Z")

</div>

When doing configuration modifications to the apps, if you don’t see a change you can trigger a restart for your own Per User NGINX web server from the Dashboard by clicking “Help -\> Restart Web Server”.

An alternative approach is to touch APP\_ROOT/tmp/restart.txt for the particular app. That will force restart on the next request. The dashboard’s APP\_ROOT is /var/www/ood/apps/sys/dashboard.

---

<div class="post-metadata">

**Author:** ![efranz](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/efranz/32/27_2.png) [@efranz](https://discourse.openondemand.org/u/efranz)\
**Post date:** [January 9, 2019, 1:58pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/15 "2019-01-09T13:58:58Z")

</div>

@wew we worked a bit trying to add missing documentation, including things that you mention you were trying to do here. Does [https://osc.github.io/ood-documentation/master/customization.html](https://osc.github.io/ood-documentation/master/customization.html) address everything you were trying to do? Are there things you had to figure out that are not covered by this documentation? I apologize this wasn’t available for you when you started working with customizing OnDemand.

---

<div class="post-metadata">

**Author:** ![johnbot1](https://avatars.discourse-cdn.com/v4/letter/j/e9bcb4/32.png) [@johnbot1](https://discourse.openondemand.org/u/johnbot1)\
**Post date:** [January 15, 2019, 11:12pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/16 "2019-01-15T23:12:05Z")

</div>

@efranz [https://osc.github.io/ood-documentation/master/customization.html](https://osc.github.io/ood-documentation/master/customization.html) is quite useful. however, I’m somewhat at a loss as to how customization entries should be added to /etc/ood/config/nginx\_stage.yml. For instance, I’d like to set the dashboard title and logo for all users by adding the following.

```
pun_custom_env:
  ood_dashboard_title: 'hello'
  ood_dashboard_logo: 'https://login2.xxx.xxx.edu/public/logo.png'

```

Is this correct syntax? I see no changes when visiting the site. Perhaps a small example snippet would be helpful?

---

<div class="post-metadata">

**Author:** ![efranz](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/efranz/32/27_2.png) [@efranz](https://discourse.openondemand.org/u/efranz)\
**Post date:** [January 16, 2019, 1:06am UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/17 "2019-01-16T01:06:44Z")

</div>

I knew it I should have called “upcase” on the keys so that if you used a key like `ood_dashboard_title` you would end up with an environment variable named `OOD_DASHBOARD_TITLE` set with the value provided.

Try this:

```auto
pun_custom_env:
  OOD_DASHBOARD_TITLE: 'hello'
  OOD_DASHBOARD_LOGO: 'https://login2.xxx.xxx.edu/public/logo.png'

```

---

<div class="post-metadata">

**Author:** ![johnbot1](https://avatars.discourse-cdn.com/v4/letter/j/e9bcb4/32.png) [@johnbot1](https://discourse.openondemand.org/u/johnbot1)\
**Post date:** [January 17, 2019, 6:21pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/18 "2019-01-17T18:21:20Z")

</div>

@efranz thanks, tried upper with no effect on the dash and I’ve been receiving the following message from the cron jobs.

pun\_custom\_env:  
OOD\_DASHBOARD\_TITLE: ‘hello’  
OOD\_DASHBOARD\_LOGO: ‘[https://login2.xxx.xxx.edu/public/logo.png](https://login2.xxx.xxx.edu/public/logo.png)’ (using correct url)

```
/opt/ood/nginx_stage/sbin/update_nginx_stage ] && /opt/ood/nginx_stage/sbin/update_nginx_stage --quiet

+ /opt/ood/nginx_stage/sbin/nginx_stage nginx_clean
Warning: invalid configuration option "pun_custom_env"
Completed successfully!

```

(lowercase results in same error)

---

<div class="post-metadata">

**Author:** ![rodgers.355](https://sea1.discourse-cdn.com/flex015/user_avatar/discourse.openondemand.org/rodgers.355/32/193_2.png) [@rodgers.355](https://discourse.openondemand.org/u/rodgers.355)\
**Post date:** [January 17, 2019, 6:33pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/19 "2019-01-17T18:33:12Z")

</div>

John,

We should mention that `pun_custom_env` is a feature of [OOD 1.4.x](https://osc.github.io/ood-documentation/develop/release-notes/v1.4-release-notes.html) which was released 8 Jan 2019. If you are running an older installation that would explain why it is complaining about `pun_custom_env` not existing.

For older versions of OOD you will need to need to set `OOD_DASHBOARD_TITLE` and `OOD_DASHBOARD_LOGO` in a file named `/etc/ood/config/apps/dashboard/env`.

---

<div class="post-metadata">

**Author:** ![johnbot1](https://avatars.discourse-cdn.com/v4/letter/j/e9bcb4/32.png) [@johnbot1](https://discourse.openondemand.org/u/johnbot1)\
**Post date:** [January 17, 2019, 6:45pm UTC](https://discourse.openondemand.org/t/ood-splash-screen/77/20 "2019-01-17T18:45:34Z")

</div>

ACK! Thank you! (I’m still running 1.3 but plan to update soon.)

John

[Next page](https://discourse.openondemand.org/t/ood-splash-screen/77.md?page=2)