Updating FACOLS with MST PACT Table changes - department-of-veterans-affairs/caseflow GitHub Wiki
With the release of MST/PACT, VACOLS was updated to have an ISSMST and ISSPACT column on the ISSUES table to track MST and PACT statuses of legacy issues. To recreate this in Caseflow Local FACOLS, you will need to recreate a new FACOLS image with the new columns added by running these setup steps for your environment:
Windows Setup Steps
- Within Caseflow, checkout to setup branch
git checkout grant/setup-no-aws
and pull the latest by runninggit pull
- Clear your local docker environment by running
bundle exec rake local:nuke
. This will destroy everything in your docker environment. - Change directory to
~appeals/
directory. If youls
in the directory, caseflow should be the only folder. - Copy
caseflow-facols
repository by runninggit clone https://github.com/department-of-veterans-affairs/caseflow-facols.git
. Enter your github username and SSH key when prompted. - To download the files FACOLS files quicker, you can use
git-lfs
. You can download LFS by runningsudo apt-get install git-lfs
- After downloading git-lfs, navigate to caseflow-facols by running
cd caseflow-facols
. Download the contests of the repo by runninggit lfs pull
. FACOLS should download into the folder. - Next we need to copy caseflow-facols/build facols. This can be done using windows Explorer GUI by running
explorer.exe .
in the command line (this will open up windows explorer so you can navigate through the files more easily. You can also do the following steps in the command line if you prefer). - Copy the caseflow-facols/build facols directory. We will move this to the caseflow/local/vacols subdirectory (Ensure you have a caseflow/local/vacols/build facols directory with all the files before continuing to the next step). You can get to there in the command line by running
cd ../caseflow/local/vacols
or through the GUI using Explorer.exe (you can alwaysls
and make sure you are in the correct directory). - Building within caseflow/local/vacols, make sure the build_facols directory is now present. Build the FACOLS docker image by running
./build_push.sh local
. - Navigate back to appeals/caseflow root directory (
cd ../..
andls
to make sure you are in the correct directory) - Run within the caseflow folder
docker-compose up -d
to pull all the created docker images and spin up the containers - Run
bundle exec rake db:create
to create Databasescaseflow_certification_development
andcaseflow_certification_test
- Run
bundle exec rake local:vacols:seed
- Run
bundle exec rake db:schema:load db:seed
to reseed your local. - run
make reset
incase if you run into issues.
Mac with Intel Setup Steps
- Checkout to setup branch
git checkout grant/setup-no-aws
and pull the latest by runninggit pull
- Clear your local docker environment by running
bundle exec rake local:nuke
. This will destroy everything in your docker environment. - Clone facols to your local by running
git clone https://github.com/department-of-veterans-affairs/caseflow-facols.git
Upon completion, navigate to caseflow-facols (cd ~/caseflow-facols
) - Run:
git lfs install
(needed to initialize large file storage in repo) - Run:
git lfs pull
(this will pull the large zipfile) - Copy the caseflow-facols/build facols directory to the caseflow/local/vacols subdirectory. (Ensure you have a caseflow/local/vacols/build facols directory with all the files before continuing to the next step)
- Build FACOLS docker image by running
./build_push.sh local
. - Navigate back to caseflow root directory (
cd ~/caseflow-setup/caseflow
) - Run
docker-compose up -d
. This command pulls all the created docker images and spins up the containers. - Run
bundle exec rake db:create
it will create Databasescaseflow_certification_development
andcaseflow_certification_test
- Run
bundle exec rake local:vacols:seed
- Run
bundle exec rake db:schema:load db:seed
- run
make reset
incase if you run into issues.
no space left on device
, you might need to clear out your old docker containers with docker builder prune -a
Note: If you have an issue seeding due to Mac with VM Setup Steps
The Mac VM should be set up to have ISSMST and ISSPACT, but if your setup doesn't, you can add the columns manually:
- In the VM for FACOLS, navigate to the ISSUES table.
- Using your SQL GUI in your VM, add ISSMST and ISSPACT columns to the table. The columns accept 'Y' and 'N' values for true and false.
- Save the table changes.
Mac with Apple Silicon Setup Steps
1. Log in to the UTM Appeals VACOLS Virtual Machine
- Open the UTM Application
- Start the "Appeals VACOLS VM" virtual machine
- Click anywhere in the window to get a login prompt for OracleDB
- The password is:
password
2. Open the Command Prompt
-
Click on the "Command Prompt" icon at the bottom of the screen, or click on the search icon and select "Command Prompt" from the popup.
3. Enter the VACOLS_DEV Environment
- Run this command:
sqlplus "VACOLS_DEV/VACOLS_DEV@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=BVAP)))"
4. Update the Issues Table
-
Run these commands (this will tell you if they exist already):
ALTER TABLE issues ADD issmst varchar(1);
ALTER TABLE issues ADD isspact varchar(1);
5. Exit the VACOLS_DEV SQL Environment
- Enter
exit
at the sql prompt
6. Enter the VACOLS_TEST Environment
- Run this command:
sqlplus "VACOLS_TEST/VACOLS_TEST@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=BVAP)))"
7. Update the Issues Table
-
Run these commands (this will tell you if they exist already):
ALTER TABLE issues ADD issmst varchar(1);
ALTER TABLE issues ADD isspact varchar(1);
8. Exit the VACOLS_TEST SQL Environment
- Enter
exit
at the sql prompt