DIY Runestone setup

[Sean Fitzpatrick]

This might technically be a support question but it's mostly for Brad and I'm not sure if he checks -support.

I have a fresh VM (with Ubuntu 22.04) waiting for me to install Runestone on it.

I'm wondering if it would be a useful exercise to do this at one of the drop-in meetings, with Brad present, as a means of testing the current documentation.

I figure that if I can follow the instructions at

https://runestoneserver.readthedocs.io/en/latest/docker/README.html

and get everything working, that's a good sign that the documentation is solid.

(Good documentation = even Sean can do it.)

I should be able to attend drop-in on Friday from about 1:30 pm MST (12:30 PST, 2:30 CST).

[Jones, Bryan]

I know that following the instructions for a production build will fail, but haven't had the bandwidth to debug this yet...

Bryan

--
You received this message because you are subscribed to the Google Groups "PreTeXt development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/1e319eec-e9e8-45ba-8807-d146c06ad5fan%40googlegroups.com.

--

Bryan A. Jones, Ph.D.
Associate Professor
Department of Electrical and Computer Engineering
231 Simrall / PO Box 9571
Mississippi State University
Mississippi State, MS 39762
http://www.ece.msstate.edu/~bjones
bjones AT ece DOT msstate DOT edu
voice 662-325-3149
fax 662-325-2298

Our Master, Jesus Christ, is on his way. He'll show up right on
time, his arrival guaranteed by the Blessed and Undisputed Ruler,
High King, High God.
- 1 Tim. 6:14b-15 (The Message)

[Sean Fitzpatrick]

Interesting. I'm willing to be a volunteer tester on this, if that helps.

I installed Runestone on my laptop in the summer, and managed to get as far as building a PreTeXt book, but I think at the time I might have had to use the development build, and there was a problem with the library database.
I believe the latter issue has been addressed.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/CAHhYbD9vo03M6o762hKhe8rD%3DmKHGkVQ8jO7BLA919AR9vxnBg%40mail.gmail.com.

[Jones, Bryan]

Sean,

I appreciate the offer, and will take you up on it after I at least get the existing procedure working again.

Bryan

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/9b3c9cb6-5886-7dc1-8468-afa1745f43c7%40gmail.com.

[Sean Fitzpatrick]

Ok, sounds good.

This is in my interest as well: I am hoping to have a functioning Runestone server by the Fall.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/CAHhYbD-iqDyoz2z8wWESt-T%2B49ghowdZCEfUgmdJdxOwSjy8VA%40mail.gmail.com.

[Jones, Bryan]

Sean (and anyone else willing to help),

Brad and I got the Runestone server build up and running, plus got unit tests passing again. It should work... :)

Would you mind following the instructions at https://runestoneserver.readthedocs.io/en/latest/docker/README.html? You want the production use case. Any feedback would be much appreciated!

Bryan

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/CAH%2BNcPZfn7KTmJp_t3SmJ3F9TvR%3DxK2i0ES2DWZ5T_B-2oxpCQ%40mail.gmail.com.

[Sean Fitzpatrick]

Bryan: will you be at drop-in tomorrow?
If so, I could work through this with you then. (And prior to that I will be too busy to try it first on my own.)

I will miss the first hour of drop-in because I have to pick up my kids from school (which ends early on Friday) and drop them off at an after-school program.
But I should be there from 2 -3 pm MST (1 - 2 PST, 3 - 4 CST...)

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/CAHhYbD_G5u1WAgwcojE5udd-FkefBH1xqHnB5%3DBdw_bZ4Y5u2g%40mail.gmail.com.

[Jones, Bryan]

Sean,

I'll be there starting at 2:00 PM MST, but have a meeting starting at 2:30 MST.

Bryan

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/243cda41-bde6-fe2e-fe11-5f59aba11605%40gmail.com.

[Brad Miller]

Sean,

I will be there -- I will miss a bit of the first hour as well.  

But, having just gone through this successfully I think we can get you up and running fairly quickly.

Brad

Bradley Miller, PhD

Professor Emeritus Computer Science

Luther College

Founder, Runestone Interactive

Blog: A Reputable Journal

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/CAHhYbD9PLKOp0wq8z1ZcCP-8YC-X7rMFMsEL0ry8y64v34pe_w%40mail.gmail.com.

[Sean Fitzpatrick]

OK. I might be able to make it closer to 1:30 pm (half an hour in).

I'll join as soon as I'm able.

[Sean Fitzpatrick]

I have one follow-up question: 

Looking at the documentation for the docker-compose.yml file, I see that there's a 'restart: always' line.

Do I understand correctly that given the prerequisites:

1. The docker daemon loads on boot (with systemctl I think this is docker.service and containerd.service)

2. Runestone has been started using docker compose up -d

if I need to reboot the server (e.g. for a kernel upgrade), Runestone will restart automatically?

Or is there an extra step?

[Sean Fitzpatrick]

At the moment this is moot: there is still something weird with permissions on my setup.

Despite having done 'sudo systemctl enable docker.service', docker does not start on boot.

This is weird, because I can do 'sudo systemctl start docker' as soon as the system boots, and it runs just fine.

I'm going to see if I can get my VM rebuilt withut using LDAP.

If not, is there any reason why I could not skip using the bootstrap script, and instead install docker from the Ubuntu repositories?

[Jones, Bryan]

Sean,

That should be fine. To do so, simply replace the commands on line 267 of docker_tools.py with something like sudo apt install -y docker.

Bryan

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/e7d62119-72d7-417d-b3b6-7f1e41d6d6c9n%40googlegroups.com.

[Sean Fitzpatrick]

Looks like our problem was a timing issue: docker comes too soon in the systemd boot sequence, so starting the service ran into a dependency error.

Replacing docker.service with a docker.timer that forces a 60 second wait time fixes the problem.

Now I am running into issues with getting the runestone server to start back up again after reboot.

It seems like one of the components didn't shut down correctly (due to "active connections") and this prevented it from restarting.

I'll see what I can figure out.

[Sean Fitzpatrick]

Looks like all is well now. My only remaining problem is that I did a dumb thing and rebuilt my book with a different name, and I don't know how to get rid of the old library entry

[Brad Miller]

Until someone writes a removecourse command for rsmanage, you will need some SQL :-).   We can take care of it during drop-in.

Brad

Bradley Miller, PhD

Professor Emeritus Computer Science

Luther College

Founder, Runestone Interactive

Blog: A Reputable Journal

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/fa9c5bdd-4afa-4162-9585-5c9811d2b0f5n%40googlegroups.com.

[Sean Fitzpatrick]

I knew this day would come.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/9bb99030-6c74-4e3a-ba53-46b71f589ab5%40Spark.