Brandon Ruffridge
Brent Gardner
This web application allows inventories of assets to be managed. Assets along with their specifications are added to the system and then used by users via a check-in/check-out function. The inventory can be browsed by category or using search. Users are given various roles within the system to allow them to perform certain functions such as view-only, check-in/check-out, modify, and full-control. Inventory managers can add and track detailed information on all inventory assets including manufacturer, storage location, custom attributes, and relationships with other assets. Assets can be found by browsing by category, search, location, or current user. Assets are checked out to specified locations by users.
One of our labs at the NASA Glenn Research Center wanted a way to track their inventory of over 350 pieces of equipment, who is using it, and where it is located. They also wanted to give lab users a way to see what equipment is available and see detailed specs on the equipment and check it out for use with their projects. This web based tool was developed to meet that objective.
Developed using web standards and best practices such as Model-View-Controller architecture, Separation of Concerns, and Don't Repeat Yourself.
Fast, intuitive UI featuring a custom application layout built using parts from Twitter Bootstrap, extensive AJAX and jQuery, and combined and minified Javascript and LESS CSS.
Secure and 508 compliant.
Features an innovative built-in bug reporting system to Pivotal Tracker.
Deployed on the mature, open-source Linux, Apache, MySQL, and PHP (LAMP) technology stack.
git clone https://github.com/nasa/isle.git
vagrant up
Search source code for
config-todo:for things you may need to configure.
Check out our backlog of the things we want to add/fix. Fork the project, make your changes, test ( we don't have time to test for you ), then submit a pull request. Submit any new bugs or feature requests to the issues page.
ISLE supports multiple "instances" so multiple inventories can be managed separately. Each instance has a unique url, but accesses the same php files and database. Data is kept separate by using different tables.
The
instancesfolder contains two example instances
myinstanceand
myinstance2.
To create additional instances duplicate the
instances/myinstancefolder and rename to whatever you want to call your instance. Delete the .log files in
logs. Then replace
myinstancewith whatever instance name you chose in all files within the duplicated folder. Also rename
isle.local.myinstance.confto
isle.local.INSERT_YOUR_INSTANCE_NAME.conf.
webroot/myinstance. Delete any files in
uploadsexcept the .htaccess files.
isle-init.shand copy and paste the following lines for running sql and enabling conf files. Replace
myinstancewith whatever instance name you chose.
mysql -uroot -p'root' -h localhost isle_dev < "/var/www/instances/myinstance/init.sql" mysql -uroot -p'root' -h localhost isle_dev < "/var/www/instances/myinstance/data.sql"cp /var/www/instances/myinstance/isle.local.myinstance.conf /etc/apache2/sites-available/isle.local.myinstance.conf a2ensite isle.local.myinstance
cat <> /etc/logrotate.d/isle-myinstance /var/www/instances/myinstance/logs/*.log { yearly maxsize 2M rotate 5 notifempty missingok su vagrant vagrant } EOT
Then run the following so the changes take effect.
vagrant destroy vagrant up
When you want to make changes to CSS or JS the files you want to edit are located in:
JS:
webroot/isle/cdn/scripts-dev
webroot/isle/cdn/styles/less
Don't edit files in
scriptsor
css-devas those are created during the build process.
Build CSS and JS (combines and minifies) * Make sure you have lessc installed. *
cd PROJECT_FOLDER/webroot/isle/includes(this step is important or the build files will not be saved to the correct location) *
./build.sh
Change Workflow:
* Make changes.
*
./dbup.sh(option 1) * git add, git commit, git push.
Update Workflow:
* git pull
*
./dbup.sh(option 2)
vagrant up
vagrant suspend
vagrant destroy
vagrant ssh
Although not necessary, if you want to check for updates, just type:
vagrant box outdated
It will tell you if you are running the latest version or not, of the box. If it says you aren't, simply run:
vagrant box update
If you're like me, you prefer to develop at a domain name versus an IP address. If you want to get rid of the some-what ugly IP address, just add a record like the following example to your computer's host file.
192.168.33.10 isle.local
Or if you want "www" to work as well, do:
192.168.33.10 isle.local www.isle.local
Technically you could also use a Vagrant Plugin like Vagrant Hostmanager to automatically update your host file when you run Vagrant Up. However, the purpose of Scotch Box is to have as little dependencies as possible so that it's always working when you run "vagrant up".