You will need the Jasper Server zip file sent to you by AgileAssets to begin.
It will create several screens worth of directories similar to this:
Create the specific directory for the Jasper Report Server:
In the example above, ours is jasperreports-server-pro-6.4.2-bin
Enter the Buildomatic Directory by typing cd buildomatic/
This is the where all the install work will be done.
The image above shows the information for several types of databases.
Note: Oracle is the most commonly used database type in this instance. Verify with your IT team if needed. |
In the example above, our file location is usr/local/jasperreports-server-pro-6.4.2 but yours may be different.
Add /buildomatic after your file location because we will be adding this to the Buildomatic directory.
And now you will name your file. In the screenshot in step 5, we named ours default_master.properties. You can name your file anything you would like but you'll need to keep track of the name for future steps.
Use the screenshot in Setup Step 7 for reference.
IF you already have a Tomcat server installed, follow these steps before installation:
Note: If you encounter this error, it may mean that you have a previous instance of the Jasper Server. Type y to continue the installation: |
If not, follow these steps to install:
Do not change the database username.
Note: Keep track of any usernames or passwords you set yourself. |
Once the build is complete, you should see this message:
Note: Total time will vary. |
Copy this jar file to the tomcat lib directory:
A successful copy will look similar to this:
Change the ownership to tomcat tomcat:
Copy it to the webapps directory:
A successful copy will look something like this:
Change the owner of that recursively:
Which should look something like this:
The final two rows above indicate that the process has been successful. Then you can safely start Tomcat.
You can verify a successful installation by logging into the TIBCO Jaspersoft website with the login superuser and the password superuser. Once logged in, you can change this log in info for that site.
Now we’ll edit the file we just created.
Set your system username and the passwords for the database and the system.
Note: Keep track of any usernames or passwords you set yourself. |
The database username must remain jasperserver.
Set the passwords for the database and system.
There are no requirements for how long your password needs to be or what it needs to contain.
The system username will be the database administrator’s username. This is the user who will have the abilities to create schemas and change the database going forward.
In the example above we set our database password to jasperserver and our system username to system and the password has not been filled out.
The program uses a combination of the host, the port, and the service fields to identify the jar file it needs to use to connect to the database.
Once you’ve finished these changes you can save the file. Now you’ve successfully edited the Default Master Properties in the Buildomatic directory.
Copy the jasperserver-pro.war into the Buildomatic directory by typing the last line of the following screenshot:
ams-reporting is an executable jar file that contains an embedded tomcat server. You must decide where to run the ams-reporter service and what port to assign at configuration time.
Create a new folder to copy ams-reporting.jar
mkdir -p /prod/ams |
Copy ams-reporting.jar to the folder created in step 1.
cp ams-reporting.jar /prod/ams |
Run ams-reporter using jar command and arguments. (java -jar /prod/ams/ams-reporting.jar ${options})
java -jar /prod/ams-reporting/ams-reporting.jar -Dspring.datasource.url='$JDBC_URL' -Dspring.datasource.username='$JDBC_USER' -Dspring.datasource.password='$JDBC_PASSWORD' --server.port=8082 -Djasper.external-url='$JASPER_EXT_URL' -Djasper.user-name='$JASPER_USER' -Djasper.password='$JASPER_PASSWORD' & |
Example:
java -jar ams-reporting-7.3.0.0-RELEASE.jar -Dspring.datasource.url='jdbc:oracle:thin:@//DB_SERVER:1521/SERVICE_NAME' -Dspring.datasource.username='FLEET_TXCPA' -Dspring.datasource.password='FLEET_TXCPA' --server.port=8082 --jasper.base-url='http://JASPER_SERVER:8080/jasperserver-pro' --jasper.user-name='superuser' --jasper.password='superuser' |
NOTE
When installing on another server with a different Java subversion, the above command created an "Unknown host specified" error. A differently formatted line worked instead and it is shown below: |
java -jar ams-reporting-7.3.0.0-RELEASE.jar --spring.datasource.url=jdbc:oracle:thin:@//DB_SERVER:1521/SERVICE_NAME --spring.datasource.username=AMS_LA --spring.datasource.password=AMS_LA --server.port=8082 --jasper.base-url=http://JASPER_SERVER:8080/jasperserver-pro --jasper.user-name=superuser --jasper.password=superuser |