Please read these instructions carefully as you do not need to execute every command that is in this page.
Installing the agent to a remote server. For this you need to have computer with some Linux distribution installed. You also need to have either remote (e.g., SSH) or local terminal connection to this machine.
You can find more information about the installation at main page project.And you can view this YouTube video.
Prerequisites for agent
Debian/Ubuntu
sudo apt-get install libxml-parser-perl libpath-class-perl perl-modules screen pure-ftpd rsync sudo e2fsprogs subversion unzip # The next package, the Perl module "Archive Extract", is already bundled # under the package "perl-modules" in some distributions, for example on Debian 7. # If you see "E: Unable to locate package libarchive-extract-perl" it probably means # that you don't need to install it. sudo apt-get install libarchive-extract-perl # On some Debian based distributions you would need to install libarchive-zip-perl: sudo apt-get install libarchive-zip-perl
For 64bit server install ia32-libs in order to run steam
sudo dpkg --add-architecture i386 # ONLY DEBIAN 7 sudo apt-get update sudo apt-get install ia32-libs
Agent Installation
First you need to download the agent with subversion:
svn co svn://svn.code.sf.net/p/hldstart/svn/trunk/agent/ agent cd agent
Create a user for the agent, only if you do not want to use an existing user account for this. The user can be added in most of the linux systems with following command. #####
sudo adduser wanted_username
Start the actual installation, for this you need to have rights to run sudo or you can also run this command as root user.
_ NOTE: Installation can be done also as non-root user (running the command below without sudo), but then you are not able to install the init script and agent will not be able to start when your Linux machine boots. _
(chmod if needed)
sudo bash ./install.sh
_ Follow on screen instructions.
During the installation you should not need to change any other information than your username (username must be a regular user, not root) and encryption key. Rest of the settings should be required only for advanced setups. _
After the installation you can start the agent to the background
cd /etc/init.d sudo ./ogp_agent start
or as a cmdline app
su - <username> cd OGP perl ./ogp_agent.pl --log-stdout
After you confirm that the agent starts up fine, i.e., you should see agent started line, you can stop the agent by pressing ctrl+c. After this you can set the agent to start during the boot:
Startup script
Ubuntu/Debian
Run following command as root:
update-rc.d ogp_agent defaults 30
NOTES
If you get following error when the steam package is being extracted by the agent:
sh: uncompress: command
You can fix the problem by creating a symbolic link from gzip to uncompress as root:
ln -s /bin/gzip /bin/uncompress
NOTE: The location of gzip might vary depending on the distribution so check the location with the following command:
which gzip
PureFTPd Settings
PureDB /etc/pure-ftpd/pureftpd.pdb
BrokenClientsCompatibility yes
NoAnonymous yes
PAMAuthentication no
CreateHomeDir yes
NOTE: To be able to manage the ftp users and firewall settings the agent user should be in the sudoers list, usually '/etc/sudoers'.
Prerequisites for WebUI
Ubuntu
Install the mysql server:
sudo apt-get install mysql-server
Install PHP and required php extensions:
sudo apt-get install php5 php5-gd php5-xmlrpc php5-curl php5-mysql php-pear curl
Install Apache 2:
sudo apt-get install apache2
Or install lighttpd:
sudo apt-get install lighttpd
If you are using Apache 2
sudo /etc/init.d/apache2 restart
... or if you are using lighttpd:
sudo apt-get install php5-cgi sudo lighttpd-enable-mod fastcgi sudo /etc/init.d/lighttpd restart
WebUI Installation
Get WebUI Files:
svn co svn://svn.code.sf.net/p/hldstart/svn/trunk/upload/ upload
Next you need to move the pages to the directory from which your http server finds the pages, e.g.,
mv upload ~/public_html/ogp
After this you can start the installation process by opening the install.php with your web browser.
