DevelopmentVMHowto

2016-02-18T22:16:51Z

Q.kontinuum: Add more detailed instructions on applying the upgrades file, add info about slash having admin rights

[[Development]] - parent

== Download and Install VM ==
The Slashdev VM can be downloaded from http://vm.soylentnews.org/Slashdev_14.10.ova. This is the latest Slashdev VM and has many enhancements over the original version. It is a VM that is designed to run on VirtualBox. Information and downloads of VirtualBox are available here: https://www.virtualbox.org.

Once you get the VM downloaded and the VirtualBox up and running, you will want to do a '''File:Import Appliance''' in VirtualBox. This will unpack the VM into you environment. Start up the VM and log in with the username and password of slash.

The VM has port forwarding setup to you local system for ssh and http.

<pre>ssh: 8022
http: 1337</pre>

For ssh your connection string should be:

<pre>ssh slash@127.0.0.1 -p 8022</pre>

User slash is in groups sudo and adm, so '''if''' you want to get a root shell you can get it by entering

<pre>sudo bash</pre>

Caution: Normally you won't need a root shell here.

For websites, Apache will use the name localhost instead of 127.0.0.1 so you will need to use:

<pre>http://localhost:1337</pre>

Check if you can access external servers (will be required if you want to install additional packages or directly checkout from github). E.g.
<pre>ping soylentnews.org</pre>
If the domain name cannot be resolved, you might want to shutdown the VM and add a bridged network adapter in network settings.

==Setup the Environment ==
The slash user home directory is in /srv/slashdev/. The slashcode GitHub repository is located in slashcode. This is where you will make changes to the code you want to test. The actual slashcode install is located in slash.

The first thing you should probably do is update the repo to the latest version.

<pre>
cd ~/slashcode
git pull
</pre>

There are a couple of scripts set up in the vm that make deploying and reloading Slashcode easy. The first script is deployslash.sh and the second is reloadslash.sh. These scripts are in the shash user's home directory. The deployslash.sh script will cd into the slashcode directory and install the Slashcode to the appropriate locations and then stop the slash daemon, stop and start Apache, clear the memcache, and finally restart the slash daemon. The reloadslash.sh script does the last steps only and is generally needed when updating templates, vars, and other items within the admin interface of the slash site. Most changes will not take effect right away due to caching. The reload will empty the caches and unload any running Perl scripts from memory.

== MySQL Updates ==
We sometimes need to update the Slashdev environment to work with the new Slashcode. The update files are normally in /srv/slashdev/slashcode/sql/mysql/upgrades. The upgrades file has the latest updates since that last major version of slashcode. The 14.10 version of the VM is fully up-to-date with with the 14.10 release of Slashcode, so no updates to MySQL are currently needed. You will need to add any future DB updates that are listed in the upgrades file to keep the new code working properly.

MySQL is accessed with root as the user and the database slashdev. To access the DB use the command:
<pre>mysql -u root slashdev</pre>

On the mysql prompt, to apply the upgrades file, enter
<pre>mysql> source slashcode/sql/mysql/upgrades</pre>
== Update Slash ==
Now lets update slash to our new code by running:
<pre>deployslash.sh</pre>

== Making Your Own Changes ==
To do simple updates, you would make changes to the files in slashcode and redeploy using the deployslash.sh script.

What if you want to develop code and have it merged into the main repo? In this case you will need to setup your own copy of the repo do do your development work. First if you do not have your own account on GitHub please set one up. Next go to the Slashcode site https://github.com/SoylentNews/slashcode and click on Fork in the upper right. Fork the repo to your user account.

Now on the VM go to slashcode. We will setup your copy of the repo as a remote. Run the commands:

<pre>
git remote add {name} {url-to-your-GitHub-repo}
git fetch {name}
git checkout {name}/master</pre>

Redeploy slash and you are working from your own repo. As you may have noticed the primary work is being done on the master branch. You will not need to worry about the other branches of the code for now.

Once you get code you like, and have it committed to your personal fork, you can do a Pull Request, https://help.github.com/articles/using-pull-requests, that will create a ticket for the SoylentNews/slashcode repo to merge your commits to the master branch. After proper testing by the Dev team and other sanity checks, you code will be merged and eventually put on to the production servers. See [[GitUse]] for more info about using git.

Just a note: I am new to git, so the above directions are what I have been using. If people have a better method for doing this please feel free to update this page with the new information --pauulej72.

[[Category:Development]]

Suggestions

2014-06-17T21:44:35Z

Q.kontinuum:

This is a compilation of Suggestions from various users. Think of it like a "wish list". These differ from feature requests in that they are projects that may require a significant amount of time to implement. A system should be developed for selecting from one, and having the community vote on which to tackle.

Suggestions can currently be added via suggestions@soylentnews.org or by typing "!suggestion [your suggestion here]" in our IRC rooms '''(currently not working)'''. You can also just add them below. You should check the [https://github.com/SoylentNews/slashcode/issues bug tracker on github] for bugs and feature requests, the [[TodoList]], or the respective team page before suggesting something to see if it is already being worked on.

Teams: feel free to draw from this list and move to a todo list if you would like to tackle one (please remove from here if you do).

*SoylentNewsRoundup or SNR (best stories, comments, journals, best of IRC)
*Articles Revisited: (by +5 commenters)
**research, correct, expand
**re-submit to topic "revisited.soylentnews.org"
**example: [[Articles:Watch_the_Watchers_with_Federal_Contracts_Database|Here]]
**Submit story for discussion/publicizing idea
*Add a "settled arguments" section to the wiki (example: the world population is out of control!)
*Create topic/location for SoylentNews updates on main site
*Add markdown support in SoylentNews ex: http://dillinger.io/
*SoylentNews alternate logo S/N (signal/noise) (also SN = Tin atomic symbol)
*Enable Internet Archive auto-crawling
**need to update robots.txt?
*Allow users to mod stories down.
*Allow up-modding of journal entries
*Allow editors to tag stories in the pipeline as a dupe
*Form to submit bugs on SoylentNews like submitting a story (using slash)
**Pre-populate the "story" with prompts for desired info (summary, severity, error message seen, steps to reproduce, etc.)
*Add ability to easily submit journal entries to the stories queue (I suggest instead they could be submitted as an "article" with links to journal and a "summary" of journal content)
*Host our own advertisements
**Keep them in separate areas (sidebars, boxes)
**Keep them (mostly) static
**Keep the off-site javascript requirements for them minimal
*Banner ads that people can use as forum signatures, etc. to spread the word about SoylentNews. See [[Banner ads|this archived forum thread]] for more information.
*Extend validity of mod points (new mod points only awarded once old mod points were used up, but once a user gets mod points he can use them for 3-4 days for topics he cares about instead of just using them up)

SoylentNews - User contributions [en]

DevelopmentVMHowto

Suggestions