Linux easy setupMarch 04, 2014
To assist those that use a Linux variety (like me) to run WhiteCore, here is an easy installation process.
I have put together a 'base' install that only has the configuration, scripts and info files that are suitable for Linux (and Mac) setups. You can find it at….
Just to make sure, I have re-done the following steps completely and verified that this does work using the weekly package that Fly-Man posted. Note: All these commands are executed for a terminal session.
Setting up the WhiteCore files
The steps are…. Download the base config package above, copy to your choice of directory and extract.
$ cd ~/ $ tar xzf WhiteCore_Linux_Base.tgz
- This will create a 'WhiteCore' directory in you home directory
Download and copy the binary package to the WhiteCore directory just created
$ cd whitcore $ bunzip2 WhiteCore-x86.tar.bz2 $ tar xf WhiteCore-x86.tar
This will create a 'bin' dir containing the binaries
Setting up MySql
The Linux setup assume that you are already running a MySql (or variation) server. Login to your Mysql server and create the 'whitecore' database, the 'whitecore' user with 'whitecorepass' as the password, and grant schema privileges to the whitecore database. Check the mysql_setup.txt file if unsure. (You do not upload any data) Yes.. this is insecure and is intended to run only for local access :)
$ mysql -u root -p … you do have a root password now..
mysql: create user 'whitecore'@'localhost' identified by 'whitecorepass'; mysql: create database whitecoresim; mysql: grant all on whitecore.* to 'whitecore'@'localhost';
then type "quit" or "\q" to exit mysql.
Add the inital database data
If you want to have a fully running setup i.e. 'WhiteCore-on-a-Stick' you will need to import the supplied data into your new whitecore database.
While still in your WhiteCore folder, type the following from the command line:
$ mysql -u whitecore -pwhitecorepass whitecore <whitecore_initial_data.sql
Run WhiteCore in a terminal session using the 'sim_console.sh' script
You should see the startup. If you have not imported any preset data, you will see the default inventory loading and then the interactive configurator will run to setup the first region, user and estate.
At the end of it all you will have the standard Region [root]# prompt.
Once you are satisfied that all is well, you can run WhiteCore as a background process using the linux 'screen' program. The script 'run_standaloneserver.sh' will do this for you. Note: requires screen. If needed
$ sudo apt-get install screen or your distr.'s equivalent.
This setup is standalone, and is locked to the localhost (127.0.0.1) If you need external access, check the ReadMe & Customising text files.