instaling ANTA

[simon-mcc]

Hi, this application seems to be very useful. Is there any documentation, or tutorial to help in installing ?

BR

[bornakke]

Hi Simon,

I have recently installed ANTA on our server and have been working on a installation guide ever since. If you got the technical skills needed then you are welcome to be the first to try out the tutorial below.

And write me back if you encounter any problems with the guide.

Best regards Tobias

ANTA Installation

Below follows a tutorial of getting ANTA up and running on your own server. Be aware that while using ANTA is quite easy, installing it onto your own server demands quite some server experience.

Requirement

• PHP, MySql, Python (tested with 2.7)
• Linux server with pdftotext and catdoc
• Exec enabled in PHP

Steps:

• Download the latest version of ANTA from Github and upload into folder on your server

• Create a database with the name anta and a database user also with the name anta and assign all previllgies for your ned database to this user.

• Import or run the anta.sql file on this database creating the necessary table structure.

• Rename application/configs/application.sample.ini to application.ini and edit the file.

  • Fill out the database section. The mysql user has to be the root user and not the newly created ANTA user.
  • Go to http://www.alchemyapi.com/ and registre for a key. Copy that key into the alchemy.api.key.
  • Go to http://www.opencalais.com/ and registre for a key. Copy that key into the opencalais.api.key
  • Save the file.

