Modules!
- biis : BIIS interface where user information and reference data is pulled from the BIIS interface into the BizFlow and HHS common database.
- database : HHS BizFlow common database script.
- jdbcconn : JDBC Connection test tool.
- usas : USA Staffing interface has two parts - batch and web.
- consolidated batch : Batch interface contains the nightly BIIS interface and EHRP 15 Minute Interface
This is a development project to produce a simple program to test JDBC connection.
- JDK 1.7
- Apache Ant 1.9.x
-
In the build machine, download the project repository files.
-
Open a command line, and change directory to
jdbcconn
directory.cd jdbcconn
-
Using a text editor, open
jdbcconn.properties
file, and modify the JDK location in the following property.jdk.home.1.7=<full_path_to_jdk_home_dir>
-
In the command line, run ANT build script.
ant
-
Capture the generated module JAR file as well as dependent library JAR files.
jdbcconn/dist/lib/jdbcconn.jar jdbcconn/dist/lib/*.jar jdbcconn/dist/run.sh jdbcconn/dist/run.bat
-
Log in to the target environment server.
-
Create a directory where the JDBC Connection test tool will be installed.
For example:
mkdir -p <server_dir>/jdbcconn/
-
Copy the module JAR file and its dependent library JAR files.
- From (build machine):
- jdbcconn/dist/lib/*.jar
- jdbcconn/dist/run.sh
- jdbcconn/dist/run.bat
- To (target environment):
- <server_dir>/jdbcconn/
- From (build machine):
-
For UNIX environment, make the run script executable.
cd <server_dir>/jdbcconn chmod 744 run.sh
The deployed module can be run on demand as a stand alone application.
./run.sh
Running the program without parameter will show the usage instruction. Run the program with proper parameters according to the instruction.
For example:
./run.sh oracle dev.dbhost.com 1521 dbsid dev devpass
This module is to pull HHS employee directory information into BizFlow user profile database table. BIIS and EHRP reference data is also imported into HHS common database and is refreshed nightly.
Note: Once the user profile information is imported, BizFlow system administrator will need to manually maintain license assignment, authority group assignment, and user group assignment through BizFlow Administration menu.
- Source and target database connection information.
- JDK 1.7
- Apache Ant 1.9.x
- biis/src : Source code directory for BIIS batch job interface
- biis/lib : Library directory for dependency
-
In the build machine, download the project repository files.
-
Open a command line, and change directory to
biis
directory.cd biis
-
Using a text editor, open
biis.properties
file, and modify the JDK location in the following property.jdk.home.1.7=<full_path_to_jdk_home_dir>
-
In the command line, run ANT build script.
ant package.exejar
-
Capture the generated module JAR file, configuration files, and shell script to run the module.
biis/dist/run-jar.sh biis/dist/application.properties biis/dist/biis-<version>.jar
-
Log in to the target environment server as the BizFlow service owner (or sudo).
-
Create a directory where the BIIS Interface module will be installed.
For example:
mkdir -p <server_dir>/biis/
-
Copy the module JAR file, configuration files, and shell script files.
- From (build machine):
- biis/dist/*
- To (target environment):
- <server_dir>/biis/
- From (build machine):
-
Make sure the script has correct JAVA_HOME environment variable set. Open and edit
run-jar.sh
script.JAVA_HOME=<path_to_java_runtime_home_dir>
-
Configure properties. Open and edit
application.properties
file for the following entries. There are many other properties, but the following entries are essential.hhs.datasource.url= hhs.datasource.username= hhs.datasource.password=
The deployed module can be run on demand or as a stand alone application.
For UNIX environment, make the run script executable.
cd <server_dir>/biis
chmod 744 run-jar.sh
For on-demand run, execute the shell script in command line.
./run-jar.sh
For regular usage in server environment, it is expected to be executed periodically by a cron job.
crontab -e
# BIIS Batch job
40 20 * * * /bin/sh <server_dir>/biis/run-jar.sh
USA Staffing Interface module is to pull HR related data from USA Staffing site through Data Self Service (DSS) web service call.
In order to call DSS web service, there should be an existing report created for the data collection. DSS provides access to run the report remotely and capture the report output as XML format.
This is a batch job module as opposed to web application. Therefore, it should be packaged as JAR and be deployed to a server which can run a stand-alone batch job.
- Identify the report to run in USA Staffing site.
- DSS account with credential to access the report in USA Staffing site.
- Target database connection information.
- JDK 1.7
- Apache Ant 1.9.x
- usas/batch/src : Source code directory for DSS web service client and interface
- usas/batch/lib : Library directory for dependency
-
In the build machine, download the project repository files.
-
Open a command line, and change directory to
usas/batch
directory.cd usas/batch
-
Using a text editor, open
usastaff.properties
file, and modify the JDK location in the following property.jdk.home.1.7=<full_path_to_jdk_home_dir>
-
In the command line, run ANT build script.
ant package.exejar
-
Capture the generated module JAR file, configuration files, and shell script to run the module.
usas/batch/dist/run-jar.sh usas/batch/dist/application.properties usas/batch/dist/report.properties usas/batch/dist/log4j.properties usas/batch/dist/usasdss-<version>.jar
-
Log in to the target environment server as the BizFlow service owner (or sudo).
-
Create a directory where the USA Staffing Interface module will be installed.
For example:
mkdir -p <server_dir>/usas/
-
Copy the module JAR file, configuration files, and shell script files.
- From (build machine):
- usas/batch/dist/*
- To (target environment):
- <server_dir>/usas/
- From (build machine):
-
Make sure the script has correct JAVA_HOME environment variable set. Open and edit
run-jar.sh
script.JAVA_HOME=<path_to_java_runtime_home_dir>
-
Configure properties. Open and edit
application.properties
file for the following entries. There are many other properties, but the following entries are essential.target.datasource.url= target.datasource.username= target.datasource.password= cognos.username= cognos.password= cognos.namespace= cognos.url=
The deployed module can be run on demand or as a stand alone application.
For UNIX environment, make the run script executable.
cd <server_dir>/usas
chmod 744 run-jar.sh
For on-demand run, execute the shell script in command line.
./run-jar.sh
For regular usage in server environment, it is expected to be executed periodically by a cron job.
crontab -e
# USA Staffing Batch job
40 20 * * * /bin/sh <server_dir>/usas/run-jar.sh
USA Staffing Interface module is to pull HR related data from USA Staffing site through Data Self Service (DSS) web service call.
In order to call DSS web service, there should be an existing report created for the data collection. DSS provides access to run the report remotely and capture the report output as XML format.
This is a web application module as opposed to batch job. Therefore, it should be packaged as WAR and be deployed to a web server.
- Identify the report to run in USA Staffing site.
- DSS account with credential to access the report in USA Staffing site.
- Target web server (Apache Tomcat 8)
- JDK 1.7
- Apache Ant 1.9.x
- usas/web/src : Source code directory for DSS web service client and interface
- usas/web/lib : Library directory for dependency
-
In the build machine, download the project repository files.
-
Open a command line, and change directory to
usas/web
directory.cd usas/web
-
Using a text editor, open
usasrwsc.properties
file, and modify the JDK location in the following property.jdk.home.1.7=<full_path_to_jdk_home_dir>
-
In the command line, run ANT build script.
ant
-
Capture the generated module JAR file, configuration files, and shell script to run the module.
usas/web/dist/usasrwsc-<version>.war
-
Log in to the target environment server as the BizFlow service owner (or sudo).
-
Copy the module WAR file to the designated web application (i.e.,
tomcat/webapps
) directory. Make sure exclude the version number part of the WAR file since the file name will become the application context name.- From (build machine):
- usas/web/dist/usasrwsc-<version>.war
- To (target environment):
- <webapps_dir>/usasrwsc.war
- From (build machine):
-
Wait until the web application is fully deployed. You may watch that the
usasrwsc
directory is created under the web application directory, and check properties file under it.<tomcat_dir>/webapps/usasrwsc <tomcat_dir>/webapps/usasrwsc/WEB-INF/classes/application.properties
-
Configure properties. Open and edit
application.properties
file for the following entries. There are many other properties, but the following entries are essential.server.url= credentials.namespace= credentials.username= credentials.password=
The deployed module can be accessed by web service call with the designated service URL and parameters. For example,
http://localhost:8080/usasrwsc/usas/reportXML/appointment/{requestNumber}
http://localhost:8080/usasrwsc/usas/reportXML/recruitment/{requestNumber}
http://localhost:8080/usasrwsc/usas/reportHTML/applicantnotification/{vacancyNumber}
http://localhost:8080/usasrwsc/usas/reportHTML/applicantroster/{vacancyNumber}
Replace the protocol, server DNS name, port, and report identifying information as appropriate.
This project is composed of multiple interface batch jobs, such as the BIIS Nightly batch and the EHRP 15 Minute Interface. Each batch job is scheduled via the internal Spring Boot cron scheduler. The Cron schedule can be updated in the application.properties file.
The EHRP 15 Minute Interface connects to a remote server to import XML files onto the HHS server. These XML files are processed to insert the data into the HHS common database.
The BIIS interface is composed of three modules-- BIIS Person Directory, BIIS Reference Data, and EHRP Reference/Job Requisition Data. The BIIS Person Directory module pulls HHS employee directory information into the BizFlow user profile database table. Whereas, the other two modules import data into the HHS common database which is refreshed on a nightly basis.
Note: Once the user profile information is imported, BizFlow system administrator will need to manually maintain license assignment, authority group assignment, and user group assignment through BizFlow Administration menu.
- Source and target database connection information
- JDK 1.7
- Apache Ant 1.9.x
- batch-interface/src/main/java : Source code directory for interface
- batch-interface/src/main/resources : Resource directory for the interface which contains property files and shell scripts required to run the job
- batch-interface/lib : Library directory for dependency
-
In the build machine, download the project repository files.
-
Open a command line, and change directory to
interface-batch
directory.cd interface-batch
-
Using a text editor, open
interface.properties
file, and modify the JDK location in the following property.jdk.home.1.7=<full_path_to_jdk_home_dir>
-
In the command line, run ANT build script commands.
ant ant package.exejar
-
Capture the generated executable JAR file, configuration files, and shell scripts to run the interface.
batch-interface/dist/application.properties batch-interface/dist/biis.properties batch-interface/dist/ehrp.properties batch-interface/dist/EHRP_15min.sh batch-interface/dist/interface-<version>.jar batch-interface/dist/logback.xml batch-interface/dist/run-jar.sh batch-interface/dist/start-interface.sh batch-interface/dist/stop-interface.sh
-
Log in to the target environment server as the BizFlow service owner (or sudo).
-
Create a directory where the Interface batch will be installed.
For example:
mkdir -p <server_dir>/interface/
-
Next create a subdirectory specific to the EHRP interface
For example:
mkdir -p <server_dir>/interface/ehrp/
-
Then create the following sub-folders in the EHRP directory
For example:
mkdir -p <server_dir>/interface/ehrp/inbound/ mkdir -p <server_dir>/interface/ehrp/processing/ mkdir -p <server_dir>/interface/ehrp/archive/ mkdir -p <server_dir>/interface/ehrp/error/ mkdir -p <server_dir>/interface/ehrp/logs/
-
Copy the module JAR file, configuration files, and shell script files.
- From (build machine):
- batch-interface/dist/*
- To (target environment):
- <server_dir>/interface/
- From (build machine):
-
Make sure the run script has correct JAVA_HOME environment variable set. Open and edit
run-jar.sh
script.JAVA_HOME=<path_to_java_runtime_home_dir>
-
Configure the application properties. Open and edit
application.properties
file for the following entries. There are many other properties, but the following entries are essential.target.datasource.url= target.datasource.username= target.datasource.password= cognos.username= cognos.password= cognos.namespace= cognos.url=
-
Configure properties specific to the EHRP interface. Open and edit
ehrp.properties
file for the following entries. There are many other properties, but the following entries are essential.ehrp.script.path= inbound.directory= processing.directory= archive.directory= error.directory=
-
Configure properties specific to the BIIS interface. Open and edit
biis.properties
file for the following entries. There are many other properties, but the following entries are essential.import.biis.person= import.biis.ref.data= import.ehrp.ref.data=
The deployed module can be run on demand or as a stand alone application.
For UNIX environment, make the following shell scripts executable.
cd <server_dir>/interface
chmod 744 run-jar.sh
chmod 744 EHRP_15min.sh
chmod 744 start-interface.sh
chmod 744 stop-interface.sh
For on-demand run, execute the following shell script in command line.
./start-interface.sh
To stop the on-demand run, execute the following shell script in command line.
./stop-interface.sh
For regular usage in server environment, it is expected to be running as a background process. Therefore, there needs to be a crontab entry to start the jar and another to stop the jar before the server goes down at night.
crontab -e
#Consolidated Interface Batch Job (EHRP 15 Min, BIIS Nightly)
00 06 * * * /bin/sh <server_dir>/interface/start-interface.sh
40 23 * * * /bin/sh<server_dir>/interface/stop-interface.sh