Hardware requirements
- Memory: At least 8 GB recommended
- CPU: Only requirement is it has to be of x86-64 architecture. But should be a modern processor with multiple cores
- DISK: At least 30 GB for base and the rest depends on the volume of your data. The rough estimate is that it will take about 2 GB disk space for every million of archive units. So if there is 2 millions of data then 30 + (2 * 2) = 34 GB should be enough
It is highly recommended to install Elasticsearh on a separate machine. For detail info about Elasticsearh hardware requirements see https://www.elastic.co/guide/en/elasticsearch/guide/current/hardware.html
OS requirements
Microsoft Windows Server 2008 R2 or later or Microsoft Windows 7 or later.
Install Java
If not already installed need to download and install a Java SE Runtime Environment (JRE). Java 8 is neede.
You can download and install Java follwing https://java.com/en/download/help/windows_manual_download.xml
Install Elasticsearch
Elasticsearch can be installed either from a .zip package or using a .msi installer.
- Follow https://www.elastic.co/guide/en/elasticsearch/reference/5.6/zip-windows.html for .zip installation
- Follow https://www.elastic.co/guide/en/elasticsearch/reference/5.6/windows.html for .msi installation (at least .NET 4.5 framework is needed)
- Set the cluster name to astaonline while installing using the .msi installer
It is recommended to install and run elasticsearch as a service.
If you have not used the GUI installer or forgot to set the cluster name correctly, then you need to change the elasticsearch cluster name. For doing that open /path/to/elasticsearch/config/folder/elasticsearch.yml and change the following
Uncomment cluster.name and set it to astaonline
cluster.name: astaonline
For some important system configuration regarding Elasticsearch please follow this https://www.elastic.co/guide/en/elasticsearch/reference/5.6/system-config.html.
Install MongoDB
MongoDB can be installed by following https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/. It is recommended to install and run mongodb as a service.
After installing we need to initiate the mongodb replica set, for doing that
- Open C:\Program Files\MongoDB\Server\4.0\bin\mongod.cfg and add the following
replication: replSetName: rs0
- Restart MongoDB service
- Run the mongo shell C:\Program Files\MongoDB\Server\4.0\bin\mongo.exe
- Invoke the command rs.initiate() in mongo shell
Install ASTA Online
Download the installer from https://drive.google.com/open?id=1it3uKifNe-xAKalb1QPbRDxCsc7EMYEP
- Run the installer then just follow the instructions
Provide the necessary application properties/configurations in the installer. If desired those can be provided later, open the path_to_application_directory\
a
pplication_prod.properties and change to the appropriate values. LikeC:\Program Files\AstaOnline\application-prod.propertiesasta.origin=http://localhost:8080 oracle.host=localhost oracle.port=1521 oracle.sid=xe oracle.username= oracle.password= es.host=localhost mongo.host=localhost
- The installer has option to export data to elasticsearch. At the last page just tick the checkbox if that is desired. Otherwise it can be done later as shown in Export to Elasticsearch section.
The installer will install Asta Online application and Asta Online Syncing application as services. After finishing the installation start those services from Windows Services.
Open http://your_server_host:9090 in the browser to start using ASTA Online.
Export to Elasticsearch
Although not necessary but it is recommended to stop the Asta Online Syncing Application service while doing this. Then invoke
- path_to_application_directory\aoexport.bat
After the export is finished start the Asta Online Syncing Application service again if you have stopped it.
Depending on the amount of data this process may take several hours to complete. It may also hamper the performance of ASTA Online as well as ASTA Engine/Client.
Alias of Elasticsearch
If you have not restarted aosync service after export necessary elasticsearch aliases are not created. In order to create them invoke
- path_to_application_directory\aoesalias.bat