Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Table of Contents

Requirements

The following requirements has to be met

Hardware requirements

  • Memory: At least 8 GB recommended

  • CPU: 

    Only requirement is it has to be of x86-64 architecture. But should be

    Should be a modern processor with multiple cores

  • DISK: At least 30 GB for the base and the rest depends on the volume of your data. The rough estimate is that it will take about 2 GB of 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

Note

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

...

  • and later

...

  • Microsoft Windows 7

...

  • and later

...

Install Java

If not already installed need to download and install a Java SE Runtime Environment (JRE). Java 8 is neede. 

...

Asta requirements

At least Asta v5.4.3 is required.

Installing/Upgrading/Uninstalling

Download the installer from https://asta-online.s3.eu-north-1.amazonaws.com/installer_win

Install Elasticsearch

Elasticsearch v7.10 can be installed either from a .zip package or using a .msi installer. 

...

by following https://www.elastic.co/guide/en/elasticsearch/reference/

...

7.

...

10/

...

windows.html

...

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

Now we need to change the elasticsearch cluster name. For doing that open open /path/to/elasticsearch/config/folder/elasticsearch.yml and change the following

Uncomment cluster.name and set it to astaonline

Code Block
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
Code Block
languagetext
titleC:\Program Files\MongoDB\Server\4.0\bin\mongod.cfg
replication:     
	replSetName: rs0

...

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\

...

application.properties, and change to the appropriate values. Like

Code Block

...

titleC:\Program Files\AstaOnline\application-prod.properties
asta.origin=http://localhost:

...

8088
asta.institute.id=asta
asta.service.requisition.enabled=true
oracle.host=localhost
oracle.port=1521
oracle.

...

service=xe
oracle.username=nyeasta
oracle.password=nyeasta
oracle.logMiner.service=xe
oracle.logMiner.username=aominer
oracle.logMiner.password=aominer
es.host=localhost

...


server.ssl.enabled=false
server.ssl.key-store-type=JKS
server.ssl.key-store=path/to/key/file
server.ssl.key-store-password=
server.ssl.key-alias=

The installer will install Asta the ASTA Online application and Asta Online Syncing application as servicesas a service. After finishing the installation start those the services from Windows Services. 

Open httpOpen 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.

Note

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.

In Case of Externalized Elasticsearch/MongoDB

If the elasticsearch/mongodb is not in localhost we need to update the application properties file accordingly.

Add the following entries in path_to_application_directory\application_prod.properties

...

titleC:\Program Files\AstaOnline\application-prod.properties

...

Upgrade ASTA Online

Same as installing.

Uninstall ASTA Online

The application can be uninstalled from the control panel like any other windows application.

Running

Necessary Ports

  • 9090 for accessing AstaOnline (can be changed by server.port property)