1

Building OpenStudio Server for PAT.md

I am confused on these instructions.

https://github.com/NREL/OpenStudio-se...

First, the instructions specifically list different operating systems, and Windows Server 2016 is not among them. Are these instructions also applicable to Windows Server operating systems? If not, could you please direct me to instructions applicable to Windows Server 2016?

Second, what are the "Employ OpenStudio naming convention" mentioned on the second to last line?

Third, are there any additional instructions for setting up the Amazon AWS and connecting the S3 bucket?


Finally, super duper awesome if there are any instructions that don't require use of Amazon AWS? I would like to get openstudio-server working on the Windows server in my office, but I'd settle for working in any capacity at this point.

image description

mldichter's avatar
2.6k
mldichter
asked 2018-11-09 13:26:56 -0500
edit flag offensive 0 remove flag close merge delete

Comments

add a comment see more comments

2 Answers

2

For now The wiki on openstudio-server repo is the best place to look.

David Goldwasser's avatar
20.4k
David Goldwasser
answered 2018-11-09 16:48:51 -0500
edit flag offensive 0 remove flag delete link

Comments

@David Goldwasser Could you please delete this page from the web if these instructions are inferior to the instructions here?

https://github.com/NREL/OpenStudio-se...

mldichter's avatar mldichter (2018-11-09 17:36:51 -0500) edit
add a comment see more comments
2

Creating your own instance of OS-Server is no trivial task (ie, one size does not fit all), but here are some scripts that I use to do local deployments of OS-Server. The scripts are assumed to live in your home directory.

We currently use Docker 17.09.1-ce on Ubuntu 16.04 LTS, so make sure you have that setup correctly and '>Docker info' gives the right architecture and right number of CPUs.

OS-Server uses Docker Swarm to setup and scale the worker nodes. The bash script 'nuke.sh' will setup a Docker Registry and then pull the docker containers (with version given as an input argument,i.e. >nuke.sh 2.7.0) and then push them to the local Registry. Line 42 then scales the number of worker nodes to be 42 but you probably want to change that to the number of worker cores avail on your box.

There is also the docker-compose.yml file that needs to get configured. There are Environment Variables that need to get set to your server configuration. You can either replace them with values in the file or set actual ENV Vars:

  • AWS_MONGO_CORES - ceil(number_of_cpus / 64)
  • AWS_OS_SERVER_NUMBER_OF_WORKERS - number_of_cpus - WEB_CORES - MONGO_CORES - 3
  • AWS_MAX_REQUESTS - round((number_of_cpus + 10) * 1.2)
  • AWS_MAX_POOL - 16 * WEB_CORES
  • AWS_WEB_CORES - ceil(number_of_cpus / 32)

You can also experiment with replacing CPU reservations to limits, depending on the needs of you specific hardware. (https://docs.docker.com/compose/compo...)

Ideally, all you'd have to do is run '>nuke.sh 2.7.0' from your home directory and that script will download version 2.7.0 of the related OS-Server containers, Mongo, Reddis and put them in a local Registry. Then setup the Volumes needed for the containers, create the Swarm and deploy the Stack and scale to the number of workers you select.

Scripts:

nuke.sh:

docker-compose.yml

BrianLBall's avatar
2k
BrianLBall
answered 2018-11-12 10:58:04 -0500
edit flag offensive 0 remove flag delete link

Comments

@BrianLBall Thanks for the input, but the "Creating your own instance of OS-Server is no trivial task" is the problem we're having. The people on this project are HVAC engineers after all, not computer scientists.

mldichter's avatar mldichter (2018-11-13 13:27:50 -0500) edit

@BrianLBall Also, a goal of our project is to release the openstudio measures so other researchers can apply the same process to their own building models. In that respect, we want to make using the measures easy, which is a major disadvantage of AWS for HVAC engineers. @mdahlhausen has alerted me of an alternative to using PAT here. https://github.com/UnmetHours/openstu.... While inferior in some ways openstudio-server, it is far superior in that it looks easier to setup. I'll be trying it out today.

mldichter's avatar mldichter (2018-11-13 13:31:03 -0500) edit
add a comment see more comments