Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Liberty Bikes Conference Demo Setup Instructions #181

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Liberty Bikes Conference Demo Setup Instructions #181

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 46 additions & 0 deletions conference_instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Running Liberty Bikes at a Conference

The following information can be used to setup the Liberty Bikes game on a standalone laptop and local wifi router for the purposes of demoing it at a conference.


# Hardware needed:

1. Laptop with Liberty Bikes code
2. Ethernet cable
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is optional right? I assume it's for giving a direct connection between the host laptop and the router?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just personally like having a hardwire vs a wifi connection from a reliability / performance standpoint. It also allows for the wired NIC to be used for the game, and your wireless NIC can also connect to the conference wifi so you can show webpages like openliberty.io, liberty bikes github, etc.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agreed that it's nice to have, but we should still list it as optional, so people don't think it's a requirement to run the demo

3. Wifi Router (ex, Linksys)
4. Up to 4 mobile devices (one for each player)


# Router setup (linksys)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think most people running this at a conf would be able to follow these steps -- it seems like pretty advanced stuff. When I did this at EclipseCon, we didn't have to mess around with network config at all really. We just connected everything up to the wifi network and used hardcoded IP addresses. Maybe instead we can explain how to check the frontend service's logs to determine what IP the endpoint is available at?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will play around next week with a setup similar to yours and see if I can simplify.


1. Configure the router to have an IP address of 192.168.1.1
2. Enable DHCP with starting address of 192.168.1.100
3. Ensure the DHCP can issue at least 5 IP addresses for the 4 players (given that you have 4 designated devices vs users walking up an using their devices) and the local laptop. Typically you can just take the default of 50
4. Configure the name of the router to be OpenLibertyBikes


# Laptop setup (Windows 10)

1. Update Ethernet interface to use a static IP address on your laptop:
1. Control Panel -> Network and Internet -> Network Sharing Center -> Change adapter settings.
1. Right click adapter and select properties. Select Internet Protocol V4 and click the properties button.
1. Set IP address to 192.168.1.100
1. Set subnet mask to 255.255.255.0
1. Set default gateway to 192.168.1.1 or gateway ip of router
1. Set obtain DNS to automatic
1. Click okay and close the window so that the change takes affect.
1. You can do ipconfig in a DOS cmd.exe window to make sure the ip address is set for the IPv4 adapter.
1. If issues, you can do ipconfig /release to release all IP address followed by ipconfig /renew to renew all the IP connections.
1. Plug one end of Ethernet cable into laptop.
1. Plug other end of Ethernet cable into one of the 4 ports of the router (not the internet port!)
1. Start the game in singleparty mode with: ./gradlew start frontend:open -DsingleParty=true
1. When done, stop the game with ./gradlew stop


# Dedicated Device setup (Android)

1. Connect each of the mobile devices to the to the OpenLibertyBikes router
wifi -> OpenLibertyBikes
2. Enter the link to login and play the game into the browser (we've found that Firefox works for older phones, and Safari works on newer ones) on each of the mobile devices: https://192.168.1.100:12000/login
3. Enter name and select play as a guest