gen-jmx: Force Workflow Transition

Procedure to force a Generisk Program to a specific Workflow state
N.B.: This procedure works only from exm offices, or through a VPN tunnel

Check the Program and collect required data
1) Verify the type of workflow that the Program is following (GER or UWB?)
2) Verify that the Program is in the expected state (not in the desired one)
3) Copy the current actor email (from ProgressDashboard perspective and User registry)
4) Copy the ticket ID (IT-XYZ), or choose a comment to motivate the change

Choose the desired workflow state, for example ‘suwb8_mistake’

WKF StepGER CodeUWB Code
Mistakes2_mistakesuwb8_mistake
Expireds11_expiredsuwb11_expired
Cancelleds10_cancelledsuwb12_cancelled
Prospects1_prospect
Internal approvals3_uw_office_approval
Retrocession Hub Approvals4_ukb_approval
Approveds5_approved
Bounds6_binding
Account Amendments7_account_amendment
Not Taken Ups9_not_taken_up
Subjectivities pendings13_subjectivities_pending
Retrocession Hub First Quotations14_retro_first_quotation
Retrocession Hub Quotation Approvals15_retro_quotation_approval
Provisionally Bounds17_provisionally_bound
Regional Hub Approvals18_regional_hub_approval
Central Team Approvals19_central_team_approval
Declined By Central Teams20_central_team_declined
Declineds21_declined
Draftsuwb0_draft
Pricedsuwb1_priced
Awaiting Approvalsuwb2_awaiting_approval
Quote Sentsuwb3_quote_sent
Amendmentsuwb4_amendment
Firm Ordersuwb5_bound
Domestic Issuance Readysuwb6_ready_for_issuance
Issuedsuwb7_issued
Closedsuwb9_closed
Not Taken Upsuwb10_not_taken_up
Bound and Alignedsuwb13_bound_and_complete

Connect to the right server
– Download and install PuTTY-client: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
– Select the shared file poc.key as “Private Key” in Connection -> SSH -> Auth
– Insert the desired connectionURL in Session -> HostName (see following table)
– (Optional) insert a name for the session ad save it to reuse the current config (Session -> SavedSession -> Save/Load)

EnvironmentconnectionURL
gercipoc@192.168.50.5
ger-qa-prodpoc@192.168.50.3
UATpoc@23.20.29.192
SITpoc@34.195.61.49
PREPRODpoc@54.174.81.104
PRODpoc@52.6.144.0
TRAININGpoc@52.6.37.128

Execute the command and copy it to the trello card
Data required:
– programID (example 1234)
– desired workflow step (example suwb8_mistake)
– next actor email (example pippo@exmachina.ch)
– comment (example IT-4567)

Command:
gen-jmx maintenance.forceWorkflowStep 1234 suwb8_mistake ‘pippo@exmachina.ch’ ‘IT-4567’

Verify and keep track of the change
1) In generisk, close and reopen the program to check if the workflow state is changed as expected.
2) In the trello card, copy all commands executed on the server (and the environment)