• Download Zend Framework version 1.11 (ANTA currently doesn't support the newest version, so stick with this one which has been tested to work)

• Unzip the downloaded file and copy the library/Zend folder to your ANTA library folder.

• In your anta root folder create the folder /uploads and make it writable.

• Add the following virtual host: Alias /anta_dev /path/to/anta/public

  <Directory "/path/to/anta/public"> Options Indexes MultiViews FollowSymLinks AllowOverride All Order allow,deny Allow from all </Directory>

• In your browser visit www.yourdomain.xx/anta_dev/install/

You should now be able to log into ANTA with the user dummy / admini

Setting up Python and python libraries (used to analyze the texts):

• Install NLTK following the instructions here: http://nltk.org/install.html
• Install NLTK-data following the instructions here: http://nltk.org/data.html
• Install networkx from terminal using this command: sudo pip install networkx
• Install beautifulsoup4 from terminal using this command: sudo pip install beautifulsoup4

Commong problems: No upload button Try making the folder /public/js writable

Getting an error like this when uploading a pdf: {"status":"ko","action":"upload","token":"oe5gga0imq20g0jl8br7bi67e5","savedTags":{"categories":[],"tags":[]},"error":"bad encoding or file type"} Make sure that you are using a pdf or word document. If yes, then you might be missing pdf2text/pdftotext on your server.

[dentoir]

Hi,

Thank you for the guide. We have done an installation of Anta here at the Digital Methods Initiative in Amsterdam as well. Here are some additional software requirements I have noticed:

• Curl modules for both PHP and Python need to be installed.
• Apache mod_rewrite should be enabled (it usually is by default). On Debian based systems this can be done by issuing: a2enmod rewrite as root.

Some quirks currently remain after my installation, though. I am mentioning them here because they may be installation related and I could use some help fixing them.

The feedback after uploading documents is always 'failed' even though the documents are uploaded and can be properly processed.

When starting or resetting user routines there is a failure message as well, even though, again, the routines do start up. I may have partially tracked this one and will create a specific issue for it.

Clicking on 'new project' does not result in any action. So every user can now seemingly work only on a single project.

Thanks for all the work!

Emile

[bornakke]

Could you post your error messages?

I don't think the 'new project' has been integrated yet. I have at least not been able to find some functioning code. Instead we are simply creating new user acounts for every project which works fine.

[dentoir]

The second error (with the non-existing tables in the routine reset function) dissapeared when I implented your fix in issue #17.

After a reset of the routines for this user, I no longer get any error messages while uploading documents. So I assume it was related.

[bornakke]

Strange, but i'm happy it worked :)

[fjeuland]

Hello there, today is my first try of the installation of ANTA. "installing [ANTA] is more of a challenges" is true.

Saying that, I'm now facing an issue : at the 10th step, I find a white screen, as when I try to log in. I'm using the following address : 127.0.1.1/anta_dev/install/ as well as http://localhost/anta_dev/install/ I'm on ubuntu 10.04 with lamp-server (a virtual server) installed. I've no doubt the first requirement asked is achieved, but I'm not that sure for the 3 others.

Any advice is welcome to reach the log in page...

Best regards

[bornakke]

I expect that white screen in this case means that you got some kind of error, but your php settings is set to not display errors. Try exploring your apache error log and post the results here.

[gentoo9ball]

Sounds like you're stuck at mod_rewrite jieff610.

I have a different problem (this particular error is on the projects page): Notice: Undefined index: projects.list in /var/lib/ANTA-master/application/models/Ui/Boards/IdentityBoard.php on line 32

I get this all over the site. Its almost as if Zend framework is messed up, but I did download 1.11.0 and extract it and placed the library/Zend/* in APP_DIR/../library/Zend/.

I'm unable to start a project or upload files.

[bornakke]

@gentoo9ball I'm not completly sure, but when I read the code my understanding is that the project parts has never been finished - in other words no one can start projects. Instead simply make a new acount whenever you need to make a new analysis. A notice is also not necessarily a problem. I get a lot of notices too and my ANTA is running just fine. You can hide the notices by changing the php error level.

Regarding the upload problem: I experienced the upload file problem as well, but I can't remember how I fixed it right now. I think it were something about giving sufficient writing permisions to the 'uploads' folder or maybe you need to manually create the uploads folder. Try to open Chrome console or Firebug console and post the error that is listed there - this might help my memory on how I fixed the problem.

[fjeuland]

@bornakke Here is my log : [Mon Nov 25 08:28:29 2013] [error] [client 127.0.0.1] PHP Warning: require_once(Zend/Application.php): failed to open stream: No such file or directory in /media/www-dev/private/ANTA-master/public/index.php on line 21 [Mon Nov 25 08:28:29 2013] [error] [client 127.0.0.1] PHP Fatal error: require_once(): Failed opening required 'Zend/Application.php' (include_path='/media/www-dev/private/ANTA-master/library:.:/usr/share/php:/usr/share/pear') in /media/www-dev/private/ANTA-master/public/index.php on line 21 [Mon Nov 25 08:28:29 2013] [error] [client 127.0.0.1] File does not exist: /var/www/favicon.ico [Mon Nov 25 08:28:29 2013] [error] [client 127.0.0.1] File does not exist: /var/www/favicon.ico

[danieleguido]

@jieff610 Maybe it's a silly question, but have you added zend framework to your php include path? Try to add manually to your php.ini include_path directive.

Regarding the more general discussion, the "project" part has not been fully developed because of how current analysis routines works. Sorry if I left that option visible!

[fjeuland]

@danieleguido thanks for your answer. I don't think it was a silly question because I didn't understood what you where referring to (is it a part of the 7th step of the installation ?). Saying that, I opened my php.ini file from /etc/php5/apache2, and then added the following line : include_path = ".:/media/www-dev/private/ANTA-master/library" but I'm at the same point : white screen from http://localhost/anta_dev/install/

[danieleguido]

@jieff610 sorry for this late answer. Could you check your include_path value and php.ini location with php_info()? Mine is include_path = ".:/usr/share/php:/usr/share/php/Zend" so probably you just need to append the /zend directly. Just make sure that your include_path can reach Zend/Application.php.

[marcioyonamine]

hi,

i´ve installed ANTA at own server, but i can´t login. It send me follow message: "login credentials are not valid". I´ve tried to load /anta_dev/install but i have the same issue as jief610: a blank page.

[stephenrigney]

I have a similar problem to @marcioyonamine in the previous post. I've managed to install ANTA but the login screen at /anta_dev/install gives me the error messages uploads is not writeable and, under, "ups...", another message Application error. I tried logging in with username dummy and pasword admini but I get the message login credentials are invalid

I'm so tantalizingly close....

[danieleguido]

Hi, did you check the permission on the uploads folder? The uploads path is specified in the upload folder on your application.ini. Otherwise you can install the main db via the sql file provided https://github.com/medialab/ANTA/blob/master/anta.sql then try again with the /anta_dev/install I am really sorry for the inconvenience!

[stephenrigney]

@danieleguido thanks for the reply. Turns out to be that simple!